Skip to main content

bonito-mcp

The killer differentiator of Bonito (BON-004): an MCP server that gives any AI agent (Claude, Bedrock, Strands) native access to deep database observability. No Datadog DB Monitoring, DBmarlin or Percona PMM expose MCP — Bonito does.

It is a thin wrapper over the bonito-api REST layer (business logic lives in store/API, not duplicated here).

Run

uv pip install -e bonito-mcp
export BONITO_API_URL=http://localhost:8100
export BONITO_API_KEY=change-me
bonito-mcp                      # stdio transport

Connect to an agent

Claude Desktopclaude_desktop_config.json:

{
  "mcpServers": {
    "bonito": {
      "command": "bonito-mcp",
      "env": { "BONITO_API_URL": "http://localhost:8100", "BONITO_API_KEY": "change-me" }
    }
  }
}

Claude CLI:

claude mcp add bonito -- bonito-mcp

Bedrock / Strands: the same server runs over stdio/SSE — wire it as a tool provider and the agent gets all 8 tools.

Tools

Tool What the agent asks
get_slow_queries "which queries are slow?"
get_active_locks "are there locks right now?"
get_blocking_tree "who is blocking whom?"
explain_query "what's the execution plan for this query?"
get_wait_analysis "what are the sessions waiting on?"
compare_to_baseline "is this query slower than usual?"
suggest_remediation "what should I do about a lock / slow query / bloat?"
get_db_health_summary "give me a health summary of the database"

Config

Env var Default Description
BONITO_API_URL http://localhost:8100 Base URL of bonito-api
BONITO_API_KEY (required) API key matching the API's BONITO_API_KEY

Token governance

query_text is truncated to 500 chars before returning to the LLM; no secrets are ever included in tool output.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bonito_mcp_server-0.1.2.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bonito_mcp_server-0.1.2-py3-none-any.whl (7.1 kB view details)

Uploaded Python 3

File details

Details for the file bonito_mcp_server-0.1.2.tar.gz.

File metadata

  • Download URL: bonito_mcp_server-0.1.2.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.17

File hashes

Hashes for bonito_mcp_server-0.1.2.tar.gz
Algorithm Hash digest
SHA256 b5c608b713dd2994598b460355fc667f50572ebc7aad8f9e81965e397b2dec8a
MD5 c607e9a2b80063cade36cee72bcd970a
BLAKE2b-256 8aff26b9f458a51c3550d46708761630417d0888a7b497c1d99d9ebd49f845ec

See more details on using hashes here.

File details

Details for the file bonito_mcp_server-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for bonito_mcp_server-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a20ecea05fb934d59dc94ec079df51f1c9fefee1a5829ae0d7a1220cfb625833
MD5 d97c7bb718e42f71e9ebcdd701cc7033
BLAKE2b-256 9651f1c97b446b480f8fe031dbf65ca214992622bfcd0671bd41451b643e3254

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page