Paperclip + Mastodon

Mastodon posts with Paperclip and Bolta

Give your Paperclip agent team a social media tool that waits for your yes. Parts of the Paperclip route are not confirmed yet, and the note below says which. Nothing goes live on Mastodon until you say yes.

Paperclip is configured on your own machine, so there is no one-click link. The guide has the address to paste.

PaperclipBolta connected
You

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.

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

What is and is not confirmed

Read this before you set up Paperclip

  • Confirmed from Paperclip's official docs: the Connectors page accepts a remote MCP server URL, and signs in with OAuth, an API key sent as an Authorization header, or no auth. Each action can be set to Allowed, Ask first or Off.
  • Not confirmed: which MCP transport Paperclip uses (Streamable HTTP or SSE). Bolta's server uses Streamable HTTP, so the connection is expected to work but has not been tested end to end.
  • Not confirmed: whether Paperclip's OAuth client registration works against mcp.bolta.ai. If it does not, use a Bolta API key instead.
  • Not confirmed: whether every agent runtime inside Paperclip can use the connector or the skill. Test with the agent you plan to rely on.
  • There is no Bolta-specific Paperclip plugin. This page uses Paperclip's own custom MCP connector and, optionally, its skills import.
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 Paperclip: 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

Paperclip jobs for Mastodon, and how to write them

  • Have a research agent hand a product update to the social agent, which drafts it in your voice
  • Share one Bolta connection across several agents, with different ones allowed to read or draft
  • Ask for your instance's limit before drafting. It differs from instance to instance.
Prompts

Example prompts for Mastodon

Things to type in Paperclip. 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 connected to each one

Draft a Mastodon post that is visible to everyone, and show me the text before saving it

Show me what is waiting in the Bolta inbox

Review

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

  1. 01

    Bolta saves a draft

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

Paperclip and Bolta

Using Paperclip for Mastodon

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

For Mastodon, Paperclip, from Paperclip (open source, MIT), reaches Bolta through Connectors page, Connect your own MCP server. Sign-in: OAuth in the browser, or a Bolta API key. The Mastodon account itself is connected inside Bolta, not in Paperclip.

Paperclip runs a team of agents on your machine, and each connector action can be set to Allowed, Ask first or Off. A content agent can draft Mastodon posts while Paperclip's rules and Bolta's approval both stand in the way of anything public.

An illustration from the Paperclip guide, not real output. You ask: Write a post for our newsletter launch, but check our voice first. The reply goes along these lines: I read the brand's voice context and the posting rules, then saved a draft. It stays a draft. Read it, and reply yes if you want it sent for approval. Draft saved. Waits for your yes.

Importing it does not attach it to any agent, so assign the skill to your social media agent afterwards. Paperclip's docs say skill syncing is unsupported for some runtimes, openclaw_gateway among them, where you manage skills inside the remote runtime. Confirm yours supports it.

Paperclip's README says you can track reported spend, get threshold alerts and pause work at configured limits, set at company, agent or project level. It also records approvals and cost events as activity you can audit. Setting a limit on the social agent is a way to cap a loop that keeps retrying.

Bolta holds the drafts in its own inbox, so if something looks off you can compare what Paperclip logged with what actually arrived in Bolta.

  • Draft in your voice. Voice context and posting rules come from Bolta before the agent writes, then the post is saved as a draft.
  • Work the inbox. The agent can read what is waiting for approval and tell you, without approving anything itself.
  • It saves a draft, not a post. The text is saved in Bolta as a draft. If save-post is set to Ask first in Paperclip, a person confirms that step too.
  • A person decides in Bolta. The draft waits in the inbox. Approving, scheduling or publishing happens only after you say yes.
  • Setup: Install Paperclip if you have not. Run npx paperclipai@latest onboard --yes in a terminal (it needs Node.js 24.11 or newer), then open http://localhost:3100. Paperclip is self-hosted, so you do not need a Paperclip account.
  • Setup: Ask for drafts and approve them in Bolta. Ask for a post. It is saved as a draft. Read it and approve it in Bolta, or in a chat with an approval step, before anything goes public.
  • OAuth sign-in. Paperclip's docs say it needs dynamic client registration or Client ID Metadata Documents. Whether that completes against Bolta is untested.
  • Paperclip agents wake for assigned work or configured schedules, and the Paperclip server you host does that waking. If the machine running it sleeps or Paperclip is stopped, the social agent does not wake.
  • API key. Choose this if the agents run unattended or OAuth will not complete. Create a key in Bolta under Settings, API Keys and paste it into the connector. Paperclip sends it as an Authorization header. A key is not a sign-in that has to be renewed, but it can be revoked, so keep it private and replace it if it leaks.
Connect

Connect Paperclip to Bolta

Paperclip is configured on your own machine, so there is no one-click link. The guide has the address to paste.

FAQ

Mastodon questions, answered for Paperclip

What is the Mastodon character limit for a post from Paperclip?
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 Paperclip public?
Yes, unless you set another visibility. Say who may see the post when you ask, and check it when you read the draft.
Can my Paperclip agent publish without my approval?
No. Bolta does not approve, schedule or publish until a person says yes. You can also set publish and approve to Off in Paperclip's action permissions for a second layer.
How do I install the Bolta skill in Paperclip?
Import it at company level in Paperclip, using npx skills add boltaai/bolta-skills --skill bolta as the source, then assign it to your social media agent. Importing alone does not attach it.
Which agent runtime should hold the Bolta connection?
Use the one your social media agent already runs on, such as Claude Code, Codex, Cursor or OpenClaw. We have not confirmed every runtime can use company connectors, so test with the one you choose.
Paperclip cannot connect to https://mcp.bolta.ai/mcp
Check the full URL including /mcp and https. If it connects but calls fail with an auth error, the Authorization value may need the Bearer prefix. Paperclip's docs do not say which MCP transport it uses, and Bolta uses Streamable HTTP, so a transport mismatch is possible. If it fails, tell us which version of Paperclip you run.
Does Paperclip publish Mastodon posts without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Mastodon post. Whether Paperclip completes the connection is not fully confirmed, so read the note above first.

More from Paperclip

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

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