VS Code + Mastodon

Mastodon posts with VS Code and Bolta

Draft and queue social posts from VS Code's AI chat. Parts of the VS Code route are not confirmed yet, and the note below says which. Nothing goes live on Mastodon until you say yes.

Add one small JSON file with the Bolta server address. Sign in from the browser if VS Code offers it. Otherwise use a Bolta API key.

VS CodeBolta 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 VS Code

  • The config and sign-in steps follow Bolta's own guide and VS Code's MCP format. Nobody has run a full draft, review and schedule through VS Code yet.
  • Menu names and file locations change between VS Code versions, so check VS Code's MCP docs if a label does not match.
  • Bolta's skills repository lists VS Code as not tested.
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 VS Code: 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

VS Code jobs for Mastodon, and how to write them

  • Review and approve what Bolta has queued without leaving the editor
  • Ask for your instance's limit before drafting. It differs from instance to instance.
Prompts

Example prompts for Mastodon

Things to type in VS Code. 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

Which Bolta brands can you see? List them only and do not change anything

Turn the release notes into a Mastodon post with one relevant hashtag and show it to me first

Check the posting rules for Mastodon, then draft a post from the README intro

Review

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

  1. 01

    Bolta saves a draft

    VS Code 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.

VS Code and Bolta

Using VS Code for Mastodon

Parts of this route are not confirmed. The note above says which.

For Mastodon, VS Code, from Microsoft, reaches Bolta through Remote MCP server in mcp.json (Streamable HTTP). Sign-in: Sign in from the browser, or API key as a Bearer header. The Mastodon account itself is connected inside Bolta, not in VS Code.

VS Code adds Bolta through a small .vscode/mcp.json file, with a browser sign-in if it offers one and an API key otherwise. You ask for Mastodon drafts in its AI chat.

An illustration from the VS Code guide, not real output. You ask: Which Bolta brands can you see? List them only and do not change anything The reply goes along these lines: I can see the brands you ticked at sign-in. I changed nothing. Read only.

The Bolta entry is small: a key named bolta, a type of http and the address https://mcp.bolta.ai/mcp, all under a top-level servers key. In VS Code, http means Streamable HTTP, which is what Bolta speaks.

Other apps name these keys differently (url, serverUrl or httpUrl) and some use mcpServers as the top key. If you copy the entry to another editor, check that editor's docs instead of pasting it unchanged.

  • Review without leaving the editor. See what is waiting, read each draft, approve one post at a time or reject it with your own reason. Batch approval may not be offered in every app.
  • Voice and brand context. Read the saved voice, or update it when your tone changes, so engineering posts do not drift into marketing speak.
  • It finds your brand. The chat asks Bolta which brands the connection can reach, so a draft lands under the right one.
  • It saves a draft and shows you the text. The draft is saved in Bolta and printed in the chat. It stays a draft until you say yes to that exact text.
  • Setup: Start the server and sign in. Save the file, then run MCP: List Servers from the Command Palette and start Bolta if it is stopped. If VS Code offers sign-in for remote servers, a browser window opens on Bolta. Sign in and tick the brands this app may reach. If there is no sign-in, create an API key in Bolta under Settings, API Keys, and have VS Code prompt for it as a Bearer header so it never sits in the file. Keep keys out of git.
  • Setup: Check that Bolta's tools are listed. Open VS Code's chat in agent mode and look for Bolta in the tools list. If it is listed and not switched off, the connection works. Ask which Bolta brands it can see, and it should name the ones you ticked.
  • Skill via npx skills add. npx skills add boltaai/bolta-skills --skill bolta, or copy skills/bolta by hand. Bolta's skills repository lists VS Code as not tested.
  • Nothing new is drafted by the chat itself. Asking for a draft needs VS Code open with the Bolta server running.
Connect

Connect VS Code to Bolta

Add one small JSON file with the Bolta server address. Sign in from the browser if VS Code offers it. Otherwise use a Bolta API key.

FAQ

Mastodon questions, answered for VS Code

What is the Mastodon character limit for a post from VS Code?
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 VS Code public?
Yes, unless you set another visibility. Say who may see the post when you ask, and check it when you read the draft.
Is this tested end to end?
Not yet. Nobody has run a full draft, review and schedule through VS Code. Claude Code is the most tested path, and our skills repository lists VS Code and other apps as not tested.
Where does the Bolta config file go in VS Code?
For one project it is .vscode/mcp.json inside the project folder, with a top-level servers key. VS Code's guided MCP: Add Server command can also write it for you. Newer VS Code versions may point new setups at other locations, so check VS Code's MCP docs if the file seems ignored.
Can it read my changelog and write a post from it?
Yes, in agent mode the chat can read files in your workspace, such as CHANGELOG.md, and then call Bolta to save a draft from what it read. It writes only from text in front of it, so check the draft for claims the changelog does not support. Nothing is scheduled until you say yes.
How long does the sign-in last?
Sign-ins last about 60 days and normally renew themselves. If Bolta reports an expired or inactive connection, do not retry in a loop. Sign in again from VS Code's server list, or create a new API key and replace the old one.
Does VS Code publish Mastodon posts without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Mastodon post. Whether VS Code completes the connection is not fully confirmed, so read the note above first.

More from VS Code

VS Code 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 VS Code

Connect VS Code, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.