Prometheus exporter and alerting proxy for MCP servers
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":"talyx-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.
# Talyx English | [繁體中文](README.zh-TW.md) [](https://opensource.org/licenses/Apache-2.0) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io) [](https://github.com/astral-sh/ruff) **Prometheus exporter and alerting for MCP servers.** When your MCP server breaks, your users just see a broken agent—you see exactly which server failed, how slow it got, and when. Wrap any stdio server, **zero code changes**. Talyx is a **zero-code proxy**: it sits between your MCP client and server, forwards the stdio JSON-RPC untouched, and exports Prometheus metrics about the traffic. It ships with a Grafana dashboard and Alertmanager rules. It is **stateless** — no database, Prometheus just scrapes `/metrics`. ```mermaid flowchart LR client["MCP client"] <-->|stdio JSON-RPC| talyx["talyx<br/>(proxy + exporter)"] talyx <-->|stdio JSON-RPC| server["your MCP server"] talyx -->|/metrics :9464| prom["Prometheus"] --> grafana["Grafana"] prom --> am["Alertmanager"] ``` ## Table of Contents - [Talyx](#talyx) - [Table of Contents](#table-of-contents) - [Quickstart (the demo)](#quickstart-the-demo) - [Use it on your own server](#use-it-on-your-own-server) - [Metrics](#metrics) - [How it works](#how-it-works) - [Roadmap](#roadmap) - [License](#license) - [Author](#author) ## Quickstart (the demo) Runs talyx + a sample MCP server + Prometheus + Alertmanager + Grafana, with live traffic, in one command: ```bash git clone https://github.com/alan66603/talyx.git cd talyx docker compose -f deploy/compose/demo.yaml up --build ``` Then open **http://localhost:3000** → dashboard **MCP Overview** (anonymous, no login).…
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.