Mastodon posts with MCP Server and Bolta
One address for any MCP client: https://mcp.bolta.ai/mcp. Parts of the MCP Server route are not confirmed yet, and the note below says which. Nothing goes live on Mastodon until you say yes.
Partly confirmed, see what is and is notChecked 2026-11-21
The same address works in every app. Where you paste it depends on the app.
Tell me the character limit for my Mastodon instance, then draft a post about our new release inside it
Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.
What is and is not confirmed
Read this before you set up MCP Server
- Confirmed: the address https://mcp.bolta.ai/mcp answers over HTTP and asks for a Bearer token, pointing to OAuth sign-in details. Bolta's own docs describe the browser sign-in and the Bearer API key route.
- Confirmed from the MCP specification: remote servers can ask for OAuth sign-in or accept a bearer token over HTTP.
- Not confirmed: nobody has run a full draft, review and schedule in each MCP client. Bolta's skills repository lists every client except the Claude Code plugin as not tested, and the Claude Code row runs its behavioural checks against a mock Bolta.
- Not confirmed: whether your app's settings screen has a box for an Authorization header. The protocol allows it, but apps differ.
- Menu names and config file locations change between app versions. Use your app's own MCP docs for where to click, and keep the address the same.
What Bolta does on Mastodon
The text limit on Mastodon is set by your own instance, and Bolta reads it for the connected account instead of using one fixed number. The usual limit is 500 characters.
- Text posts, within the limit your instance sets.
- Public posts by default, or another visibility if you set it.
Mastodon limits and format rules
Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.
Not promised for Mastodon from MCP Server: Polls, threads and instance-specific features. None is confirmed for Bolta. Any rule from a particular instance. Each instance sets its own, so check yours.
| What to know | Mastodon's own rule | What Bolta does |
|---|---|---|
| Post length | Not stated on this page. | Set by your instance. Bolta reads it per account, and the usual limit is 500. Text over the limit is trimmed back to the last whole sentence or word that fits. |
| Visibility | Not stated on this page. | Public unless you set another visibility. |
| Formatting | Not stated on this page. | Mastodon posts are plain text here. Markdown is flattened, and #hashtags and @mentions stay as typed. |
| Finding conversations | Not stated on this page. | Hashtag-based. The query is folded into a single tag, because full-text status search is unavailable on most instances. |
MCP Server jobs for Mastodon, and how to write them
- Add Bolta to an AI app that has no page of its own here, using one address
- Draft a week of posts in your brand voice from inside your app's chat
- Ask for your instance's limit before drafting. It differs from instance to instance.
Example prompts for Mastodon
Things to type in MCP Server. Each one asks for a draft and shows you the text first.
Tell me the character limit for my Mastodon instance, then draft a post about our new release inside it
Show me what is on my Bolta review list.
Draft a Mastodon post that is visible to everyone, and show me the text before saving it
Plan a weekly Friday post for Harbor Coffee and show me the plan first.
Bolta saves a draft, you read the exact text, you say yes
- 01
Bolta saves a draft
MCP Server asks Bolta for the Mastodon post in your brand voice (save-post). A saved draft is never public.
- 02
You read the exact text
On Mastodon the exact text includes its visibility, because the default is public, and where the limit for your instance would cut it.
- 03
You say yes
Only then does Bolta schedule or publish (publish-post), in your workspace's timezone. Safe Mode, client sign-off and brand approval rules still apply.
Using MCP Server for Mastodon
Parts of this route are not confirmed. The note above says which.
For Mastodon, MCP Server, from Open protocol (Anthropic started it), reaches Bolta through Remote server address, Streamable HTTP. Sign-in: Sign in (OAuth), or a Bearer API key. The Mastodon account itself is connected inside Bolta, not in MCP Server.
The Bolta MCP server address works in any app that adds remote MCP servers. This page is for apps without a page of their own, and a Mastodon draft works the same way once your app is connected.
An illustration from the MCP Server guide, not real output. You ask: Which Bolta brands can you see? List them only. The reply goes along these lines: I can reach two brands on this connection: Harbor Coffee and Harbor Roasters. I have not changed anything. Which one do you want to work on? Read only. Nothing changed.
An illustration from the MCP Server guide, not real output. You ask: How did my last five posts do, and what should I try next? The reply goes along these lines: Here is what Bolta shows for the last five posts, with the numbers it holds. Where a number is missing I will say so and not guess. From the pattern I can suggest two angles to try as drafts. I will not save anything yet. Read only. Nothing changed.
With several brands, say which one you mean. Calls carry a workspace_id once more than one brand is reachable.
Bolta's rules still apply: your role, Safe Mode and approval. The AI cannot work around a refusal.
Once connected, your app lists Bolta's tools by name. The kinds are brands and accounts, drafts, the review list, voice and brand details, plans and routines, campaigns, results and replies. Which tools an app is offered can differ by client, so compare your app's list with the full one in the MCP docs.
- Plans and routines. Say what should repeat, read the plan the AI proposes, ask for changes, and save it switched off. Switching it on takes a second yes from you.
- Campaigns. Attach a web page or file as a source for a campaign of posts. A campaign needs its own go-ahead before it runs. The skills README says campaign set-up from chat reaches Claude and Cursor today, so in another app you may be sent to Bolta for this step.
- The app finds the server. You give your app the address https://mcp.bolta.ai/mcp. The app opens a client for that one server and asks which tools it offers.
- The AI reads your voice. get-voice-context hands the AI the voice and business details you set up in Bolta, so the draft is written from those and not from the AI's own default style.
- Setup: No sign-in button? Use an API key. Create a key under Settings, API Keys in Bolta. It starts with bolta_sk_, and you tick only the permissions the job needs. Send it as the header Authorization: Bearer followed by the key, and enter it through your app's secret field where it has one, so it stays out of a file that could reach Git.
- Setup: Add the Bolta skill. Optional. The server works without it. If your app reads a skills folder, install it from a terminal with npx skills add boltaai/bolta-skills --skill bolta, or copy skills/bolta from the bolta-skills repository by hand. Keep the folder name bolta.
- REST API. For code you write yourself, with API keys. It does not need an AI app at all. See the API docs.
- Drafts and review items already saved stay in Bolta until you act on them. A plan you have not saved is only text in the chat.
- Browser sign-in (OAuth). Choose this when the app opens a browser window for remote servers. Bolta opens in your browser, you sign in and tick the brands. Bolta's setup guide says posts made this way wait on your review list until you approve them. The sign-in is valid for about 60 days and usually renews itself.
Connect MCP Server to Bolta
The same address works in every app. Where you paste it depends on the app.
Mastodon questions, answered for MCP Server
- What is the Mastodon character limit for a post from MCP Server?
- It depends on your instance. Bolta reads the limit for the connected account, and the usual limit is 500 characters. Anything over it is trimmed back to the last whole sentence or word.
- Are Mastodon posts from MCP Server public?
- Yes, unless you set another visibility. Say who may see the post when you ask, and check it when you read the draft.
- Do I need an API key, or can I just sign in?
- Sign in if your app offers it, because the browser route lets you tick brands and keeps posts on your review list. Fall back to a key when the app has no connect button but accepts a header.
- My app only supports local (stdio) MCP servers. Can I still use Bolta?
- Not directly, since Bolta's server is remote. Update the app and look for a Remote, HTTP or URL option. If there is none, the REST API or an automation tool such as Zapier, Make or n8n is the other way in.
- Is it free, and what does it cost to use?
- The connection is Bolta's hosted server, and this page cannot confirm what applies to your plan. Check Bolta's pricing page for your plan and for what drafts and posts use.
- A tool fails with 403 or Approval required.
- A 403 means your role or the key's permissions rule that action out, such as saving posts with a key that lacks posts:write. Approval required is a refusal by design, and nothing goes out until you say yes to the exact post. Do not ask the AI to route around it.
- Does MCP Server publish Mastodon posts without my yes?
- No. Nothing is approved, scheduled or published until you say yes to that Mastodon post. Whether MCP Server completes the connection is not fully confirmed, so read the note above first.
More from MCP Server
MCP Server can work with the other networks Bolta publishes to. Each page has its own limits and review notes.
Mastodon from other AI agents
The same Mastodon limits apply whichever agent asks. The connection and the setup are what change.
Try a Mastodon draft from MCP Server
Connect MCP Server, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.