01
Before you start
- Create an API key in the dashboard under API keys.
- The server speaks MCP over streamable HTTP at the endpoint above, and every request carries that key.
02
Connect Claude Code
Add the server once, from your terminal:
claude mcp add --transport http reelspan https://app.reelspan.com/mcp \
--header "Authorization: Bearer $REELSPAN_KEY"03
Connect another client
Any MCP client that supports remote servers and custom headers works. Most take a config like this:
{
"mcpServers": {
"reelspan": {
"url": "https://app.reelspan.com/mcp",
"headers": { "Authorization": "Bearer YOUR_REELSPAN_KEY" }
}
}
}Keep the key out of shared files: most clients can read it from an environment variable instead.
04
What it can do
Account and profiles
- get_account_info
- Check the API key and show the plan and this month’s upload usage.
- list_profiles
- List profiles and which platforms each one has connected.
- create_profile
- Create a profile for a brand or client.
- get_connect_link
- A 48-hour link where someone connects their own accounts to a profile, no Reelspan login needed.
- delete_profile
- Delete a profile and disconnect its accounts.
Publishing
- upload_video
- Publish a video from a public URL to one or more platforms; returns a request_id.
- upload_photos
- Publish one photo or a carousel from public image URLs; a platform can get its own cropped set.
- upload_text
- Publish a text-only post to X, Bluesky, Threads, LinkedIn or Facebook.
- upload_status
- Per-platform status of a publish request.
- retry_failed
- Send failed platforms again, optionally only some and with changed settings.
- upload_history
- Past posts, one row per platform, newest first.
Scheduling
- list_scheduled
- Posts waiting to be published, soonest first.
- edit_scheduled
- Move a scheduled post or change its text.
- cancel_scheduled
- Cancel a scheduled post; its upload credits are refunded.
Captions and analytics
- generate_captions
- Watch a video and write a caption for each platform within its limits.
- write_captions
- Write each platform’s caption, and a short summary, from your text or notes.
- rewrite_captions
- Fit captions you already have to each platform’s length, tone and hashtags.
- get_analytics
- Followers, views and post counts per connected platform.
- get_post_analytics
- Views, likes and comments for each platform a request went to.
Webhooks
- get_webhook
- Read the webhook URL, events and signing secret.
- set_webhook
- Send upload and account events to an https URL.
05
Try asking
- “List my profiles and which platforms each one has connected.”
- “Post clip.mp4 from this link to TikTok, YouTube and Instagram tomorrow at 9am, with a caption that fits each.”
- “How did yesterday’s post do on each platform?”
Using ChatGPT? It signs in with your Reelspan account instead of a key: ChatGPT guide.