{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ajgckq6635kt","handle":"mcp-top","url":"https://wellknown.network/agents/mcp-top","links":{"self":"https://wellknown.network/agents/mcp-top/record.json","html":"https://wellknown.network/agents/mcp-top","markdown":"https://wellknown.network/agents/mcp-top/record.md","api":"https://wellknown.network/api/v1/agents/mcp-top","status":"https://wellknown.network/api/v1/agents/mcp-top/status","claim":"https://wellknown.network/agents/mcp-top/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-top/claim.json","badge":"https://wellknown.network/agents/mcp-top/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-top/history","tools":"https://wellknown.network/api/v1/agents/mcp-top/tools"},"ard":{"identifier":"urn:air::server:mcp-top","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-top","summary":"Profile local MCP server context footprint and usage.","description":"# mcp-top\n\n> mcp-top profiles your local MCP context footprint: what servers advertise, what may load into context, and which tools your agents actually use.\n\nLicense: MIT - Dependencies: none (Python stdlib, 3.11+)\n\n## Install\n\nThe PyPI package is available as of v0.5.0:\n\n```sh\nuvx mcp-top\n```\n\n```sh\npipx install mcp-top\n```\n\n```sh\npip install mcp-top\n```\n\nClone-and-run still works:\n\n```sh\npython bin/mcp-top\n```\n\nYou can also run the package module directly when `src` is on `PYTHONPATH`:\n\n```sh\nPYTHONPATH=src python -m mcp_top\n```\n\n## The Problem\n\nMCP servers accumulate. Their advertised tools can be large, but modern clients do not all load those definitions the same way. Ordinary spend dashboards show money rather than context composition. `mcp-top` shows the join that is usually missing: advertised MCP footprint, possible upfront context footprint, and actual local usage.\n\n## Quickstart\n\nThis real output is captured by the reproducible case study in [docs/examples/prune-case-study.md](docs/examples/prune-case-study.md):\n\n```text\nCoverage: 2 transcripts found, 2 parsed, 0 skipped; 2 in window; 3 tool calls (2 MCP); server queries: 2 ok, 0 failed, 0 not queried\n  recorded results: 2 paired, 0 partial, 0 unsupported, 0 unmeasurable, 0 unpaired result(s), 0 unpaired call(s) (recorded result footprint is a recorded-bytes lower bound)\n\nSERVER         SCOPE  TOOLS  TOKEN RANGE  REGIME   CALLS(window)  VERDICT\n-------------  -----  -----  -----------  -------  -------------  ------------------------------------------------------------\nunused-server  user   2      >=~23..~77   unknown  0              prune -> removes advertised up to ~77 / upfront at least ~23\nused-server    user   2      >=~22..~76   unknown  2              review\n  used-server recorded result footprint: 37 recorded UTF-8 byte(s) (lower bound) -> ~10 tok (estimate) across 2 result(s) (max ~5, p90 ~5)\n\nused-server called tools:\n  - first_tool: 1\n  - second_tool: 1\n```\n\nDefinition token counts use the ch…","publisher":{"name":"Zhioua Mohamed","url":null},"homepage":"https://github.com/mohamedzhioua/mcp-top","repository":"https://github.com/mohamedzhioua/mcp-top","version":"0.5.0","license":"MIT License\n        \n        Copyright (c) 2026 Zhioua Mohamed\n…","protocols":["mcp"],"tags":["mcp","model-context-protocol","claude","codex","cursor","cli"],"pricing":null,"endpoints":[{"url":"pypi:mcp-top","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.package-management","name":"Packages & Dependencies","confidence":1,"provenance":"derived"}],"categories":["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-top","registry":"pypi","observedAt":"2026-11-09T19:26:15.465Z","publishedAt":"2026-07-18T15:07:52.925680Z","latestVersion":"0.5.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-top","url":"https://pypi.org/project/mcp-top/","firstSeenAt":"2026-09-10T05:21:26.177Z","fetchedAt":"2026-11-09T19:24:14.070Z","normalizedAt":"2026-11-09T19:24:14.070Z"}]},"firstSeenAt":"2026-09-10T05:21:26.177Z","updatedAt":"2026-11-09T19:26:15.465Z"}