Run Scheduloid from your AI.
Connect Scheduloid to Claude, ChatGPT, Claude Code, Codex or VS Code. Then ask in plain words: plan a week on your topics, make posts, schedule them and check results. It is built to ask before it posts or spends credits.
What the Scheduloid MCP server is
MCP (Model Context Protocol) is the standard way an AI assistant uses outside tools. Scheduloid runs an MCP server, so your assistant can work in your Scheduloid workspace for you. It sees what you see and does what you could do in the app, with the same plan limits and credits.
https://app.scheduloid.com/mcp
Plan and schedule
Build a researched week of posts on your own topics, then schedule it across your accounts.
Create content
Make images, videos and captions with Content Studio, or repurpose one post for every network.
Check results
See what was published, what failed and why, and how each post performed.
You stay in control
Nothing goes public and no credits are spent until you say yes in the chat.
Sign in, or use an API key
You need a Scheduloid account with at least one social account connected. There are two ways to let your assistant in:
- Sign in (easiest). Claude, ChatGPT and Claude Code open a Scheduloid sign-in page and you approve access. No key to copy, and you can remove access any time.
- API key. Codex, VS Code and the Claude Desktop config file use a key. Make one in Settings → API keys & Claude. Keys start with
sk_live_and are shown once, so store yours somewhere safe. Never paste it into a public place.
Only a workspace owner's access can publish, schedule or spend credits. A teammate's key can read.
Set up your assistant
Pick the app you use. Each one takes about a minute.
Claude (claude.ai, desktop and mobile) No key needed
- Open Claude and go to Settings → Connectors.
- Choose Add custom connector. Name it Scheduloid and paste the server URL below.
- Click Connect and approve access on the Scheduloid page that opens.
- In a chat, turn Scheduloid on from the tools menu and ask something like "show my Scheduloid workspace".
https://app.scheduloid.com/mcp
Results show as cards with buttons, so you can approve or schedule with a click. A connector added on claude.ai also works in the Claude desktop and mobile apps.
ChatGPT No key needed
- Open ChatGPT and go to Settings → Apps & Connectors.
- Create a connector. Name it Scheduloid, paste the server URL below and choose OAuth.
- Approve access on the Scheduloid page that opens.
https://app.scheduloid.com/mcp
Claude Code No key needed
Run this in your terminal:
claude mcp add --transport http scheduloid https://app.scheduloid.com/mcp
Then start Claude Code, type /mcp, choose scheduloid and pick Authenticate. Approve access in the browser.
Prefer a key?
claude mcp add --transport http scheduloid https://app.scheduloid.com/mcp \ --header "Authorization: Bearer sk_live_YOUR_KEY"
Results come back as clear tables in the terminal.
Codex API key
Add this to ~/.codex/config.toml:
[mcp_servers.scheduloid] url = "https://app.scheduloid.com/mcp" bearer_token_env_var = "SCHEDULOID_API_KEY"
Then put your key in your shell profile (for example ~/.zshrc or ~/.bashrc) and open a new terminal:
export SCHEDULOID_API_KEY=sk_live_YOUR_KEY
VS Code API key
Create .vscode/mcp.json in your project (or add to your user MCP settings):
{
"servers": {
"scheduloid": {
"type": "http",
"url": "https://app.scheduloid.com/mcp",
"headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
}
}
}Results show as cards with buttons in Copilot Chat. Keep the file out of version control if it holds your real key.
Claude Desktop, config file API key
Use this only if you can't add a connector from Settings → Connectors (the Claude tab above). It needs Node.js installed.
- Open Settings → Developer → Edit Config.
- Add the block below, with your key in place of
sk_live_YOUR_KEY. - Quit and reopen Claude Desktop.
{
"mcpServers": {
"scheduloid": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.scheduloid.com/mcp",
"--header", "Authorization:${SCHEDULOID_AUTH}"],
"env": { "SCHEDULOID_AUTH": "Bearer sk_live_YOUR_KEY" }
}
}
}Check it works
Ask: "What's in my Scheduloid workspace?" You should see your plan, credits and connected accounts. If you don't, see Troubleshooting.
Talk to it like a teammate
You don't need to know tool names. Ask in your own words and the assistant picks the right tool.
- Which of my posts failed this week, and what do I need to fix?
- Schedule this caption on LinkedIn and X for Thursday at 10am.
- Move tomorrow's Instagram post to Friday morning.
- How did my last five LinkedIn posts do?
- Make a square image for a spring sale, in our brand colours.
- Turn this blog post into posts for every network I've connected.
- How many AI credits do I have left?
Plan a week on your own topics
Give your website and the topics you want to talk about. Scheduloid reads your site, plans a week of posts on those topics only, and waits for your approval at every paid step.
- Start. Share your website and, if you like, your topics, facts you want used and anything never to say.
- Answer. Scheduloid may ask a few short questions about your audience and offer.
- Review the plan. You get one post per day with a hook and angle. Ask for changes to any post.
- Approve and make. The assistant tells you the cost in AI credits first. You can set a limit, and it stops rather than going over.
- Approve posts, then schedule. Only the posts you approve are scheduled, to the accounts you choose.
An example conversation
All tools
Your assistant sees these tools once you're connected. Tools that change something are marked.
| Tool | What it does |
|---|---|
| Workspace & posts | |
get_workspace | Your plan, credits, connected accounts and links to fix anything missing. |
list_social_accounts | Connected accounts, with a reconnect link for any whose sign-in expired. |
list_posts · get_post | Scheduled, published and failed posts, with the reason a post failed and who can fix it. |
get_post_metrics | Likes, comments, reach and more for a published post, where the network shares them. |
get_recent_activity | What happened in your workspace lately. |
get_subscription | Plan and remaining post and AI credits. |
schedule_post changes | Schedule a post to one or more accounts. |
publish_post_now public | Publish right away. This can't be undone, so the assistant asks first. |
reschedule_post · cancel_post changes | Move or cancel a scheduled post. |
| Content Studio | |
list_content_threads · get_content_thread | Your earlier Content Studio work and its results. |
generate_content credits | Make an image, video or text from a description. |
approve_video_story credits | Approve a multi-scene video story after reading its scenes. |
| Repurpose & Video Studio | |
list_repurpose_platforms | Networks a post can be rewritten for. |
repurpose_text credits | Rewrite one piece of text for each network. |
list_library_videos · get_video_session · get_video_job | Your videos and the progress of video jobs. |
start_video_session · run_video_action credits | Cut a long video into short clips and edit them. |
| Weekly Planner | |
list_weekly_plans · get_weekly_plan | Your plans, their posts and what step each is on. |
start_weekly_plan | Research your website and start a plan, optionally with your topics. |
set_plan_topics | Set or change the topics, facts and "never say" list. |
answer_plan_questions | Answer the plan's questions, then build the week. |
rewrite_plan_post | Change one planned post with a note. |
approve_weekly_plan | Approve the week and move to the design step. |
generate_plan_posts credits | Make the posts. Takes an optional credit limit and refuses if the cost is higher. |
approve_plan_posts | Approve or reject finished posts. |
schedule_weekly_plan changes | Schedule the approved posts. |
What a key is allowed to do
When you make a key, you choose its permissions. A tool the key isn't allowed to use doesn't appear in your assistant. New keys and sign-in connections get posts:read, posts:write, users:read, billing:read, content:read and content:write.
| Permission | Allows |
|---|---|
posts:read | Read posts and their published metrics. |
posts:write | Publish, schedule, reschedule and cancel posts on your connected accounts. Uses post credits. |
users:read | Read user and workspace records (never credentials). |
activity:read | Read product activity and health scores. |
billing:read | Read subscriptions, plans and revenue summaries. |
content:read | Read Content Studio and Repurpose Studio history and results. |
content:write | Generate images, video and text with Content Studio and Repurpose Studio. Spends AI credits. |
webhooks:manage | Register, list and delete webhook endpoints. |
You can see and remove every connection and key in Settings → API keys & Claude.
It asks before it posts or spends
- Publishing is confirmed. The assistant is told to publish only after you approve the exact text, media and accounts. Claude and ChatGPT also ask your permission before a tool that changes something runs.
- Costs come first. Paid steps show the price in AI credits before they run. If you don't have enough, you're told before anything starts.
- No double charges. Every paid request carries a one-time ID, so a retry after a dropped connection never posts twice or charges twice.
- Planning text is cheap. Researching and writing a plan uses a small fraction of a credit. Images and videos are what cost credits.
- Same limits as the app. Your plan's post limit, account limit and AI credits apply exactly as on the website.
- You can cut it off. Revoke a key or a sign-in connection in Settings and it stops working at once.
If something isn't working
The assistant says it has no Scheduloid tools
Check the connector is turned on for that chat (Claude: the tools menu in the message box). In Claude Code, run /mcp and make sure scheduloid shows as connected. If you use a key, check it was copied in full and hasn't been revoked.
Some tools are missing
Your key doesn't have that permission. Make a new key with the permissions you need under Settings → API keys & Claude. Publishing and credit tools also need a workspace owner's access.
Claude shows "Account mismatch" while connecting
That check is Claude's own. Sign in to claude.ai in your browser with the same Claude account you use in the desktop app, then connect again.
A post failed because an account needs reconnecting
Social sign-ins expire. Ask "which of my accounts need reconnecting?" and the assistant gives you a reconnect link for each one. You reconnect in Scheduloid, not in the chat.
TikTok posts don't publish
Publishing to TikTok isn't available yet while our TikTok app is being reviewed. You can still plan and make TikTok content and post it from the TikTok app.
"Not enough credits" or "choose a plan"
Planning is free to try, but making images and videos needs a plan with AI credits. Ask "how many credits do I have?" to see your balance, and top up or upgrade from Pricing.
The REST API
Everything the MCP server does goes through our REST API, which you can call directly from your own code with the same key.
| Base URL | https://app.scheduloid.com/api/v1 |
| Auth | Authorization: Bearer sk_live_… |
| Format | JSON in, JSON out. Errors return an error object with a type (for example credits_exhausted), a readable message and a request_id. |
| Retries | Send an Idempotency-Key header on paid or publishing requests so a retry runs once. |
| Spec | openapi.json · openapi.yaml (import into Postman or any OpenAPI tool) |
Try it
curl https://app.scheduloid.com/api/v1/me \ -H "Authorization: Bearer sk_live_YOUR_KEY"
curl -X POST https://app.scheduloid.com/api/v1/posts \
-H "Authorization: Bearer sk_live_YOUR_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"account_ids":[123],"text":"Hello from the API","schedule_at":"2026-12-01T10:00:00Z"}'Field names and every endpoint are in the OpenAPI spec, which is kept in step with the live API.
Common questions
Does it cost extra?
No. The MCP server and API are included on every plan. You only use the same post and AI credits you'd use in the app.
Can the AI post without asking me?
Assistants are told to confirm before publishing or spending, and Claude and ChatGPT also ask your permission before a tool that changes something runs. Scheduled posts can be moved or cancelled until they go out.
Which AI should I use?
Claude on claude.ai is the easiest: no key, and results come as cards with buttons. Claude Code suits people who already work in a terminal.
Can my team use it?
Yes. Each person connects their own assistant. Teammates can read; publishing, scheduling and credit spending need the workspace owner's access.
Is my data used to train AI models?
Scheduloid shares with your assistant only what that assistant asks for to do your request. How your assistant's provider handles your chats is set in that app's own privacy settings.
Hand off your social media this week.
Join 100+ brands building their empires. No setup fees. No contracts. Cancel anytime.