Cursor + Mastodon

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.

One JSON entry, then a browser sign-in. No key is needed unless you prefer one.

CursorBolta connected
You

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.

Illustration. Your drafts show your real text, account and time.

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.
Bolta on Mastodon

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.
Limits and format

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.

Mastodon limits and format rules
What to knowMastodon's own ruleWhat Bolta does
Post lengthNot 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.
VisibilityNot stated on this page.Public unless you set another visibility.
FormattingNot stated on this page.Mastodon posts are plain text here. Markdown is flattened, and #hashtags and @mentions stay as typed.
Finding conversationsNot stated on this page.Hashtag-based. The query is folded into a single tag, because full-text status search is unavailable on most instances.
Best practices

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.
Prompts

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

Review

Bolta saves a draft, you read the exact text, you say yes

  1. 01

    Bolta saves a draft

    Cursor asks Bolta for the Mastodon post in your brand voice (save-post). A saved draft is never public.

  2. 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.

  3. 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.

Cursor and Bolta

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

Connect Cursor to Bolta

One JSON entry, then a browser sign-in. No key is needed unless you prefer one.

FAQ

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.