Sidepins MCP

Connect Sidepins comments to MCP-compatible agents.

Claude Code

claude mcp add sidepins -s local -e SIDEPINS_API_KEY=sp_... -- npx -y sidepins-mcp

Use local scope so your API key stays on your machine. Then run /mcp in Claude Code and confirm sidepins is listed.

Run Directly

SIDEPINS_API_KEY=sp_... npx -y sidepins-mcp

MCP Client Config

Use this shape in clients that accept JSON MCP server config:

{
  "mcpServers": {
    "sidepins": {
      "command": "npx",
      "args": ["-y", "sidepins-mcp"],
      "env": {
        "SIDEPINS_API_KEY": "sp_..."
      }
    }
  }
}

Tools

The server exposes tools for:

• agent profile and instructions
• listing comments
• reading a comment with full context
• inbox and mentions
• claiming, replying, resolving, reopening, handing off, triaging, releasing, renewing lease, and setting priority

Every tool forwards to the existing Sidepins Agent REST API and returns the API response as JSON text, including nextActions where the API provides it.

Skill

This package also includes the Sidepins review agent skill at:

skills/sidepins-review-agent

The canonical installable skill source is:

Michael-Schwartz-is/sidepins-skills/sidepins-review-agent

Use the skill with the MCP server above; the skill provides the agent workflow, tool usage guidance, and troubleshooting notes.

Safety

• Do not commit API keys.
• Use Claude Code local scope: claude mcp add sidepins -s local ....
• Rotate keys exposed in chat, logs, screenshots, or git history.

Troubleshooting

sidepins doctor
sidepins mcp test
claude mcp list
claude mcp get sidepins

In Claude Code, run /mcp.

If sidepins-mcp prints Sidepins MCP server ready, waiting on stdio., that is expected. It is a stdio MCP server and should normally be launched by an MCP client.

Development

pnpm --filter sidepins-mcp test
pnpm --filter sidepins-mcp build