VariantPost

Home · Docs · MCP · OpenAPI · Privacy · Terms · Marketing · Console · App

VariantPost MCP

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.

Consent scopes (match tool groups)

ScopeShown asTools
posts:readRead posts, queue and insightsget_post, list_posts, list_deliveries, list_hashtag_sets, suggest_best_times, list_competitors, get_competitor_posts, get_trends
posts:writeCreate and manage postscreate_post, adapt_caption, preview_post, cancel_post, retry_job, hashtag set CRUD, add_competitor, generate_ideas, seed_post
connections:readSee connected accountslist_connections, research_hashtags
usage:readRead usage and analyticsget_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.

Endpoint

URLStatus
https://mcp.variantpost.com/mcpLive — preferred (Cursor/Claude/deeplink)
https://api.variantpost.com/mcpSame handler — also Live

Both hosts share the handler. Prefer mcp.variantpost.com in all new snippets.


1. Cursor — Add VariantPost (preferred)

Add VariantPost to Cursor

That installs Streamable HTTP against https://mcp.variantpost.com/mcp (no API key in the link).

  1. Click the link → Cursor install prompt → approve.
  2. Cursor discovers OAuth and opens the authorize page.
  3. Customer happy path (Metricool-class): sign in to VariantPost → Allow. No API key paste.
  4. Cursor stores a Bearer access token (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).

Manual 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.)

OAuth endpoints (Live)

StepURL
Protected resource metadataGET https://mcp.variantpost.com/.well-known/oauth-protected-resource (also on api.*)
Authorization server metadataGET 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 registrationPOST https://api.variantpost.com/oauth/register

Screenshot 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.


ChatGPT / OpenAI Apps (MCP)

Consumer name: VariantPost (never Postpipe in Apps listing or consent).

MCP URLhttps://mcp.variantpost.com/mcp
Happy pathContinue with VariantPost → Allow (no sk_ paste)
Iconhttps://variantpost.com/brand/mark.svg
OAuth redirectsAllowlisted for ChatGPT Apps/Connectors (forge 38729b3+)

ChatGPT Apps / Plugins submit packet (VariantPost)

Portal fieldPaste
App / display nameVariantPost
Short descriptionConnect your social accounts and schedule posts with VariantPost. Sign in and Allow — no API keys.
Long descriptionVariantPost 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 URLhttps://mcp.variantpost.com/mcp
AuthenticationOAuth 2.1 PKCE (DCR)
Authorizehttps://api.variantpost.com/oauth/authorize
Tokenhttps://api.variantpost.com/oauth/token
Docs (end-user)https://variantpost.com (marketing) · setup: https://api.variantpost.com/docs/mcp
Privacyhttps://api.variantpost.com/legal/privacy
Logo / iconhttps://variantpost.com/brand/mark.svg
CategoriesSocial media / Marketing / Productivity
Test accountAsra sandbox VariantPost login (Authorize = login + Allow)
Consent screenshotsdocs/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.

2. Claude Desktop / Claude Code

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.

Claude Connectors directory (submission path)

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)

FieldValue
Display nameVariantPost
MCP URLhttps://mcp.variantpost.com/mcp
AuthOAuth 2.1 PKCE (DCR). Authorize/token/register on https://api.variantpost.com
Callback to registerhttps://claude.ai/api/mcp/auth_callback
Docshttps://api.variantpost.com/docs/mcp
Privacyhttps://api.variantpost.com/legal/privacy
Iconhttps://variantpost.com/brand/mark.svg
Tools16 Live (titles + readOnlyHint/destructiveHint set) — no Ads/Inbox/Flows
Consent shotsdocs/assets/mcp/authorize-consent-{full,fullpage,zoomed}.png + oauth-authorize-consent.png (Live authorize UI; no keys)

Owner handoff (Claude Directory portal)

Portal (Team/Enterprise Owner): Organization settings → Directory → New connector Fallback nav: Claude.ai → Organization settings → Directory → Submit.

Paste fields:

Portal fieldPaste
Server / display nameVariantPost
Short descriptionConnect your socials and schedule posts with VariantPost. Sign in and Allow — no API keys. No Ads.
MCP server URLhttps://mcp.variantpost.com/mcp
AuthenticationOAuth (PKCE / DCR)
Documentation URLhttps://api.variantpost.com/docs/mcp
Privacy policy URLhttps://api.variantpost.com/legal/privacy
Support contactasra@variantpost.com (or Asra’s preferred)
Iconhttps://variantpost.com/brand/mark.svg
CategoriesSocial media / Marketing / Productivity
Test credentialsAsra provides a sandbox VariantPost login for reviewers (Authorize = login + Allow). sk_test_ is Advanced/CI only — not the Connect UI
Consent screenshotsdocs/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.

  1. Product name: VariantPost (consumer). Postpipe = developer/API only — not in Directory listing
  2. MCP URL: https://mcp.variantpost.com/mcp
  3. Auth: OAuth (PKCE) — not raw keys in the directory listing
  4. Owner: Asra/brain submit in Claude Directory portal; dx supplies this doc + tool list + consent shot; site supplies marketing strip when Asra hands assets
  5. Do not submit Inbox / Ads / Flows tools — not shipped


Advanced — API key header (sk_)

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.

Cursor / Claude with header

{
  "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.

Curl smoke (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".


Tools (honest — Live /v1 only)

ToolWraps
list_networksGET /v1/networks
adapt_captionPOST /v1/posts/adapt (posts:write)
list_connectionsGET /v1/connections
create_postPOST /v1/posts (variants-first; use scheduled_at to schedule e.g. LinkedIn tomorrow)
get_postGET /v1/posts/{id}
list_postsGET /v1/posts
list_deliveriesGET /v1/deliveries
get_usageGET /v1/usage
get_analyticsGET /v1/analytics (delivery honesty; engagement.available may be false)
research_hashtagsGET /v1/research/hashtags
list_hashtag_setsGET /v1/research/hashtag-sets
create_hashtag_setPOST /v1/research/hashtag-sets
update_hashtag_setPATCH /v1/research/hashtag-sets/{id}
delete_hashtag_setDELETE /v1/research/hashtag-sets/{id}
suggest_best_timesGET /v1/research/best-times (static hints, not measured facts)
cancel_postPOST /v1/posts/{id}/cancel
retry_jobPOST /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_…"]
    }
  ]
}

Env (Render / local)

VarNeed
PUBLIC_URLRequired in prod — OAuth issuer base (https://api.variantpost.com). Resource URL in PRM is https://mcp.variantpost.com/mcp.
DATABASE_URLRequired — OAuth clients/codes/tokens stored hashed
TOKEN_ENCRYPTION_KEYExisting; not used for MCP opaque tokens (SHA-256 hashes in DB)
MCP_OAUTH_*None required for v1

Product naming

AudienceName
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.