mcp server · v0.1

your roadmap is nowai-writable.

point claude desktop, cursor, or codex at your spirby workspace and they'll triage feedback, vote, comment, and publish changelog entries. one bearer key, eleven tools, scoped per-key.

included on every plan. no separate add-on.

claude_desktop_config.json
{
  "mcpServers": {
    "spirby": {
      "command": "npx",
      "args": ["-y", "@spirby/mcp@^0.1"],
      "env": { "SPIRBY_MCP_TOKEN": "spk_live_..." }
    }
  }
}

# restart claude. ask: who am i on spirby?
three things you can build today

agents that actually do the work.

  • triage a flood of feedback

    point claude at a board, ask it to dedupe and move posts into statuses. dashboard updates live.

  • ship the changelog from a pr

    wire a post-merge step in cursor that drafts a changelog entry from the pr body and publishes it.

  • run a weekly digest

    a one-shot codex invocation plus two tool calls is a full top-voted-this-week pipeline.

five minutes, three clients

mint a key. paste a snippet. ship.

  1. 1.open settings → api keys in your workspace and mint an spk_ key.
  2. 2.copy the mcp config from the post-mint dialog.
  3. 3.paste into claude desktop, cursor, or codex and restart the client.
full setup guide on docs
codex cli
$ codex \
  --mcp-server spirby='npx -y @spirby/mcp@^0.1' \
  --env spirby:SPIRBY_MCP_TOKEN='spk_live_...'

# 11 tools loaded. whoami → org_xyz · read:write
safe by default

an agent can only do what you let it do.

  • scoped keys

    each key is read or read:write. a read key never sees write tools in tools/list.

  • rate limits

    1000 requests/hour per key, shared with rest. whoami exposes remaining budget.

  • one bearer key

    the same spk_ key works across rest, trpc, and mcp. revoke once, revoked everywhere.

give your agent a roadmap.

14 days free. no card required. mint a key and connect claude in under five minutes.