@rotorsh/mcp

Customer-facing MCP server for Rotor. Claude Code / Cursor / Claude Desktop tools for queues, schedules, jobs, DLQ replay, and more — workspace-scoped to your API key.

60-second quickstart

1. Get a workspace API key: rotor api-keys create --label "claude code" (CLI install: npm i -g @rotorsh/cli)
2. Add to your client config (.mcp.json for Claude Code/Desktop, ~/.cursor/mcp.json for Cursor):

   {
     "mcpServers": {
       "rotor": {
         "command": "npx",
         "args": ["-y", "@rotorsh/mcp"],
         "env": { "ROTOR_API_KEY": "rt_ws_..." }
       }
     }
   }

3. Restart your client and prompt: "list my Rotor queues"

Full install guide

docs.rotor.sh/mcp/install

What this is

Workspace-scoped tools: rotor_list_queues, rotor_create_queue, rotor_create_schedule, rotor_inspect_run_history, rotor_get_dlq, rotor_replay_dlq, and ~21 more covering every CLI command group.

What this is not

• Operator/admin tools — those live at @rotor/mcp-hosted (operator-only, requires ADMIN_TOKEN)
• Hosted Streamable-HTTP MCP — that's rotor.sh/mcp (workflow surface for trigger_workflow, approve_run, etc.)

License

Closed-source — rotor.sh commercial license. Bug reports welcome at the public issue tracker.