VS Code + Bluesky

Bluesky 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 Bluesky 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

Explain this bug fix to customers in two plain sentences and draft it for Bluesky

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 Bluesky

What Bolta does on Bluesky

Bolta cuts Bluesky text at 300 characters and ends it with an ellipsis, so the useful part of a draft has to come before the limit.

  • Text posts of up to 300 characters, cut with an ellipsis beyond that.
  • Images. A video is left off, and Bolta publishes the text and any images.
Limits and format

Bluesky limits and format rules

Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.

Not promised for Bluesky from VS Code: Custom feeds and quote posts. Neither is confirmed for Bolta. Any Bluesky rule beyond what Bolta reports. This page states Bolta's limits, not a network rulebook.

Bluesky limits and format rules
What to knowBluesky's own ruleWhat Bolta does
Post lengthNot stated on this page.300 characters. Longer text is cut short and ends with an ellipsis.
MediaNot stated on this page.Images are posted. A video is skipped with a warning, and the text and any images still go out.
ThreadsNot stated on this page.Parts after the first are posted as replies, so they read as one Bluesky thread.
FormattingNot stated on this page.Bluesky shows plain text, so Bolta flattens markdown and leaves #hashtags and @mentions as typed.
Best practices

VS Code jobs for Bluesky, and how to write them

  • Draft a week of developer-focused posts in your brand voice
  • Write to 300 characters yourself. The cut is blunt and ends in an ellipsis.
Prompts

Example prompts for Bluesky

Things to type in VS Code. Each one asks for a draft and shows you the text first.

Explain this bug fix to customers in two plain sentences and draft it for Bluesky

What is waiting for my approval in Bolta right now?

Read the top entry in CHANGELOG.md and draft a Bluesky post about it under 300 characters

Look at the newest commits and draft a Bluesky post about the change people will notice most

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 Bluesky post in your brand voice (save-post). A saved draft is never public.

  2. 02

    You read the exact text

    On Bluesky the exact text includes where the 300-character cut would fall, and which images are attached, because a video would be left off.

  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 Bluesky

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

For Bluesky, 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 Bluesky 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 Bluesky drafts in its AI chat.

An illustration from the VS Code guide, not real output. You ask: Explain this bug fix to customers in two plain sentences and draft it for Bluesky The reply goes along these lines: I rewrote the technical note in plain words and saved it as a draft. Please check that it matches what you shipped. Draft saved. Waits for your yes.

An illustration from the VS Code guide, not real output. You ask: Show how my last five posts performed and suggest what to post next The reply goes along these lines: Here is what Bolta's analytics show for those posts, and two ideas that follow from what did better. 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.

A key pasted into a committed file is a key shared with everyone who can read the repo. Use VS Code's inputs block so the key is typed once and held outside the file.

  • Voice and brand context. Read the saved voice, or update it when your tone changes, so engineering posts do not drift into marketing speak.
  • Routines that repeat. Plan a weekly update and confirm it before it is saved. A routine lives in Bolta, and switching it on is a separate yes.
  • It checks the connected accounts. It lists which social accounts are linked. If none are, it asks Bolta for a connect link instead of guessing.
  • 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: Check that VS Code can use MCP servers. Use a recent version of VS Code with its AI chat switched on. A workplace policy can limit MCP servers, so ask your admin if the option is missing. Menu names and file locations change between versions, so check VS Code's own MCP docs if a label here does not match.
  • Setup: Ask for a draft. Ask the chat for a post. It saves a draft in Bolta and shows you the text. Approve it in Bolta or tell the chat yes.
  • MCP with an API key. Create a key in Settings, API Keys, and pass it as a Bearer header through a promptString input. The config is documented in Bolta's guide, but this route has not been run end to end.
  • Posts you approved earlier and scheduled in Bolta publish at their time.
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

Bluesky questions, answered for VS Code

Can VS Code post a video to Bluesky?
Not through Bolta. Bolta publishes the text and any images and leaves a video off, with a warning. Use images, or post the video on another network.
What is the Bluesky length limit for posts from VS Code?
300 characters. Longer text is cut short and ends with an ellipsis, so write to the limit and read the final text before you say yes.
Which brands can VS Code reach?
Only the brands you ticked at sign-in. With several ticked, put the brand name in the request so the draft lands under the right one. To change the list, remove the Bolta server from mcp.json, add it again and sign in again.
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.
Should I use sign-in or an API key?
Use sign-in if VS Code offers it for remote servers, because it follows your Bolta role and only the brands you ticked. An API key acts as you with whatever permissions you gave it, so give it only what you need. Safe Mode and required client sign-off still apply either way. Neither route has been run end to end in VS Code.
How do I keep the API key out of git?
Do not paste it into mcp.json. Add an inputs entry of type promptString with password set to true, and reference it in the Authorization header as Bearer followed by the input id. VS Code then asks for the key when the server starts. Keys begin with bolta_sk_.
Does VS Code publish Bluesky posts without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Bluesky 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.

Bluesky from other AI agents

The same Bluesky limits apply whichever agent asks. The connection and the setup are what change.

Try a Bluesky draft from VS Code

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