Blotato API and MCP: what developers and non coders can do, the limits and the plan you need
Short answer: Blotato, a software subscription that writes, designs, schedules and publishes social media posts, has an API (a way for other software to give it orders) and an MCP server (a standard way for an AI assistant such as Claude to use it). Both come with every paid plan, from $29 a month billed monthly as of November 2026, and neither works on the free trial. Creating an API key ends the trial at once and starts the paid plan. Posting is limited to 30 requests a minute.
You want to know what Blotato's API and MCP server can do, which plan you need, the real limits, and how someone with no coding can use it.
I'm Ranjit, and I run Blur Studio: 15+ years building software, 120 apps taken live, and clients who have gone on to raise $10M+. I build AI systems and processes that help businesses do a lot more with a lot less time. I also work differently from most of what else is out there, more on that further down this page. Say hello.
Blotato can be driven in three ways. You can click in its web app. You can write code that calls its API. Or you can let an AI assistant do the clicking for you through MCP. This page explains the second and third routes in plain words, lists the limits Blotato publishes, and gives you a safe first test. Nobody at Blur Studio has run Blotato's API, so I report only what Blotato's documentation says and I give no results.
This page may contain affiliate links from which Blur Studio earns commissions.
What the words mean
- API (application programming interface): a set of addresses that other software can call to do things in Blotato. Blotato's is a REST API, the common kind that uses web requests.
- API key: a long secret code that proves a request comes from your account. Treat it like a password.
- MCP (Model Context Protocol): an open standard that lets an AI assistant use outside tools. Blotato runs an MCP server, which is the doorway the assistant connects to. See what MCP is and why a website owner should care.
- OAuth: the "sign in with" flow. You approve a connection in a browser, and no key is copied by hand.
- n8n and Make: tools for building automations by connecting blocks, with no or little code. Blotato has official n8n and Make nodes (their name for a block).
- Webhook: a web address that receives a message when something happens.
What the API does
Per Blotato's documentation, the REST API lives at backend.blotato.com/v2 and you send your key in a header called blotato-api-key. It covers:
- Posts: publish now or schedule, for the 11 services Blotato supports: the social networks X, LinkedIn, Facebook, Instagram, Pinterest, TikTok, Threads, Bluesky and YouTube, plus the chat tools Slack and Discord. X is called "twitter" in the API.
- Media uploads and public media links.
- Visuals and videos: make template images, carousels and videos, which spend credits.
- Sources: turn an article, video or document into material for drafts.
- Analytics: read results for posts published through Blotato.
- Comments and messages: on Instagram accounts and Facebook Pages only.
- DM automations: create and manage them.
- Credits: read your balance, or create a checkout link to buy more.
Publishing is asynchronous, meaning the first call only accepts the job. A post request returns a submission ID, and you poll (ask repeatedly) for the status until it says published or failed. A post with no scheduled time and no "next free slot" option goes out immediately. A scheduled time needs a UTC offset. Scheduling is allowed up to 9 months ahead, per most of Blotato's pages.
What MCP does, and who it is for
The MCP server is at mcp.blotato.com/mcp. Blotato says it offers 35 tools as of 20 October 2026, grouped as accounts, credits, publishing, analytics, comments, messages, DM automations, content extraction, videos and images, content calendar and media. Re-read the tool list before you rely on a number, because it changes.
That means a non coder can type "show me my connected accounts and draft three LinkedIn posts from this article" into an assistant and get Blotato actions done. Blotato lists 18 documented clients, including Claude on the web and desktop (Anthropic's AI assistant, as a community connector in Claude's directory, using OAuth), a ChatGPT plugin (ChatGPT is OpenAI's AI assistant), Codex (OpenAI's coding assistant) and tools such as Cursor (a code editor with AI built in) that use the API key route. For Claude Code, the command is claude mcp add --transport http Blotato https://mcp.blotato.com/mcp.
Three limits to know. The MCP server can read your credit balance but cannot buy credits. The top posts tool covers only X, Instagram, Facebook, Threads and Bluesky, where the REST API also covers TikTok, YouTube and Pinterest. And Blotato's page on ChatGPT says a custom MCP route needs write actions that OpenAI offers on some business plans, so check OpenAI's current help before you plan around it. Those are vendor statements about OpenAI.
Which plan you need, and the trial trap
As of November 2026, Blotato's pricing page shows Starter at $29 a month, Creator at $97 and Agency at $499, in US dollars billed monthly. API and MCP are included on every paid plan, with no separate API tier. The 7 day free trial needs a card and does not include API or MCP.
The trap: creating an API key in Settings, API ends your trial immediately and starts the paid subscription, even with days left, per Blotato's help centre. Blotato says a warning and a confirmation appear first, and that the plan started is Starter. The n8n and Make nodes also need an API key, so the same applies. Do not create a key during the trial unless you are ready to pay.
What is not clear: Blotato's pages do not say whether MCP that connects through OAuth (the Claude connector or the ChatGPT plugin, with no key) works during the trial. The pricing page says API and MCP are not in the trial. If you want to find out, connect the Claude connector in the trial and see whether a draft request works, and treat the result as yours, not Blotato's promise. See the Blotato free trial guide.
The Starter plan limits still apply to anything you do through the API: 20 connected accounts, 200 queued scheduled posts, 1,250 credits a month and 1,000 active contacts for DM and comment replies. Blotato charges no per post or per call fee. Credits are spent only when you ask for AI images or AI video. You can start with a Blotato trial and decide on the API once you know the web app fits.
Rate limits Blotato publishes
A rate limit is the most requests you may send in a window of time. Blotato's page lists them per minute for each route, not one hourly total, so plan around these (read 21 November 2026):
| Route | Limit |
|---|---|
| Create a post | 30 a minute |
| Read posts and post status | 60 a minute |
| Upload media | 30 a minute |
| Presigned upload (a temporary upload link) | 120 a minute |
| Comments | 30 to post, 60 to read, a minute |
| Messages | 30 to send, 60 to read, a minute |
| DM automations | 30 writes, 60 reads, a minute |
| Pinterest boards | 45 a minute |
| Create a credit checkout link | 10 an hour |
A 429 error means you hit a route limit. Platforms add their own caps on top. For example, Blotato limits Instagram to 50 posts per account per 24 hours and LinkedIn to 50 per profile and 50 per company Page. The platform's own rule and Blotato's cap are different things, so see Meta's and LinkedIn's current pages.
Worked example, made-up job: you want to load 200 posts to fill a full Starter queue. At 30 post requests a minute, that is 200 divided by 30, which is 6.7, so at least 7 minutes if you send nothing else. Add checking status at up to 60 reads a minute, and a 200 post batch fits in about 10 minutes in a script that waits between calls. A script that fires all 200 at once will hit a 429 on the first minute.
Errors to expect
Blotato lists these among its API errors: wrong API key, wrong account ID, wrong Page ID, empty URL, invalid file format, media conversion failed and out of credits. Code 5000 means the account was not found. Code 20005 means the text is too long, and emoji and full width characters count as 2. Code 20101 means the monthly active contact limit was reached. The rule I would follow, and that Blotato's docs support, is never to retry a post blindly. First look up the submission ID, because the post may already exist. See Blotato n8n and Make error codes.
A safe first test: one post
- Pick one test account, warmed up and not your main one.
- Connect the Claude connector or make one request in the API with a draft or a tiny text post.
- Ask for the status until it says published, or failed.
- Open the post on the platform and check text, media and caption.
- Check Posts and Logs in Blotato and copy the request ID once.
- Repeat with a scheduled post 15 minutes ahead.
Pass if the post publishes once, the status matches what you see and you can find the log. Fail if you get a duplicate, no status or an unclear error. Do not test on a real client account.
Blank log
| Date | Route (REST, Claude, n8n, Make) | Request | Status returned | Seen on platform (yes or no) | Error text |
|---|---|---|---|---|---|
Safety for keys and agents
- Never paste an API key into an AI chat. Use OAuth where it is offered.
- One key per Blotato account. Separate automations per client need separate accounts, so a leaked key reaches only that account.
- Ask an assistant to show a draft and wait for your yes before it posts.
- Do not give any assistant a social media password. Blotato's help says to authorise through the platform's own sign in.
See using Claude and ChatGPT with your website: safe setups for the same habits on other tools.
How it compares
Blotato is not the only tool with an API or MCP server. Other social media schedulers, such as Buffer, also offer API access in some form, so check each vendor's page for what its plans include. So an API is a reason to check Blotato, not a reason on its own. Ask which tool gives you the platforms you need, the limits you can live with and the support when something breaks. If you only need to connect two apps, Zapier and Make may already do it, and n8n suits people who want to self host.
When not to use Blotato's API
- You do not have a task to automate. The web app is simpler.
- You need approval steps or several users. Blotato has one user per account and no approval workflow. A workaround exists with n8n or Make, but it is something you build.
- You need LinkedIn comments, first comments or messages, which Blotato does not offer through LinkedIn.
- You cannot afford a surprise charge. Creating a key during the trial starts billing.
How this page was checked
The facts come from Blotato's pricing page, its llms.txt summary, and its help centre pages on rate limits, API keys, MCP setup, billing and errors, last checked 21 November 2026, and I refresh this page every 90 days. Blur Studio has not run the Blotato API itself. Use the 7 day trial, think before creating a key, and test with one post.
How I'd approach this
In week one, use the web app only. If the posting works for you and you still want automation, decide which single task to automate, for example "turn each new blog post into 3 drafts". Then pick the route: Claude connector if you do not code, n8n or Make if you want a repeatable flow. Make a single test post. Only when that works, build the full flow. For a second opinion on what is worth automating, the free tools at /free and the free AI brainstorm call are open to you.
Questions people ask
Does Blotato have an API?
Yes. It is a REST API at backend.blotato.com/v2 that covers posts, media uploads, visuals, sources, analytics, comments, messages, DM automations and credits. It uses an API key sent in a header. It is included on every paid plan with no separate price.
Can I use the Blotato API on the free trial?
No. Blotato says API and MCP are not part of the 7 day trial. Creating an API key in Settings ends the trial and starts the paid plan right away, so do not create one unless you are ready to pay.
What is the Blotato rate limit?
Blotato lists limits per minute per route: 30 post requests, 60 status reads, 30 media uploads and 120 presigned uploads, among others, and 10 credit checkout requests an hour. Platforms add their own daily caps. A 429 error means you hit a limit.
How do I connect Blotato to Claude?
Blotato is listed as a community connector in Claude's directory and uses OAuth, so no key is pasted. For Claude Code the command is claude mcp add --transport http Blotato https://mcp.blotato.com/mcp. Blotato's MCP setup page says MCP access is not included in the free trial, and that applies to the sign-in route too, so subscribe first. See what MCP is.
Can an AI assistant buy credits for me through MCP?
No. Blotato says the MCP server can read your credit balance but cannot buy credits. The API can create a Stripe checkout link, but a person has to complete the payment.
Does the API cost extra?
Not as a separate fee. The API and MCP are included on Starter ($29 a month billed monthly, as of November 2026) and the higher plans. Calls use no credits. Credits are spent only when you ask for AI images or AI video.
Does Blotato work with n8n and Make?
Yes, with official nodes for both. They need an API key, so they are not available on the trial. Creator adds support for troubleshooting n8n and Make flows, per Blotato's pricing page. See Zapier vs Make for the tools.
More in this topic: Social media: what Blotato can and cannot do (28 guides) →