Docs · MCP

Bichito MCP

Drop the bichito widget into any codebase and triage bichitos by chatting with your AI assistant. This page is also designed to be pasted whole into Claude / Cursor — see the button on the right.

1. Get your keys

API key(for installing the widget) — open your honeycomb's Settings → Additional API keys → Generate. Starts with sk_.
MCP token (for read/write of bichitos) — go to /settings/mcp → Generate. Starts with mcp_. Pick scopes — read-only is the default, write scopes are opt-in.

2. Install the MCP

Pick your AI tool. Replace sk_xxx and mcp_xxx with your real values.

Claude Code

claude mcp add bichito \
  --env BICHITO_API_KEY=sk_xxx \
  --env BICHITO_MCP_TOKEN=mcp_xxx \
  --env BICHITO_API_URL=https://bichito-api.fly.dev \
  -- npx -y @bichito/mcp

Cursor / Continue (~/.config/<tool>/mcp.json)

{
  "mcpServers": {
    "bichito": {
      "command": "npx",
      "args": ["-y", "@bichito/mcp"],
      "env": {
        "BICHITO_API_KEY": "sk_xxx",
        "BICHITO_MCP_TOKEN": "mcp_xxx",
        "BICHITO_API_URL": "https://bichito-api.fly.dev"
      }
    }
  }
}

Restart your AI tool after installing.

3. Tools

Tool	Required scope	What it does
get_install_snippet	—	Returns the install snippet for html / react / next / vue with the project's API key embedded.
detect_framework	—	Reads package.json (or index.html) to guess which framework the project uses.
verify_api_key	—	Pings the bichito API to confirm a project API key is valid.
list_honeycombs	`read:honeycombs`	Lists the user's projects across all hives.
list_bugs	`read:bugs`	Lists bichitos with filters (status, severity, search, honeycomb_id, limit, offset).
get_bug	`read:bugs`	Returns one bichito's full detail.
get_stats	`read:teams`	Cross-team summary: open count + breakdowns by severity and status.
resolve_bug	`write:bugs`	Marks a bichito as resolved (idempotent).
mark_spam	`write:bugs`	Marks a bichito as spam.
assign_me	`write:bugs`	Assigns the bichito to the user owning the MCP token.
comment_on_bug	`write:bugs`	Adds a comment to a bichito.
update_bug	`write:bugs`	Sets status and/or severity on a bichito (mirror of the dashboard PATCH).
list_labels	`read:labels`	Lists the labels available in a team.
create_label	`write:labels`	Creates a new label in a team. Color is a #RRGGBB hex string.
update_label	`write:labels`	Renames or recolors a label.
delete_label	`write:labels`	Removes a label from the team and from every bug it was attached to.
attach_label	`write:bugs`	Attaches a label to a bug. Pass label_id or label_name (idempotent).
detach_label	`write:bugs`	Removes a label from a bug. Pass label_id or label_name (idempotent).

4. Try it

Once installed, ask your AI directly:

"Install bichito in this project."
"How many open bichitos do I have?"
"Mark as spam all bugs with title containing ‘test’."
"Show me my critical bugs from this week."

5. Troubleshooting

401 Invalid MCP token: Token revoked or wrong. Mint a new one at /settings/mcp and update BICHITO_MCP_TOKEN.
403 scope required: write:bugs: Your token is read-only. Re-mint with the write scope checked.
404 on a bug id: Belongs to a different user or doesn't exist. MCP tokens only see bichitos in hives the owning user owns.
429 too many requests: The MCP endpoints inherit the dashboard's per-IP rate limits. Back off and retry.