Mastodon posts with Windsurf and Bolta
Draft and schedule social posts from Windsurf's chat. For Mastodon, Bolta saves a draft, you read the exact text, and nothing goes live until you say yes.
Checked 2026-11-21
Bolta has no one-click install for Windsurf. You add the server URL and an API key by hand.
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 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 Windsurf: 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. |
Windsurf jobs for Mastodon, and how to write them
- Check Bolta's posting rules for an account before scheduling
- Ask for your instance's limit before drafting. It differs from instance to instance.
Example prompts for Mastodon
Things to type in Windsurf. 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
Set up a weekly routine that drafts a product update for me to approve.
Turn the release notes into a Mastodon post with one relevant hashtag and show it to me first
Which brands can this key reach?
Bolta saves a draft, you read the exact text, you say yes
- 01
Bolta saves a draft
Windsurf 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 Windsurf for Mastodon
For Mastodon, Windsurf reaches Bolta through an MCP server you add by hand, with the Bolta address and an API key. The Mastodon account itself is connected inside Bolta, not in Windsurf.
Windsurf has no one-click install for Bolta. You add the server address and a Bolta API key by hand, then ask for Mastodon drafts in its chat.
This connection uses a Bolta API key, which acts as you. Safe Mode and client sign-off still apply to every Mastodon post it saves, so keep them on.
An illustration from the Windsurf guide, not real output. You ask: How did my posts do this month? Name the best and the weakest. The reply goes along these lines: I pulled this month's results for the account and named one strong post and one weak one, with a single change to try next week. Read only. Nothing changed.
Windsurf's docs say an admin can allowlist MCP servers, and that once one server is allowlisted every server not on the list is blocked.
If Bolta is blocked, ask your admin to add a server with the ID bolta in the team's MCP settings at windsurf.com.
- Check the rules before writing. Ask what an account allows, such as length and media, so the draft fits the network the first time.
- Set up a recurring routine. Describe a weekly update. Cascade shows the plan, and the routine is saved switched off until you confirm it separately.
- It finds the brand and account. Cascade lists your brands and the networks connected to each, so a draft goes to the right place.
- It reads your voice. Before writing, it pulls your voice and brand facts so a changelog line reads like you, not like release notes.
- Setup: Connect a social account. Ask Windsurf's chat to list your accounts. If none are connected, ask it for a connect link and sign in to the network.
- Team or Enterprise plan with an MCP allowlist. Windsurf's docs say servers not on an allowlist are blocked. An admin must allow a server with the ID bolta.
- Drafting new posts, editing a draft and approving one need Cascade open or the Bolta app.
Connect Windsurf to Bolta
Bolta has no one-click install for Windsurf. You add the server URL and an API key by hand.
Mastodon questions, answered for Windsurf
- What is the Mastodon character limit for a post from Windsurf?
- 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 Windsurf public?
- Yes, unless you set another visibility. Say who may see the post when you ask, and check it when you read the draft.
- What can it not do?
- It cannot bypass roles or Safe Mode. Owners and admins can approve any post, creators can approve Bolta's drafts and posts they review, and viewers cannot approve or publish. It also cannot post to an account you have not connected.
- I saved the file and nothing changed. What now?
- Go back to Cascade's MCP list and press refresh, then start a fresh chat. If bolta still shows an error, check the JSON for a missing comma or quote, since one typo breaks the whole file.
- Is Windsurf's tool approval the same as Bolta's approval?
- No. Clicking allow on a Bolta tool in Windsurf only lets the tool run. It does not approve any post. That second yes comes from you in the chat, after you have read the post.
- Is my API key safe in the config file?
- It sits in plain text, so do not commit that file to git or share a screenshot of it. If it leaks, delete the key in Bolta Settings, API Keys, and create a new one.
- Does Windsurf publish Mastodon posts without my yes?
- No. Nothing is approved, scheduled or published until you say yes to that Mastodon post.
More from Windsurf
Windsurf 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 Windsurf
Connect Windsurf, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.