{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4a3898tvdftv","handle":"mcp-grade","url":"https://wellknown.network/agents/mcp-grade","links":{"self":"https://wellknown.network/agents/mcp-grade/record.json","html":"https://wellknown.network/agents/mcp-grade","markdown":"https://wellknown.network/agents/mcp-grade/record.md","api":"https://wellknown.network/api/v1/agents/mcp-grade","status":"https://wellknown.network/api/v1/agents/mcp-grade/status","claim":"https://wellknown.network/agents/mcp-grade/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-grade/claim.json","badge":"https://wellknown.network/agents/mcp-grade/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-grade/history","tools":"https://wellknown.network/api/v1/agents/mcp-grade/tools"},"ard":{"identifier":"urn:air::server:mcp-grade","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-grade","summary":"Lighthouse/ESLint for MCP servers — grade any MCP server A–F, probe it live, and rank the ecosystem on a leaderboard.","description":"<div align=\"center\">\n\n# 🔍 mcp-grade\n\n**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.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-grade)](https://pypi.org/project/mcp-grade/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![mcp-grade grade](https://img.shields.io/badge/mcp--grade-A_96-brightgreen)](https://github.com/lipon101/mcp-grade)\n\n![mcp-grade demo](assets/demo.png)\n\n</div>\n\n---\n\nThe 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.\n\n## ✨ Why\n\n- **One command, instant grade.** No config, no signup, <5 seconds.\n- **Security first.** Catches hardcoded secrets, committed `.env` files, and `eval/exec` — weighted so a leaky server can never score well.\n- **Prove it actually runs.** `--live` launches the server and verifies the real MCP handshake.\n- **Shareable report cards.** Export a Markdown card + shields badge for your README or PRs.\n- **CI-native.** A GitHub Action + `--fail-under` make it a quality gate that fails the build.\n- **Ecosystem leaderboard.** Rank popular servers and publish a public scoreboard.\n\n## 📦 Install\n\n```bash\npipx install mcp-grade                 # core CLI\npipx install \"mcp-grade[live]\"         # + live protocol probing\npip install \"mcp-grade[web]\"           # + the leaderboard web dashboard\n```\n\n## 🚀 Quickstart\n\n```bash\nmcp-grade ./path/to/server                       # grade a local repo\nmcp-grade ./path/to/server --report --badge      # + Markdown card + README badge\nmcp-grade https://github.com/someone/server      # clone & scan a remote repo\nmcp-grade ./path/to/server --json report.json    # machine-readable output\nmcp-grade . -…","publisher":{"name":"Md. Torikul Islam Lipon","url":null},"homepage":"https://github.com/lipon101/mcp-grade","repository":"https://github.com/lipon101/mcp-grade","version":"1.0.0","license":"MIT","protocols":["mcp"],"tags":["agents","github-actions","leaderboard","lighthouse","lint","mcp","model-context-protocol","quality","security"],"pricing":null,"endpoints":[{"url":"pypi:mcp-grade","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"derived"},{"slug":"analytics.reporting","name":"Reporting & Dashboards","confidence":0.814,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["analytics","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-grade","registry":"pypi","observedAt":"2026-10-28T11:27:21.791Z","publishedAt":"2026-07-26T06:14:37.244735Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-grade","url":"https://pypi.org/project/mcp-grade/","firstSeenAt":"2026-09-10T01:21:27.570Z","fetchedAt":"2026-10-28T11:26:16.615Z","normalizedAt":"2026-10-28T11:26:16.615Z"}]},"firstSeenAt":"2026-09-10T01:21:27.570Z","updatedAt":"2026-10-28T11:27:21.791Z"}