Lighthouse/ESLint for MCP servers — grade any MCP server A–F, probe it live, and rank the ecosystem on a leaderboard.
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":"mcp-grade","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.
<div align="center"> # 🔍 mcp-grade **Stop debugging dead MCP servers.** One command grades any MCP server **A–F** on security, liveness, protocol, usability, and docs — then can **probe it live** and **rank the whole ecosystem** on a leaderboard. [](https://pypi.org/project/mcp-grade/) [](LICENSE) [](https://github.com/lipon101/mcp-grade)  </div> --- The MCP ecosystem has **15,000+ servers** — and roughly **1 in 6 has a verified problem**: dead repos, deprecated packages, stale code, leaked secrets. `mcp-grade` is the fast, opinionated **linter + Lighthouse** you run *before* you wire a server into your agent. ## ✨ Why - **One command, instant grade.** No config, no signup, <5 seconds. - **Security first.** Catches hardcoded secrets, committed `.env` files, and `eval/exec` — weighted so a leaky server can never score well. - **Prove it actually runs.** `--live` launches the server and verifies the real MCP handshake. - **Shareable report cards.** Export a Markdown card + shields badge for your README or PRs. - **CI-native.** A GitHub Action + `--fail-under` make it a quality gate that fails the build. - **Ecosystem leaderboard.** Rank popular servers and publish a public scoreboard. ## 📦 Install ```bash pipx install mcp-grade # core CLI pipx install "mcp-grade[live]" # + live protocol probing pip install "mcp-grade[web]" # + the leaderboard web dashboard ``` ## 🚀 Quickstart ```bash mcp-grade ./path/to/server # grade a local repo mcp-grade ./path/to/server --report --badge # + Markdown card + README badge mcp-grade https://github.com/someone/server # clone & scan a remote repo mcp-grade ./path/to/server --json report.json # machine-readable output mcp-grade . -…
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.