Home · Docs · MCP · OpenAPI · Privacy · Terms · Marketing · Console · App
Connect Cursor, Claude, or ChatGPT to VariantPost — Metricool-class: OAuth Authorize in the client (login + Allow, no API key paste), then “schedule a LinkedIn post tomorrow” against a real connection.
Consumer listings, deeplinks, and consent use the VariantPost name and brand mark only (https://variantpost.com/brand/mark.svg). Postpipe / API keys appear only in developer docs, console, and Advanced sk_ below.
MCP serverInfo.name is variantpost. Backward compatibility: the fixed client id postpipe_mcp_public, redirect allowlists, existing mcp_at_/mcp_rt_ tokens, /mcp and /oauth/* paths, and the X-Postpipe-Mcp-Bind header (now also X-VariantPost-Mcp-Bind) all keep working.
| Scope | Shown as | Tools |
|---|---|---|
posts:read | Read posts, queue and insights | get_post, list_posts, list_deliveries, list_hashtag_sets, suggest_best_times, list_competitors, get_competitor_posts, get_trends |
posts:write | Create and manage posts | create_post, adapt_caption, preview_post, cancel_post, retry_job, hashtag set CRUD, add_competitor, generate_ideas, seed_post |
connections:read | See connected accounts | list_connections, research_hashtags |
usage:read | Read usage and analytics | get_usage, get_analytics |
list_networks needs no scope. connections:write is no longer requested by default (no MCP tool uses it) but is still honoured when an existing client asks for it. The source of truth is src/mcp/scopes.ts; a test fails if a tool's enforced scope and its consent group drift apart.
| URL | Status |
|---|---|
https://mcp.variantpost.com/mcp | Live — preferred (Cursor/Claude/deeplink) |
https://api.variantpost.com/mcp | Same handler — also Live |
Both hosts share the handler. Prefer mcp.variantpost.com in all new snippets.
That installs Streamable HTTP against https://mcp.variantpost.com/mcp (no API key in the link).
mcp_at_…). Keys never live in MCP config.> UX lock (Asra): consumer Connect = VariantPost login + Allow only. No Postpipe/API wording in the client. Key-bind (sk_ paste) is not the customer path — Advanced/CI only. Live authorize is keyless (Continue with VariantPost → Allow).
mcp.json (OAuth — URL only){
"mcpServers": {
"variantpost": {
"url": "https://mcp.variantpost.com/mcp"
}
}
}
URL only — no headers / no sk_ in config. Cursor/Claude run OAuth (authorize + token on api.variantpost.com). (api.variantpost.com/mcp is the same handler if needed.)
| Step | URL |
|---|---|
| Protected resource metadata | GET https://mcp.variantpost.com/.well-known/oauth-protected-resource (also on api.*) |
| Authorization server metadata | GET https://api.variantpost.com/.well-known/oauth-authorization-server |
| Authorize (login + Allow) | GET/POST https://api.variantpost.com/oauth/authorize |
| Token (code + PKCE / refresh) | POST https://api.variantpost.com/oauth/token |
| Dynamic client registration | POST https://api.variantpost.com/oauth/register |
/mcp request (including initialize and tools/list) needs a valid bearer. No token -> 401 + WWW-Authenticate: Bearer resource_metadata="…/.well-known/oauth-protected-resource", scope="…". A presented but unknown, revoked or expired token (or an access token whose API key was revoked) -> 401 with the same challenge plus error="invalid_token".adapt_caption, generate_ideas and seed_post use the workspace's AI allowance (Free: 402 paid_api_not_in_plan) and are annotated readOnlyHint: false.mcp_at_ / mcp_rt_ (hashed in DB; map to tenant + key scopes)postpipe_mcp_public — Cursor/Claude normally use DCRScreenshot SoT for marketing: authorize page = login + Allow (Metricool-class). Never show sk_ paste as the customer Connect path. Icon for connectors = brand mark only: https://variantpost.com/brand/mark.svg.
Consumer name: VariantPost (never Postpipe in Apps listing or consent).
| MCP URL | https://mcp.variantpost.com/mcp |
| Happy path | Continue with VariantPost → Allow (no sk_ paste) |
| Icon | https://variantpost.com/brand/mark.svg |
| OAuth redirects | Allowlisted for ChatGPT Apps/Connectors (forge 38729b3+) |
| Portal field | Paste |
|---|---|
| App / display name | VariantPost |
| Short description | Connect your social accounts and schedule posts with VariantPost. Sign in and Allow — no API keys. |
| Long description | VariantPost lets ChatGPT schedule and publish to your connected social networks. Connect once with OAuth (login + Allow), then ask ChatGPT to draft and schedule posts. Built for creators and teams — not a developer console. |
| MCP server URL | https://mcp.variantpost.com/mcp |
| Authentication | OAuth 2.1 PKCE (DCR) |
| Authorize | https://api.variantpost.com/oauth/authorize |
| Token | https://api.variantpost.com/oauth/token |
| Docs (end-user) | https://variantpost.com (marketing) · setup: https://api.variantpost.com/docs/mcp |
| Privacy | https://api.variantpost.com/legal/privacy |
| Logo / icon | https://variantpost.com/brand/mark.svg |
| Categories | Social media / Marketing / Productivity |
| Test account | Asra sandbox VariantPost login (Authorize = login + Allow) |
| Consent screenshots | docs/assets/mcp/authorize-consent-full.png — Continue with VariantPost (mark; keyless; Client = VariantPost) |
Blockers before submit: OpenAI publisher/org account, domain verification for variantpost.com / mcp.variantpost.com, reviewer sandbox login, listing copy sign-off. CIMD if Apps prefers it over DCR (forge follow-up).
Do not put Postpipe, API keys, or console language in the ChatGPT listing.
Same URL. In claude_desktop_config.json (or Claude Code MCP settings):
{
"mcpServers": {
"variantpost": {
"url": "https://mcp.variantpost.com/mcp"
}
}
}
Restart Claude after save. Complete OAuth: login + Allow (no key paste). For CI / headless, use Advanced sk_ header only.
Metricool’s discoverability lever. Remote MCP + OAuth. Consent screenshots final for Live VariantPost Authorize (2026-09-21; Client display = VariantPost; keyless; no Postpipe on page). Works-with marketing strip still waits on Asra design assets (not blocking directory). Directory submit ready — Asra/brain Claude Team|Enterprise Owner clicks submit.
Packet (dx)
| Field | Value |
|---|---|
| Display name | VariantPost |
| MCP URL | https://mcp.variantpost.com/mcp |
| Auth | OAuth 2.1 PKCE (DCR). Authorize/token/register on https://api.variantpost.com |
| Callback to register | https://claude.ai/api/mcp/auth_callback |
| Docs | https://api.variantpost.com/docs/mcp |
| Privacy | https://api.variantpost.com/legal/privacy |
| Icon | https://variantpost.com/brand/mark.svg |
| Tools | 16 Live (titles + readOnlyHint/destructiveHint set) — no Ads/Inbox/Flows |
| Consent shots | docs/assets/mcp/authorize-consent-{full,fullpage,zoomed}.png + oauth-authorize-consent.png (Live authorize UI; no keys) |
Portal (Team/Enterprise Owner): Organization settings → Directory → New connector Fallback nav: Claude.ai → Organization settings → Directory → Submit.
Paste fields:
| Portal field | Paste |
|---|---|
| Server / display name | VariantPost |
| Short description | Connect your socials and schedule posts with VariantPost. Sign in and Allow — no API keys. No Ads. |
| MCP server URL | https://mcp.variantpost.com/mcp |
| Authentication | OAuth (PKCE / DCR) |
| Documentation URL | https://api.variantpost.com/docs/mcp |
| Privacy policy URL | https://api.variantpost.com/legal/privacy |
| Support contact | asra@variantpost.com (or Asra’s preferred) |
| Icon | https://variantpost.com/brand/mark.svg |
| Categories | Social media / Marketing / Productivity |
| Test credentials | Asra provides a sandbox VariantPost login for reviewers (Authorize = login + Allow). sk_test_ is Advanced/CI only — not the Connect UI |
| Consent screenshots | docs/assets/mcp/authorize-consent-full.png (also fullpage/zoomed) |
Do not list Ads/Inbox/Flows. Works-with marketing strip is separate (waits Asra design).
Still needed before click-submit: Asra/brain Team-or-Enterprise Claude org (Owner/Admin) + sandbox login for reviewers. Consent screenshots: keyless login + Allow (refreshed after forge keyless PASS). Site carousel optional later.
https://mcp.variantpost.com/mcpsk_)Power-user / CI / n8n / curl only. Not the customer Connect path (that is OAuth login + Allow). Same tenant resolution as /v1.
Authorization: Bearer sk_test_…
Authorization: Bearer sk_live_…
Tools enforce key scopes (posts:read, posts:write, connections:read, usage:read, …). Prefer sk_test_ until you intend live publish.
{
"mcpServers": {
"variantpost": {
"url": "https://mcp.variantpost.com/mcp",
"headers": {
"Authorization": "Bearer sk_test_YOUR_KEY"
}
}
}
}
Never put a live key in a shared deeplink or screenshot.
initialize + tools/list)curl -sS -X POST 'https://mcp.variantpost.com/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'Authorization: Bearer sk_test_YOUR_KEY' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": { "name": "curl", "version": "0.0.1" }
}
}'
curl -sS -X POST 'https://mcp.variantpost.com/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'Authorization: Bearer sk_test_YOUR_KEY' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
Local: replace host with http://127.0.0.1:8080.
Unauthenticated probes receive 401 + WWW-Authenticate: Bearer resource_metadata="…/.well-known/oauth-protected-resource".
/v1 only)| Tool | Wraps |
|---|---|
list_networks | GET /v1/networks |
adapt_caption | POST /v1/posts/adapt (posts:write) |
list_connections | GET /v1/connections |
create_post | POST /v1/posts (variants-first; use scheduled_at to schedule e.g. LinkedIn tomorrow) |
get_post | GET /v1/posts/{id} |
list_posts | GET /v1/posts |
list_deliveries | GET /v1/deliveries |
get_usage | GET /v1/usage |
get_analytics | GET /v1/analytics (delivery honesty; engagement.available may be false) |
research_hashtags | GET /v1/research/hashtags |
list_hashtag_sets | GET /v1/research/hashtag-sets |
create_hashtag_set | POST /v1/research/hashtag-sets |
update_hashtag_set | PATCH /v1/research/hashtag-sets/{id} |
delete_hashtag_set | DELETE /v1/research/hashtag-sets/{id} |
suggest_best_times | GET /v1/research/best-times (static hints, not measured facts) |
cancel_post | POST /v1/posts/{id}/cancel |
retry_job | POST /v1/jobs/{id}/retry |
Auth on tools: Bearer sk_* or mcp_at_* OAuth access tokens.
No Inbox, Ads, Flows, LLM caption invent, or fake engagement. “Suggest” = best-times hints + hashtag research/sets only.
create_post shape (variants-first){
"end_user_id": "eu_…",
"scheduled_at": "2026-09-20T15:00:00Z",
"variants": [
{
"connection_id": "conn_…",
"kind": "image",
"caption": "Hello from VariantPost",
"media_ids": ["media_…"]
}
]
}
| Var | Need |
|---|---|
PUBLIC_URL | Required in prod — OAuth issuer base (https://api.variantpost.com). Resource URL in PRM is https://mcp.variantpost.com/mcp. |
DATABASE_URL | Required — OAuth clients/codes/tokens stored hashed |
TOKEN_ENCRYPTION_KEY | Existing; not used for MCP opaque tokens (SHA-256 hashes in DB) |
MCP_OAUTH_* | None required for v1 |
| Audience | Name |
|---|---|
| Consumers (Claude / ChatGPT / Cursor listings, deeplinks, consent) | VariantPost + brand mark |
Developers (OpenAPI, console, Advanced sk_, this doc’s Advanced section) | Postpipe API |
Never show Postpipe/API-key language in consumer Connect UX.