Mastodon posts with NanoClaw and Bolta
Draft social posts from a chat app, with each brand in its own container. Parts of the NanoClaw 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
NanoClaw runs on your own hardware, so you add the server address https://mcp.bolta.ai/mcp on that machine.
Tell me the character limit for my Mastodon instance, then draft a post about our new release inside it
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 NanoClaw
- Confirmed from NanoClaw's official docs: you can add a remote Streamable HTTP MCP server to an agent group with ncl groups config add-mcp-server --id <group-id> --name <name> --url <https url>. The URL must be HTTPS and cannot carry credentials, which https://mcp.bolta.ai/mcp satisfies.
- Confirmed from the docs: --headers is for non-secret values only, and real credentials belong in the credential gateway vault (OneCLI Agent Vault by default), which injects them in flight. The docs also say not to put a raw key in --env.
- Not confirmed: the exact vault command for storing a Bolta key, and a worked example of the vault injecting a Bearer bolta_sk_ key for a custom MCP host. This page does not write out a one-line Authorization header, because none is documented.
- Not confirmed: whether NanoClaw's remote MCP servers support OAuth sign-in, and whether Bolta's skill works inside its agent containers. Neither has been run end to end.
- Whatever works on the NanoClaw side, Bolta does not change: nothing is approved, scheduled or published until you say yes.
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 NanoClaw: 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. |
NanoClaw jobs for Mastodon, and how to write them
- Run the agent on your own hardware, with the Bolta key held in the vault instead of in the agent
- Ask for your instance's limit before drafting. It differs from instance to instance.
Example prompts for Mastodon
Things to type in NanoClaw. Each one asks for a draft and shows you the text first.
Tell me the character limit for my Mastodon instance, then draft a post about our new release inside it
List my Bolta workspaces and the accounts on each one
Draft a Mastodon post that is visible to everyone, and show me the text before saving it
What is waiting for me in Bolta?
Bolta saves a draft, you read the exact text, you say yes
- 01
Bolta saves a draft
NanoClaw 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 NanoClaw for Mastodon
Parts of this route are not confirmed. The note above says which.
For Mastodon, NanoClaw, from NanoClaw (open source, MIT licence), reaches Bolta through Remote MCP server added to an agent group with ncl. Sign-in: API key held in NanoClaw's credential vault (OAuth not confirmed). The Mastodon account itself is connected inside Bolta, not in NanoClaw.
NanoClaw runs on your own hardware and is messaged from chat apps, so you can say 'draft this week's Mastodon posts' there. Its docs say real credentials belong in a vault, so the agent itself does not hold the Bolta key.
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 NanoClaw guide, not real output. You ask: What is waiting for me in Bolta? The reply goes along these lines: I read your Bolta inbox. It lists drafts waiting for review and any replies Bolta drafted for you. I have not approved or sent anything. Read only. Nothing changed.
An illustration from the NanoClaw guide, not real output. You ask: Which brands and accounts can you reach? The reply goes along these lines: I can see your workspaces and the accounts connected to each. Tell me which brand to use, or I will ask before drafting. Read only. Nothing changed.
For social media, that means you can say draft this week's posts from your phone and have the drafts appear in Bolta's review list. It is built for people who are comfortable with a terminal, since setup uses Docker and the ncl command line.
Add Bolta to each group with its own ncl groups config add-mcp-server command. Because each group runs in its own containers with its own memory, a client's chat history stays in that client's group.
Pair one chat app first and confirm you can message the agent. Adding Bolta to a group that you cannot reach from your phone makes it hard to tell which part failed.
- Drafts from a phone message. Ask for a post in one line and the agent saves it to Bolta as a draft in your brand voice, then shows you the text.
- Weekly drafting as a routine. A repeating job is planned first, saved switched off, and only turned on after a separate yes from you.
- It finds the accounts it could draft for. It reads the networks connected to that workspace. If none are connected, it asks Bolta for a connect link instead of making one up.
- You decide in chat or in Bolta. The agent shows the exact text in the chat. Sending it to review, approving, scheduling or publishing happens only after you say yes for that post.
- Setup: Add Bolta to your agent group. From the host shell, find your group id and run ncl groups config add-mcp-server --id <group-id> --name bolta --url https://mcp.bolta.ai/mcp. Run it on the host, not from inside an agent container, where write commands are approval-gated.
- Setup: Check what it can see. Message your agent: list my Bolta workspaces and accounts. Confirm it shows the right brands and only the ones you want it to use.
- Remote MCP server added with ncl. NanoClaw's docs describe ncl groups config add-mcp-server with an HTTPS URL, so https://mcp.bolta.ai/mcp can be registered on a group, then restart the group. The sign-in step is not documented for this host, so the full route has not been run end to end.
- If the host is off, nothing on the NanoClaw side runs. Drafts already saved in Bolta stay there.
- Add Bolta to a group and restart it. On the machine running NanoClaw, run ncl groups config add-mcp-server --id <group-id> --name bolta --url https://mcp.bolta.ai/mcp, then ncl groups restart --id <group-id>. Put your Bolta key in the credential vault, not in the command.
Connect NanoClaw to Bolta
NanoClaw runs on your own hardware, so you add the server address https://mcp.bolta.ai/mcp on that machine.
Mastodon questions, answered for NanoClaw
- What is the Mastodon character limit for a post from NanoClaw?
- 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 NanoClaw 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 is NanoClaw and is it free?
- NanoClaw is an open-source, MIT-licensed assistant you install and host yourself. The software is free, though you pay for the hardware you run it on and for any model it uses. Bolta has its own plans and drafts are free.
- How do I add Bolta to NanoClaw?
- On the host machine, run ncl groups config add-mcp-server --id <group-id> --name bolta --url https://mcp.bolta.ai/mcp, then ncl groups restart --id <group-id>. Add your Bolta key through NanoClaw's credential vault, not in that command.
- Do I need an API key or can I sign in with OAuth?
- Plan on an API key from Settings, API Keys in Bolta. Whether NanoClaw's remote MCP servers support OAuth sign-in is not described in its docs, so this page does not promise it.
- Where does my Bolta key go so the agent cannot read it?
- In NanoClaw's credential vault (OneCLI Agent Vault by default), which injects it in flight. Never put it in --env or --headers: NanoClaw says --headers is for non-secret values and not to put a raw key in --env. The exact vault command is not confirmed here.
- Does NanoClaw publish Mastodon posts without my yes?
- No. Nothing is approved, scheduled or published until you say yes to that Mastodon post. Whether NanoClaw completes the connection is not fully confirmed, so read the note above first.
More from NanoClaw
NanoClaw 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 NanoClaw
Connect NanoClaw, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.