{
  "markdown": "# verdoc-mcp\n\nGive your coding agent the context of a repository it has never seen, for two\ncents, without an account or an API key.\n\nAn agent dropped into an unfamiliar codebase has to read it before it can work\nin it - and that costs tens of thousands of tokens every time. `verdoc-mcp`\nexposes two tools that answer the same questions directly:\n\n| tool | what you get | price |\n| --- | --- | --- |\n| `verdoc_agents_md` | an `AGENTS.md` ready to commit | $0.02 |\n| `verdoc_scan` | the same analysis as structured JSON | $0.01 |\n\nBuild and test commands are **quoted from the repository's own manifests**, with\nthe file each one came from named. Every path is checked against the git tree.\nAnything ambiguous is marked `unverified` rather than guessed.\n\n**No language model runs on the server.** The same commit always returns the\nsame answer.\n\n## Install\n\n**Easiest: download the [`.mcpb` bundle](https://github.com/verdochello/verdoc-mcp/releases/latest)**\nand drag it into Claude Desktop, or point any MCPB-aware client at it\ndirectly - dependencies are bundled inside, nothing to install separately.\n\nNot on npm yet. Two other ways to install straight from this repository:\n\n```json\n{\n  \"mcpServers\": {\n    \"verdoc\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"github:verdochello/verdoc-mcp\"],\n      \"env\": { \"EVM_PRIVATE_KEY\": \"0x...\" }\n    }\n  }\n}\n```\n\nOr clone it and point at the file directly:\n\n```bash\ngit clone https://github.com/verdochello/verdoc-mcp && cd verdoc-mcp && npm install\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"verdoc\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/verdoc-mcp/index.mjs\"],\n      \"env\": { \"EVM_PRIVATE_KEY\": \"0x...\" }\n    }\n  }\n}\n```\n\nWorks with Claude Desktop, Claude Code, Cursor, or any MCP client.\n\n**Without a key it still runs.** The tools report what they would cost and what\nthey would return, and buy nothing. That is the intended way to try it.\n\n## Paying\n\nThe wallet needs **USDC on Base, Polygon or Arbitrum**. It does **not** need\nETH - x402 payments are signed off-chain and the facilitator pays the gas.\n\n| variable | default | meaning |\n| --- | --- | --- |\n| `EVM_PRIVATE_KEY` | - | wallet that pays. Omit to run in quote-only mode. |\n| `VERDOC_MAX_SPEND_USD` | `0.05` | hard per-call ceiling. Nothing above it is ever signed. |\n| `VERDOC_ORIGIN` | `https://verdoc.dev` | override the endpoint (testing). |\n\n### About that private key\n\nYou are handing a program the ability to spend your money, so here is exactly\nwhat this one does and does not do.\n\n- The key is read from the environment. It is **never logged, never written to\n  disk, and never sent anywhere.** Error messages are scrubbed of anything that\n  looks like a key before being returned.\n- **The payee and the chain are pinned in the source.** Before signing anything,\n  the client reads the live payment offer and checks it. If Verdoc ever asks to\n  be paid at a different address, or on a chain not in the list, this **refuses\n  and tells you** instead of paying. That means a compromise of our own domain\n  or DNS cannot redirect your funds.\n- Every call is capped by `VERDOC_MAX_SPEND_USD`, checked before a signature\n  exists.\n\nUse a wallet you funded for this purpose. That is good practice with any paying\nagent tool, including this one.\n\n## What it will refuse to do\n\nThese are tested in [`selftest.mjs`](./selftest.mjs), and the refusals are the\npart worth reading:\n\n- pay an address other than the pinned one - even if the live endpoint asks\n- pay on a chain outside the pinned set, including testnets\n- pay more than your ceiling\n- treat a short or empty 200 response as a real answer\n\n## Limits\n\nPublic GitHub repositories only. Repositories over 20,000 tracked files are\nrejected: GitHub truncates the git tree above that, and every claim this service\nmakes depends on having the complete tree.\n\n## Licence\n\nMIT. The service it calls is at [verdoc.dev](https://verdoc.dev) -\n[OpenAPI](https://verdoc.dev/openapi.json) |\n[x402 discovery](https://verdoc.dev/.well-known/x402)\n",
  "bytes": 4026,
  "sha": "08cbf46f8aa50b50928d63eadc612c740ce5b4eaef1997a6ccbe7f66b7c371d2",
  "repo_slug": "verdochello/verdoc-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_verdochello_verdoc_mcp_42d5652a/readme"
}