MCP server (read-only by default) for Percona Monitoring and Management (PMM) 2.x and 3.x: PromQL metrics and Query Analytics
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"pmm-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# PMM MCP Server [](LICENSE) [](https://www.python.org/) [](https://modelcontextprotocol.io/) A community-maintained [Model Context Protocol](https://modelcontextprotocol.io/) server for [Percona Monitoring and Management](https://www.percona.com/software/database-tools/percona-monitoring-and-management) (PMM 2.x and 3.x). It gives Claude and other MCP clients **read-only** access to MySQL, MongoDB and PostgreSQL metrics (PromQL) and Query Analytics (slowest queries, query details, ClickHouse SQL). > This is not an official Percona or Anthropic product. ## ✨ Features - **Read-only by default**: works with a Grafana *Viewer* token. Optional write tools (silences, annotations) are off unless `PMM_ALLOW_WRITE=1` and always dry-run first - **Metrics**: instant and range PromQL queries plus label discovery - **Query Analytics (QAN)**: top queries, per-service load, single-query details and distribution over time - **Safe SQL**: free-form `SELECT` against QAN's ClickHouse, strictly validated and capped - **TLS verified by default**, with custom CA bundle support - **Cross-platform**: Linux, macOS and Windows, with one-command installers ## 🚀 Installation **Requirements** - Python 3.11+ and [`uv`](https://docs.astral.sh/uv/) - Network access to your PMM server (VPN if needed) - A PMM Grafana token: *Administration → Service accounts → role Viewer → Add token* **With `uvx` (no clone needed)** ```bash uvx pmm-mcp ``` Put `PMM_URL` and `PMM_TOKEN` in the environment (or an env file, see [Configuration](#-configuration)). To register it with Claude Code: ```bash claude mcp add pmm -- uvx --env-file ~/.config/mcp/pmm.env pmm-mcp ``` **Linux / macOS (installer)** ```bash git clone https://github.com/hakkiburakalks/pmm-mcp && cd pmm-mcp && ./install.sh ``` **Windows (PowerShe…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.