> For the complete documentation index, see [llms.txt](https://docs.voicemoat.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voicemoat.com/assistants/assistants/paperclip.md).

# Paperclip

Paperclip runs teams of agents on runtimes such as Claude Code or Hermes. VoiceMoat is added to the runtime your agents use; a personal key suits agents that run unattended.

**What you need**

* A VoiceMoat plan that includes assistants: **Pro**, **Enterprise**, or the **$5 Pro trial**.
* A personal key. In VoiceMoat, open **Settings**, then **Assistants**, then **Personal keys**, press **Create key** and pick **Paperclip**. Under **What can it do?**, tick **publish** if Paperclip should be able to post straight away. It starts unticked: without it, Paperclip can read, draft and schedule, but a request to post now is refused. Copy the key when it shows: you will not see it again.

{% hint style="info" %}
The address is the same for every assistant: `https://app.voicemoat.com/api/mcp`. Your key goes in a header as `Bearer` followed by the key.
{% endhint %}

***

**Connect it**

1. Save your key as a **Paperclip secret**.
2. In the agent's runtime, add VoiceMoat as an MCP server at the address. For Claude Code: `claude mcp add --transport http voicemoat https://app.voicemoat.com/api/mcp --header "Authorization: Bearer vm_live_your-key"`
3. Make sure the header reads `Authorization: Bearer` followed by the secret.

For Hermes, follow the Hermes Agent guide.

***

**Try it**

Once it is connected, ask Paperclip things like:

* "Does this read like me?" (paste a draft)
* "What did I post last week and how did it do?"
* "Give me three post ideas in my voice for LinkedIn"
* "Schedule that for tomorrow at 9am"

Nothing posts on the first request: VoiceMoat sends Paperclip a preview with the exact text and the account, and Paperclip has to call again with the code it got back. That second call is not you approving the post: Paperclip can make it on its own. To see every post before it goes out, keep Paperclip's tool approval (asking you before it runs a tool) switched on.

**If it does not work**

* **401 or "unauthorized":** check the header is `Authorization: Bearer` followed by the whole key, with one space after `Bearer`.
* **"does not include using VoiceMoat from an assistant":** your plan does not include assistants yet.
* **"This personal key isn't allowed to post":** the key was made without **publish**. A key can't be changed once it is made, so create a new one with **publish** ticked and revoke the old one.
* **Stopped working:** the key may have been revoked, or someone pressed **Disconnect** in Settings. Create a new key.
* **Wrong address:** it must be exactly `https://app.voicemoat.com/api/mcp` (with `app.`).

**Stop it**

In VoiceMoat, open **Settings**, then **Assistants**, and press **Revoke** next to the key. Paperclip stops working with VoiceMoat at once.

*Steps checked November 2026. If Paperclip's screens look different, the idea is the same: a custom MCP server, our address, and the Authorization header.*