# Verdoc

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/verdochello/verdoc-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/verdoc

## Description
Deterministic AGENTS.md and repo analysis for coding agents, paid per call in USDC over x402.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "verdoc": {
    "command": "npx",
    "args": ["-y","verdoc"]
  }
}
```

## Documentation & README

# verdoc-mcp

Give your coding agent the context of a repository it has never seen, for two
cents, without an account or an API key.

An agent dropped into an unfamiliar codebase has to read it before it can work
in it - and that costs tens of thousands of tokens every time. `verdoc-mcp`
exposes two tools that answer the same questions directly:

| tool | what you get | price |
| --- | --- | --- |
| `verdoc_agents_md` | an `AGENTS.md` ready to commit | $0.02 |
| `verdoc_scan` | the same analysis as structured JSON | $0.01 |

Build and test commands are **quoted from the repository's own manifests**, with
the file each one came from named. Every path is checked against the git tree.
Anything ambiguous is marked `unverified` rather than guessed.

**No language model runs on the server.** The same commit always returns the
same answer.

## Install

**Easiest: download the [`.mcpb` bundle](https://github.com/verdochello/verdoc-mcp/releases/latest)**
and drag it into Claude Desktop, or point any MCPB-aware client at it
directly - dependencies are bundled inside, nothing to install separately.

Not on npm yet. Two other ways to install straight from this repository:

```json
{
  "mcpServers": {
    "verdoc": {
      "command": "npx",
      "args": ["-y", "github:verdochello/verdoc-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}
```

Or clone it and point at the file directly:

```bash
git clone https://github.com/verdochello/verdoc-mcp && cd verdoc-mcp && npm install
```

```json
{
  "mcpServers": {
    "verdoc": {
      "command": "node",
      "args": ["/absolute/path/to/verdoc-mcp/index.mjs"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}
```

Works with Claude Desktop, Claude Code, Cursor, or any MCP client.

**Without a key it still runs.** The tools report what they would cost and what
they would return, and buy nothing. That is the intended way to try it.

## Paying

The wallet needs **USDC on Base, Polygon or Arbitrum**. It does **not** need
ETH - x402 payments are signed off-chain and the facilitator pays the gas.

| variable | default | meaning |
| --- | --- | --- |
| `EVM_PRIVATE_KEY` | - | wallet that pays. Omit to run in quote-only mode. |
| `VERDOC_MAX_SPEND_USD` | `0.05` | hard per-call ceiling. Nothing above it is ever signed. |
| `VERDOC_ORIGIN` | `https://verdoc.dev` | override the endpoint (testing). |

### About that private key

You are handing a program the ability to spend your money, so here is exactly
what this one does and does not do.

- The key is read from the environment. It is **never logged, never written to
  disk, and never sent anywhere.** Error messages are scrubbed of anything that
  looks like a key before being returned.
- **The payee and the chain are pinned in the source.** Before signing anything,
  the client reads the live payment offer and checks it. If Verdoc ever asks to
  be paid at a different address, or on a chain not in the list, this **refuses
  and tells you** instead of paying. That means a compromise of our own domain
  or DNS cannot redirect your funds.
- Every call is capped by `VERDOC_MAX_SPEND_USD`, checked before a signature
  exists.

Use a wallet you funded for this purpose. That is good practice with any paying
agent tool, including this one.

## What it will refuse to do

These are tested in [`selftest.mjs`](https://github.com/verdochello/verdoc-mcp/blob/HEAD/selftest.mjs), and the refusals are the
part worth reading:

- pay an address other than the pinned one - even if the live endpoint asks
- pay on a chain outside the pinned set, including testnets
- pay more than your ceiling
- treat a short or empty 200 response as a real answer

## Limits

Public GitHub repositories only. Repositories over 20,000 tracked files are
rejected: GitHub truncates the git tree above that, and every claim this service
makes depends on having the complete tree.

## Licence

MIT. The service it calls is at [verdoc.dev](https://verdoc.dev) -
[OpenAPI](https://verdoc.dev/openapi.json) |
[x402 discovery](https://verdoc.dev/.well-known/x402)