Permitverdict MCP server

permitverdict-mcp

MCP server for Permit Verdict. Eleven tools, six of them free. The paid ones cost between one cent and two dollars per call and pay themselves, in USDC on Base, using the x402 protocol.

There is no API key, no account, and no signup. If you have a funded wallet, you have access.

What it sells

Settlement Oracle — did a crypto price event actually happen? Every verdict is resolved independently across Hyperliquid, Coinbase and Kraken. (Binance is configured but returns 451 to the host's region, so it is reported unavailable rather than silently counted — three venues we can reach beats four we cannot.) When the venues agree you get YES or NO at high confidence. When they disagree you get DISPUTED at low confidence, because a wick that prints on one exchange and not another is the single most common reason a market settles the wrong way, and a confident answer in that situation is worse than no answer.

Permit Intelligence — building-permit history, activity signals, and a decision-ready verdict for an address, drawn from official city open-data portals across seven US cities.

Install

{
  "mcpServers": {
    "permitverdict": {
      "command": "npx",
      "args": ["-y", "permitverdict-mcp"]
    }
  }
}

That works immediately, with no wallet. You get the six free tools.

To enable the paid tools, add a wallet:

{
  "mcpServers": {
    "permitverdict": {
      "command": "npx",
      "args": ["-y", "permitverdict-mcp"],
      "env": { "WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY" }
    }
  }
}

Fund it with a few dollars of USDC on Base. You do not need any ETH — gas is sponsored by the x402 facilitator, so only USDC is ever spent.

Tools

Free tools first is deliberate. checkvenuehealth tells you how many independent venues are live before you spend anything, so you know whether the verdict you are about to buy will be corroborated by three sources or one.

Attestations, and why verifying one is cheap

attestpriceevent returns a decision_id that is worth keeping. It is not a database key — everything needed to re-derive the answer is encoded inside it, and it is signed by the same wallet that received your payment. That has two consequences.

Anyone you show it to can check its origin for free with decodedecisionid. Forgery and after-the-fact editing are both detectable, and it costs nobody anything, because checking a signature is local arithmetic. You can also do it yourself with any EVM tooling: the signature covers the literal string formed by the id's first two dot-separated parts, and it should recover to 0xE11d7Ff8c7573b15F9F6F6d4961Afb4109d3ddA5.

Shortened. The full README is on GitHub.