MCP

Ask your assistant
to schedule the post.

Add one MCP server to ChatGPT, Claude, Cursor, Codex, or Gemini CLI. It writes into your content library and puts posts on the calendar for the channels you already connected.

Overview

The ZuperPost MCP server speaks the Model Context Protocol over HTTP. An MCP client calls tools. Each tool calls the same ZuperPost API the product uses, with your key, so permissions, brand membership, and approval rules stay in one place.

Server URL

https://mcp.zuperpost.com/mcp

Protocol

JSON-RPC 2.0, protocol version 2025-03-26. Methods: initialize, ping, tools/list, tools/call.

Authentication

Your key from API Key. Clients that can set headers send Authorization: Bearer YOUR_API_KEY. ChatGPT cannot, so the key goes on the URL instead.

What you can ask

You do not need tool names. Ask in a normal sentence. The assistant lists your channels, saves the copy, then schedules it. Social accounts are connected in the ZuperPost app. The assistant posts to the ones already connected.

What you askWhat the assistant does
Which accounts are connected?Lists your channels.
Save this as a post.Creates it in the content library and returns the content id.
Schedule it for tomorrow at 9:30.Puts that content on the calendar for the channels you name.
What is going out this week?Lists scheduled posts.
Post this every Monday.Creates a recurring schedule.
Approve the post that is waiting.Lists the approval queue and approves the one you mean.

The assistant schedules a time. It does not publish the moment you ask, and it does not generate images, video, or analytics.

List your channels

Use only the ZuperPost connector. Call list_channels with no filters. Reply with a table of every channel: id, name, type, and brand. If a call fails, paste the exact error text and stop.

Create a post

Use only the ZuperPost connector. Call list_brands and use the first brand. Then call create_content with content "We just shipped a new feature. Short, upbeat, and ready to post." and title "New feature". Reply with the new content id, the brand name, and the exact copy that was saved. If a call fails, paste the exact error text and stop.

Schedule that post

Use only the ZuperPost connector. The content id is PASTE_CONTENT_ID. Call list_channels for that brand, then call create_scheduled_post with that content_id, scheduled_at "2026-12-01 09:30", timezone "Asia/Singapore", and channel_ids set to every channel you just listed. Do not create another piece of content. Reply with the scheduled post id, the local time, the timezone, and each channel name. If a call fails, paste the exact error text and stop.

scheduled_at is local time in that timezone, written as YYYY-MM-DD HH:MM. Change the copy, the date, and the timezone before you send the prompt.

Connect a client

Create a key at app.zuperpost.com/api-key. The same key works in every client. One key belongs to your user, so the assistant only sees brands you can access.

Most clients send the key as a header. ChatGPT has no header field, so it uses the key on the URL. If the key contains |, write that character as %7C in the URL. A URL that contains the key is a password. Do not paste it into a chat or a screenshot.

ChatGPT

  1. Open ChatGPT on the web and go to Plugins.
  2. Select +, then Add custom MCP server.
  3. Name it ZuperPost.
  4. Set authentication to No authentication.
  5. Paste this server URL, with your key in place of YOUR_API_KEY:
https://mcp.zuperpost.com/mcp?api_key=YOUR_API_KEY
  1. Create the plugin, then install it.
  2. In a new chat, type @ and choose ZuperPost. Paste one of the prompts above.

Claude

This covers Claude on the web, the desktop app, and the mobile app. They share the connector you add on the web.

  1. Open Customize → Connectors.
  2. Select + Add, then Add custom connector.
  3. Name it ZuperPost and set the server URL to https://mcp.zuperpost.com/mcp.
  4. Under Authentication, choose No sign in.
  5. Under Request headers, add authorization with the value Bearer YOUR_API_KEY. Include the word Bearer and the space.
  6. Add the connector, start a chat, and turn ZuperPost on.

Request headers are still a limited beta. If that section is missing, choose No sign in and use the same ?api_key= URL as ChatGPT.

Claude Code

claude mcp add --transport http zuperpost https://mcp.zuperpost.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Run /mcp in Claude Code. ZuperPost should show a checkmark. Then paste a prompt.

Cursor

Settings, then Tools & MCP. Add a server:

{ "mcpServers": { "zuperpost": { "url": "https://mcp.zuperpost.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Codex

Add this to ~/.codex/config.toml. Set ZUPERPOST_API_KEY in the environment to the key only, without the word Bearer. Codex adds that prefix.

[mcp_servers.zuperpost] url = "https://mcp.zuperpost.com/mcp" bearer_token_env_var = "ZUPERPOST_API_KEY"

Gemini CLI

Add this to ~/.gemini/settings.json:

{ "mcpServers": { "zuperpost": { "httpUrl": "https://mcp.zuperpost.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Any other MCP client

Add https://mcp.zuperpost.com/mcp as a remote HTTP server and send Authorization: Bearer YOUR_API_KEY. If the client has a URL field and no header field, use the ChatGPT URL with ?api_key= and set authentication to none.

Where each client keeps the key

ClientWhere you add itHow the key is sent
ChatGPTPlugins → Add custom MCP server?api_key= on the URL. Encode | as %7C.
ClaudeCustomize → ConnectorsHeader authorization: Bearer …, or the URL if headers are unavailable.
Claude Codeclaude mcp add --transport http--header "Authorization: Bearer …"
CursorSettings → Tools & MCPheaders.Authorization
Codex~/.codex/config.tomlbearer_token_env_var
Gemini CLI~/.gemini/settings.jsonheaders.Authorization

Facebook, Instagram, Threads, X, LinkedIn, TikTok, Bluesky, Pinterest, YouTube, and Google Business Profile are connected in the app. The assistant can add and test a webhook channel such as Google Chat, Slack, or Microsoft Teams, and it can list, save, or disconnect Facebook Pages after you have signed in.

Call a tool

Clients do this for you. This is the HTTP shape, so you can test with curl.

List your brands

curl https://mcp.zuperpost.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"list_brands\",\"arguments\":{}}}"

Example result

{ "jsonrpc": "2.0", "id": 1, "result": { "content": [ { "type": "text", "text": "{\"brands\":[{\"id\":1,\"name\":\"My brand\"}]}" } ], "isError": false } }

text is the JSON body returned by the ZuperPost API. isError is true when the API rejects the call or a required argument is missing. The HTTP status of the MCP request stays 200 for tool errors. A broken JSON-RPC envelope returns an error object instead of result.

Brand on each call

Pass brand_id when a tool asks which brand to use. The server also sends it as X-Brand-Id. If you omit it, the API uses your current brand. You cannot read or change a brand your account is not a member of.

Tools

Path values such as id are required. Other arguments are optional unless the description says they are required. File tools take filename and content_base64. Large images and video should be uploaded with the REST API instead.

Content library

ToolWhat it doesArguments
list_contentsList post copybrand_id, q, category, platform, sort (newest, oldest, updated, title), page
get_contentRead one postid
search_contentsSearch by keywordkeyword, brand_id
create_contentCreate post copycontent (required), brand_id, title, platform, category_id, media_url
update_contentUpdate post copyid, content (required), brand_id, title, platform, category_id
delete_contentDelete a postid
bulk_contentsMove or delete several postsaction, ids (required), brand_id, category_id
import_contentsImport rowsrows (required), brand_id, dry_run
list_content_categoriesList categoriesbrand_id
create_content_categoryCreate a categoryname (required), brand_id, color
update_content_categoryRename a categoryid, name (required), brand_id, color
delete_content_categoryDelete a categoryid, brand_id

Content media

ToolWhat it doesArguments
list_content_mediaList images and videoid (content id)
add_content_mediaAttach a fileid, filename, content_base64
reorder_content_mediaReorder filesid, order (media ids)
delete_content_mediaRemove one fileid, mediaId
set_content_media_thumbnailSet a video thumbnailid, mediaId, filename, content_base64
delete_content_media_thumbnailRemove that thumbnailid, mediaId

Schedule a post

ToolWhat it doesArguments
list_scheduled_postsList calendar itemsbrand_id, status
get_scheduled_postRead oneid
create_scheduled_postPut a library post on the calendarcontent_id, scheduled_at (for example 2026-12-01 09:30), timezone (IANA), brand_id, and channel_ids or platforms
update_scheduled_postChange time or channelsid, scheduled_at, timezone, channel_ids, brand_id
cancel_scheduled_postCancel itid
delete_scheduled_postDelete itid

Schedule example

{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "create_scheduled_post", "arguments": { "brand_id": 1, "content_id": 42, "scheduled_at": "2026-12-01 09:30", "timezone": "Asia/Singapore", "channel_ids": [3, 4] } } }

Recurring schedules

ToolWhat it doesArguments
list_recurring_schedulesList patternsbrand_id
get_recurring_scheduleRead oneid
create_recurring_scheduleCreate a daily, weekly, or monthly patterncontent_id, frequency (daily, weekly, monthly), start_date (YYYY-MM-DD), start_time (HH:MM), timezone, channel_ids, brand_id
update_recurring_scheduleUpdate a patternid, frequency, start_time, timezone, channel_ids, brand_id
pause_recurring_schedulePauseid
resume_recurring_scheduleResumeid
cancel_recurring_scheduleCancelid
delete_recurring_scheduleDeleteid

Channels

ToolWhat it doesArguments
list_channel_typesList channel typesnone
list_channelsList where a brand can publishbrand_id
get_channelRead one. Tokens are never returned.id
create_channelAdd a webhook channeltype, name (required), brand_id, webhook_url
update_channelUpdate name or webhookid, name, webhook_url, brand_id
delete_channelRemove a channelid
test_channelSend a testid
list_facebook_pagesList Pages you can connectbrand_id
save_facebook_pagesSave chosen Pagespage_ids, brand_id
disconnect_facebook_pageDisconnect a Pageid

Brands

ToolWhat it doesArguments
list_brandsList brands you can post asnone
get_brandRead oneid
create_brandCreate a brandname (required), workspace_id
update_brandRename it or change approvalid, name, require_approval
delete_brandDelete itid, confirm set to 1
upload_brand_logoUpload a logoid, filename, content_base64
delete_brand_logoRemove the logoid

Team

ToolWhat it doesArguments
get_brand_teamList members and invitesid (brand id)
invite_memberInvite by emailid, email, role (owner, approver, or member)
resend_invitationResend an inviteid, invitationId
revoke_invitationRevoke an inviteid, invitationId
update_memberChange a roleid, userId, role
remove_memberRemove a memberid, userId
get_invitationRead an invite linktoken
accept_invitationAccept ittoken

Approvals

ToolWhat it doesArguments
list_approvalsList posts waiting for reviewbrand_id
approve_postApprove a postid, brand_id
request_post_changesSend it back with a noteid, note (required), brand_id

Troubleshooting

What you seeWhat to do
isError and “Missing API key”The client reached the server and did not send the key. ChatGPT needs ?api_key= on the server URL, with | written as %7C. Other clients need Authorization: Bearer plus a space and the key. Remove the old connector and add it again after you change the URL or header.
API body says UnauthenticatedRegenerate the key. An old key stops working after you generate a new one.
403 or a message that the brand was not foundUse a brand_id from list_brands. Members cannot manage brands they do not belong to. Some actions require an owner or approver.
422 and an errors objectA required field is missing or invalid. scheduled_at must be in the future. Recurring frequency is daily, weekly, or monthly.
JSON-RPC -32700The body is not JSON.
JSON-RPC -32601That method is not supported. Use initialize, ping, tools/list, or tools/call.
JSON-RPC -32602tools/call needs name and arguments.
Unknown toolCall tools/list and use a name from that list. Tool names use underscores, for example list_contents.
Empty tools/list from a browserConfirm the URL is https://mcp.zuperpost.com/mcp with no extra path. A GET on that URL returns the server name and protocol version.

The REST reference, with curl, JavaScript, and PHP, is at zuperpost.com/api.

Questions

Do I sign in with OAuth?

No. ZuperPost MCP uses the API key from the app. Clients that can set a header send it as a bearer token. ChatGPT puts the same key on the server URL.

Is the server URL a secret?

https://mcp.zuperpost.com/mcp is public. The URL is a secret only after you add ?api_key=. Anyone with that link can act as your account.

Which networks can the assistant post to?

Every channel already connected on the brand: Facebook, Instagram, Threads, X, LinkedIn, TikTok, Bluesky, Pinterest, YouTube, Google Business Profile, Slack, Microsoft Teams, and Google Chat. Connecting a social account still happens in the browser.

Can it publish the moment I ask?

It saves the copy, then schedules a time. The post goes out when that time arrives. Ask it to schedule, then check the calendar before it sends.

Can it generate images or read analytics?

No. It can attach a file you already have, as base64 or as a media_url on the post. Large files should use the REST upload. Analytics are not a tool.

Use your key

Generate it in the app, then point your assistant at the MCP server.