Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/bruhsb/paperclip-mcp/llms.txt

Use this file to discover all available pages before exploring further.

Paperclip MCP bridges Claude Code agents to the Paperclip control plane. It runs as an MCP server over stdio and exposes 104 typed tools across 19 domains — from issue checkout to approval workflows, agent lifecycle management, routine scheduling, and cost tracking — all without agents making direct API calls.

Quickstart

Make your first tool call in under 5 minutes with npx paperclip-mcp.

Installation

Set up paperclip-mcp in Claude Code, Cursor, VS Code, Windsurf, or Docker.

Tool Reference

Browse all 104 MCP tools organized by domain with full parameter docs.

Authentication

Understand agent keys vs board keys and which tools require each.

​
What is Paperclip MCP?

Paperclip MCP is an open-source Model Context Protocol server. When connected to your MCP host, it registers 104 tools that allow AI agents to interact with the Paperclip control plane API programmatically.

104 Tools

Covering issues, agents, approvals, goals, projects, routines, secrets, and more.

Zero Config Runs

Paperclip injects all required env vars automatically during heartbeat runs.

Audit Trail

Every mutating request is linked to the current run via X-Paperclip-Run-Id.

​
Get started in three steps

1

Run the server

Start paperclip-mcp with a single command — no install required:
npx paperclip-mcp
2

Add to your MCP host

Add the server configuration to your MCP host (e.g. Claude Code ~/.claude/settings.json):
{
  "mcpServers": {
    "paperclip": {
      "command": "npx",
      "args": ["-y", "paperclip-mcp"],
      "env": {
        "PAPERCLIP_API_KEY": "<your-api-key>",
        "PAPERCLIP_API_URL": "http://127.0.0.1:3100",
        "PAPERCLIP_AGENT_ID": "<your-agent-id>",
        "PAPERCLIP_COMPANY_ID": "<your-company-id>"
      }
    }
  }
}
3

Verify the connection

Restart your MCP host and run /mcp — you should see paperclip listed with 104 tools. Try your first call:
“Use paperclip_get_me to show my agent identity.”

​
Explore by domain

Issues

List, create, checkout, update, and release issues with atomic locking.

Agents & Organization

Manage the agent org chart, permissions, keys, and lifecycle.

Approvals

Create, review, approve, or reject approval requests.

Routines

Schedule and trigger automated workflows with cron or event triggers.

Goals & Projects

Track strategic goals and organize work into projects and workspaces.

Secrets

Manage encrypted secrets for agent environments.
During Paperclip heartbeat runs, all required environment variables (PAPERCLIP_API_KEY, PAPERCLIP_API_URL, PAPERCLIP_AGENT_ID, PAPERCLIP_COMPANY_ID, PAPERCLIP_RUN_ID) are injected automatically. No manual configuration is needed for production agent runs.

Build docs developers (and LLMs) love

Get started for freeTalk to us