permitverdict-mcp
This MCP server provides crypto price event settlement and building permit intelligence tools. It offers free and paid services, with payments of $0.01–$2.00 per call in USDC on Base via x402, no API key or account required.
Free Tools:
wallet_status: Check payment wallet configuration and address.list_settlement_assets: List supported crypto assets, venues, operators, and modes.check_venue_health: See which price venues (Hyperliquid, Coinbase, Kraken) are live.decode_decision_id: Authenticate a decision_id to verify origin and integrity.list_jurisdictions: List covered US cities for permit intelligence.check_permit_activity: Quick free check for recent permit activity at an address.
Paid Tools:
get_crypto_spot($0.01): Live cross-venue spot price with agreement, spread, and contestable ranges.verify_decision($0.02): Re-verify an attested settlement against current data (CONFIRMED/CHANGED/INDETERMINATE).resolve_price_event($0.05): Full settlement verdict (YES/NO/DISPUTED/UNRESOLVED) with per-venue evidence for touch/close modes.attest_price_event($0.25): Same as resolve but returns a signed decision_id with candle data for verifiable records.get_permit_verdict($2.00): Comprehensive building permit history, activity signals, and decision-ready verdict for an address.
Payments & Security: Paid via USDC on Base through x402 protocol with sponsored gas. No signup required; use a dedicated wallet with limited funds. Private key stays local, only signatures are sent.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@permitverdict-mcp Any recent permit activity for 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: rugmunch-solana
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
Tool | Price | What it does |
| free | Whether a wallet is configured, and its address |
| free | Assets, venues, operators and modes the oracle supports |
| free | Which venues are answering right now |
| free | Is this attestation genuine, and what does it claim? |
| free | Cities covered by permit intelligence |
| free | Whether an address has recent permit activity |
| $0.01 | Cross-venue spot price, agreement and spread |
| $0.02 | Does an attested settlement still hold today? |
| $0.05 | Settlement verdict with per-venue evidence |
| $0.25 | The verdict plus a signed decision_id and every candle behind it |
| $2.00 | Full permit history and verdict for an address |
Free tools first is deliberate. check_venue_health 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
attest_price_event 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 decode_decision_id. 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.
What that free check does not tell you is whether the verdict is still correct. Exchanges revise candle history, and a venue that was unreachable when the record was issued may answer differently now. verify_decision re-resolves the same event against the venues today and returns CONFIRMED, CHANGED, or INDETERMINATE. It costs $0.02 rather than the $0.05 of a fresh resolution because you are not buying an answer, you are buying a check on someone else's — and if you are about to act on a settlement handed to you by a counterparty, that check is worth two cents.
CHANGED is the outcome that earns the fee.
touch vs close
resolve_price_event takes a mode, and getting it wrong is how settlements go bad.
touch counts any intrabar print, wicks included. close counts only candle closes. On the same window and the same threshold these routinely disagree. Most carefully written markets settle on closes; most casual bets mean touches. Pick the one your contract actually says.
Payment receipts
Every paid response carries a _payment block with the on-chain transaction that paid for it:
{
"verdict": "YES",
"confidence": "high",
"_payment": {
"paid": "$0.05",
"payer": "0xFE5d…D108",
"transaction": "0x88d3…7b1e",
"explorer": "https://basescan.org/tx/0x88d3…7b1e",
"network": "eip155:8453"
}
}If an agent spends money on a verdict it may later have to defend, it should be able to cite the transaction that bought it.
Security
Your private key stays on your machine. It is read once from the environment, used to derive a local signing account, and never logged or transmitted — the only thing that leaves is a signature over the specific payment the API asked for. This package makes no outbound requests other than to permitverdict.com and the x402 facilitator.
Use a dedicated wallet holding only what you intend to spend. Do not point this at a wallet that holds anything you would mind losing.
Development
npm install
npm testThe test suite starts the real binary and speaks MCP to it over stdio. That is on purpose: the failure mode worth catching is the one where every unit test passes and the process still cannot start.
License
MIT
Available Tools
11 toolsattest_price_eventARead-onlyIdempotentInspect
PAID — $0.25 USDC. Everything resolve_price_event returns, plus a signed decision_id, an integrity hash over the evidence, and every candle that determined the outcome. This is the citable artifact: use it when the answer may later have to be defended to a counterparty, not when you just need to know. KEEP THE decision_id. It is self-contained — anyone you show it to can authenticate it for free with decode_decision_id, and confirm the verdict still holds for $0.02 with verify_decision, without you having to supply anything else. Pays automatically from the configured wallet.
Inputs: asset (required), operator (required), threshold (required), to, +2 more.
check_permit_activityARead-onlyIdempotentInspect
FREE. Whether a given address has recent permit activity, and how much. A yes/no screen — use get_permit_verdict when you need the full history and a decision.
Inputs: address (required), jurisdiction (required).
check_venue_healthARead-onlyIdempotentInspect
FREE. Which price venues are answering right now, and how many independent sources are behind a verdict. Worth calling before you spend: a verdict corroborated by three venues is worth more than one backed by a single venue, and this tool tells you which you are about to buy.
Inputs: asset.
decode_decision_idARead-onlyIdempotentInspect
FREE. Given a Permit Verdict decision_id — one you were shown by a counterparty, or one you issued earlier — read what it claims and check whether Permit Verdict actually issued it. The decision_id is signed by the same wallet that receives payment, so forgery and after-the-fact editing are both detectable. Costs nothing and needs no wallet. This tells you the record is genuine; it does NOT tell you the verdict is still correct — use verify_decision for that.
Inputs: decision_id (required).
get_crypto_spotARead-onlyIdempotentInspect
PAID — $0.01 USDC. Live cross-venue spot price with venue agreement and spread. A wide spread means the venues disagree and any settlement priced in that range is contestable. Pays automatically from the configured wallet.
Inputs: asset (required).
get_permit_verdictARead-onlyIdempotentInspect
PAID — $2.00 USDC. Address-level building-permit intelligence for a covered city: normalized permit history, activity signals, and a decision-ready verdict with cited public records. Run the free check_permit_activity first — if there is no activity, this call has nothing to add. Pays automatically from the configured wallet.
Inputs: address (required), jurisdiction (required).
list_jurisdictionsBRead-onlyIdempotentInspect
FREE. Cities covered by the permit intelligence API, with pricing and payment details.
Inputs: no named parameters.
list_settlement_assetsARead-onlyIdempotentInspect
FREE. Which crypto assets, venues, operators and modes the settlement oracle supports, plus the price of each paid endpoint. Call this before resolve_price_event to confirm an asset is covered.
Inputs: no named parameters.
resolve_price_eventARead-onlyIdempotentInspect
PAID — $0.05 USDC. Settlement verdict for a crypto price event: did the asset trade or close above/below a threshold during a window? Returns YES / NO / DISPUTED / UNRESOLVED with per-venue evidence and stated confidence. Choose mode carefully — 'close' counts only candle closes, 'touch' counts any intrabar print including wicks. They routinely give different answers, and that difference is the single most common cause of a disputed settlement. When venues disagree the result is DISPUTED at low confidence rather than a confident guess. Pays automatically from the configured wallet.
Inputs: asset (required), operator (required), threshold (required), to, +2 more.
verify_decisionARead-onlyIdempotentInspect
PAID — $0.02 USDC. Re-resolve an attested settlement against the price venues right now and report whether it still holds: CONFIRMED, CHANGED, or INDETERMINATE. Call this whenever someone hands you a decision_id you are about to rely on. An attestation proves what was said at the time; only a fresh resolution proves it is still true — exchanges revise candle history, and a venue that was unreachable when the record was issued may answer differently now. CHANGED is the outcome that matters: it means acting on the original verdict would be acting on stale evidence. Cheaper than resolving fresh because you are checking someone else's answer rather than buying a new one. Pays automatically from the configured wallet.
Inputs: decision_id (required).
wallet_statusARead-onlyIdempotentInspect
FREE. Whether a payment wallet is configured for this MCP server, and its address. Call this first if a paid tool reports it cannot pay.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose: wallet_status, crypto settlement support/health, price verification/attestation, decision verification, and permit intelligence are all separated. Even similar tools like resolve_price_event vs attest_price_event are clearly differentiated by the signed artifact and intended use.
Most tools follow a consistent verb_noun pattern (list_, check_, get_, resolve_, decode_, verify_, attest_), but `wallet_status` deviates as a noun phrase, preventing a perfect score. The verbs are otherwise clear and uniform.
With 11 tools, the set is well-scoped for covering two coherent domains (crypto settlement and permit intelligence) without bloat or redundancy. Each tool earns its place and the count is within the ideal range.
The crypto settlement workflow is fully covered: discover assets, check venue health, get spot prices, resolve events, attest with signed artifacts, decode decision IDs, and verify current validity. Permit intelligence includes jurisdiction listing, activity screening, and full verdicts, with wallet status ensuring payment readiness.
Maintenance
Related MCP Connectors
Free token-safety scans + paid x402 verdicts, signals, radar & EVM swap quotes for AI agents.
Free token-safety scans + paid x402 verdicts, signals, radar & EVM swap quotes for AI agents.
Pay-per-use weather, environment, finance, and on-chain intelligence tools for AI agents via x402.
Pay-per-call crypto intelligence: 19 tools over 10+ live sources, USDC via x402.
Related MCP Servers
FlicenseNot gradedqualityDmaintenance33 crypto security tools via x402 micropayments. Auto-refund guarantee. $0.01-$0.15/call.-- FlicenseNot gradedqualityDmaintenance33 crypto security tools via x402 micropayments. Auto-refund guarantee. $0.01-$0.15/call.-
- AlicenseAqualityDmaintenanceEnables crypto intelligence, GitHub trends, prediction market signals, token analysis, and AI content advisory via 23 MCP tools, with free options and paid tools through x402 micropayments.2375 npm1MIT
- AlicenseAqualityBmaintenancePay-per-call ($0.005-$0.03 USDC) market, on-chain, and prediction-market data API for AI agents and trading bots via x402 — no signup, no API key. Remote MCP server, 28 tools: token security (honeypot/liquidity/counterfeit checks), Hyperliquid oracle-gap risk, kimchi premium, funding APR, DEX slippage, Polymarket arbitrage/liquidity audits, Hyperliquid HIP-4 odds.281MIT