Mastodon posts with Cursor and Bolta
Turn what you just shipped into social posts, from inside the editor. Parts of the Cursor 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
One JSON entry, then a browser sign-in. No key is needed unless you prefer one.
Read the top entry in CHANGELOG.md and draft a Mastodon post about it inside my instance's limit
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 Cursor
- Confirmed from Cursor's own docs: remote MCP servers go in mcp.json with a url, Cursor supports OAuth sign-in for them, and skills load from .cursor/skills and ~/.cursor/skills. Bolta's server is a remote MCP server of exactly that kind.
- Not confirmed: nobody at Bolta has run a full draft, review and schedule round trip inside Cursor. The config and the skill follow Cursor's docs, but the sign-in handshake with mcp.bolta.ai has not been watched end to end.
- Not confirmed: whether the Bolta skill can be imported into a Cursor team marketplace as it stands. Do not expect a one-click import from GitHub.
- Cursor's menu labels change between versions. Where this page names a menu, look for the MCP servers list if the label differs.
- Bolta takes media as a public link, not as an upload from Cursor. Instagram and Pinterest posts need an image or video, and TikTok and YouTube need a video.
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 Cursor: 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. |
Cursor jobs for Mastodon, and how to write them
- Read the README of the project you have open and draft an announcement for a new open-source repo
- Ask for your instance's limit before drafting. It differs from instance to instance.
Example prompts for Mastodon
Things to type in Cursor. Each one asks for a draft and shows you the text first.
Read the top entry in CHANGELOG.md and draft a Mastodon post about it inside my instance's limit
List the drafts in Bolta that are waiting for review, oldest first
Turn the release notes into a Mastodon post with one relevant hashtag and show it to me first
Show how my last three posts performed and suggest what to post next
Bolta saves a draft, you read the exact text, you say yes
- 01
Bolta saves a draft
Cursor 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 Cursor for Mastodon
Parts of this route are not confirmed. The note above says which.
For Mastodon, Cursor, from Anysphere, reaches Bolta through Hosted MCP server in mcp.json. Sign-in: Browser sign-in (OAuth), or an API key header. The Mastodon account itself is connected inside Bolta, not in Cursor.
Cursor is a code editor, so a Mastodon draft can start from a changelog, a commit or the README in the open project. The draft is stored in Bolta, so a scheduled post does not need Cursor to stay open.
The entry is the same in both: a bolta server with url https://mcp.bolta.ai/mcp. Cursor's docs say the URL can be a Streamable HTTP or SSE endpoint.
The key does not change the approval rule. Bolta still holds anything that has not had your yes.
Export it as BOLTA_API_KEY in your shell profile, then restart Cursor so it sees the variable.
- Keep your voice and brand facts. Teach Bolta how your product should sound once, such as no jargon in customer posts. Later drafts from Cursor reuse it.
- Check how posts did. Ask for last week's results and what to post next without opening a dashboard, so the next release post can borrow what worked.
- It saves a draft. The text the agent wrote from your CHANGELOG.md or diff is stored in Bolta as a draft. It is not scheduled and not live.
- Setup: Sign in and tick your brands. Click sign in next to bolta. Your browser opens on Bolta. Sign in, tick the brands this connection may reach, then go back to Cursor. One connection is one organization. The server should show as connected with a list of tools.
- Setup: Optional: use an API key instead of sign-in. Create a Bolta API key in Bolta under Settings, API Keys (it starts with bolta_sk_, and carries only the permissions you tick), store it in an environment variable, and add "headers":{"Authorization":"Bearer ${env:BOLTA_API_KEY}"} to the bolta entry. Keep the key out of git.
- Hosted MCP with an API key header. Add Authorization: Bearer ${env:BOLTA_API_KEY} under headers. Cursor's docs show headers and ${env:NAME} expansion. Not tested against Bolta by Bolta.
- A routine you switched on in Bolta keeps running on its own schedule, with no Cursor window needed.
- Add Bolta to mcp.json and sign in. Put the bolta entry in ~/.cursor/mcp.json, click sign in next to it in Cursor, and tick your brands in the browser.
Connect Cursor to Bolta
One JSON entry, then a browser sign-in. No key is needed unless you prefer one.
Mastodon questions, answered for Cursor
- What is the Mastodon character limit for a post from Cursor?
- 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 Cursor 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 scheduled posts still go out if I close Cursor?
- Yes. Once a post is scheduled it lives in Bolta and publishes on time. Cursor only needs to be open while you are giving commands.
- How do I install the Bolta skill in Cursor?
- Run npx skills add boltaai/bolta-skills --skill bolta, pick Cursor if asked, and restart Cursor. This is a Bolta route using the skills CLI, not a Cursor command. Cursor loads skills from .cursor/skills and .agents/skills.
- Can my whole team use Bolta in Cursor?
- Each teammate can add the same mcp.json entry and sign in with their own Bolta login, and access follows their Bolta role. A team marketplace import is not confirmed, because Cursor's docs ask for a marketplace file that Bolta's repo does not appear to have.
- Which brands can Cursor reach if I have several?
- The ones you ticked when you signed in. One connection is one organization. Name the brand in your request, and reconnect to add a new one.
- Does Cursor publish Mastodon posts without my yes?
- No. Nothing is approved, scheduled or published until you say yes to that Mastodon post. Whether Cursor completes the connection is not fully confirmed, so read the note above first.
More from Cursor
Cursor 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 Cursor
Connect Cursor, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.