Docs · MCP & API

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.

/   Overview

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.

Server URL 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.

/   Before you start

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.

/   Connect your AI

Set up your assistant

Pick the app you use. Each one takes about a minute.

Claude (claude.ai, desktop and mobile) No key needed

  1. Open Claude and go to Settings → Connectors.
  2. Choose Add custom connector. Name it Scheduloid and paste the server URL below.
  3. Click Connect and approve access on the Scheduloid page that opens.
  4. In a chat, turn Scheduloid on from the tools menu and ask something like "show my Scheduloid workspace".
Server URL
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.

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.

/   What you can ask

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?
/   Weekly Planner

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.

  1. Start. Share your website and, if you like, your topics, facts you want used and anything never to say.
  2. Answer. Scheduloid may ask a few short questions about your audience and offer.
  3. Review the plan. You get one post per day with a hook and angle. Ask for changes to any post.
  4. 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.
  5. Approve posts, then schedule. Only the posts you approve are scheduled, to the accounts you choose.

An example conversation

YouPlan next week for mybakery.com. Only post about our sourdough classes and the new weekend brunch. Never mention prices.
AssistantI read mybakery.com and started a plan with your two topics. Two quick questions: who are the classes for, beginners or home bakers who want to level up? And should posts push class sign-ups or brunch bookings first?
YouBeginners. Push class sign-ups first.
AssistantHere's the week: Monday, "Your first loaf doesn't need a starter from 1890"; Tuesday, the weekend brunch menu… Every post is on one of your topics, and none mentions prices. Want any changes?
YouMake Wednesday about what you take home from the class.
AssistantDone. Wednesday is now "You leave with a loaf, a starter and the confidence to repeat it." Making the images for all 5 posts costs 5 AI credits. Shall I go ahead?
YouYes. Then schedule the ones I approve on Instagram and Facebook.
Topics come from you. When you give a topic list, every post is checked against it, and a post that drifts off-topic is sent back for a rewrite. Facts you give are used as true. Any figure in a post must come from your facts or your website, and the plan is checked for that.
/   Reference

All tools

Your assistant sees these tools once you're connected. Tools that change something are marked.

ToolWhat it does
Workspace & posts
get_workspaceYour plan, credits, connected accounts and links to fix anything missing.
list_social_accountsConnected accounts, with a reconnect link for any whose sign-in expired.
list_posts · get_postScheduled, published and failed posts, with the reason a post failed and who can fix it.
get_post_metricsLikes, comments, reach and more for a published post, where the network shares them.
get_recent_activityWhat happened in your workspace lately.
get_subscriptionPlan and remaining post and AI credits.
schedule_post changesSchedule a post to one or more accounts.
publish_post_now publicPublish right away. This can't be undone, so the assistant asks first.
reschedule_post · cancel_post changesMove or cancel a scheduled post.
Content Studio
list_content_threads · get_content_threadYour earlier Content Studio work and its results.
generate_content creditsMake an image, video or text from a description.
approve_video_story creditsApprove a multi-scene video story after reading its scenes.
Repurpose & Video Studio
list_repurpose_platformsNetworks a post can be rewritten for.
repurpose_text creditsRewrite one piece of text for each network.
list_library_videos · get_video_session · get_video_jobYour videos and the progress of video jobs.
start_video_session · run_video_action creditsCut a long video into short clips and edit them.
Weekly Planner
list_weekly_plans · get_weekly_planYour plans, their posts and what step each is on.
start_weekly_planResearch your website and start a plan, optionally with your topics.
set_plan_topicsSet or change the topics, facts and "never say" list.
answer_plan_questionsAnswer the plan's questions, then build the week.
rewrite_plan_postChange one planned post with a note.
approve_weekly_planApprove the week and move to the design step.
generate_plan_posts creditsMake the posts. Takes an optional credit limit and refuses if the cost is higher.
approve_plan_postsApprove or reject finished posts.
schedule_weekly_plan changesSchedule the approved posts.
/   Key permissions

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.

PermissionAllows
posts:readRead posts and their published metrics.
posts:writePublish, schedule, reschedule and cancel posts on your connected accounts. Uses post credits.
users:readRead user and workspace records (never credentials).
activity:readRead product activity and health scores.
billing:readRead subscriptions, plans and revenue summaries.
content:readRead Content Studio and Repurpose Studio history and results.
content:writeGenerate images, video and text with Content Studio and Repurpose Studio. Spends AI credits.
webhooks:manageRegister, list and delete webhook endpoints.

You can see and remove every connection and key in Settings → API keys & Claude.

/   Safety & credits

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.
/   Troubleshooting

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.

/   For developers

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 URLhttps://app.scheduloid.com/api/v1
AuthAuthorization: Bearer sk_live_…
FormatJSON in, JSON out. Errors return an error object with a type (for example credits_exhausted), a readable message and a request_id.
RetriesSend an Idempotency-Key header on paid or publishing requests so a retry runs once.
Specopenapi.json · openapi.yaml (import into Postman or any OpenAPI tool)

Try it

Terminal
curl https://app.scheduloid.com/api/v1/me \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
Schedule a post
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.

/   FAQ

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.

/   Start with one link

Hand off your social media this week.

Join 100+ brands building their empires. No setup fees. No contracts. Cancel anytime.

✓Reading your website
✓Learning what you sell and who buys it
✓Matching your colours and tone
✓Writing and designing your week
Your week, ready7 channels
MON3 mistakes new customers make✓
TUEBehind the scenes✓
WEDHow it works in 60 seconds✓
THUWhat customers ask most✓
7 posts this week, approved in 5 minutes