Skip to main content
Glama
permitverdict-mcp

permitverdict-mcp

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

wallet_status

free

Whether a wallet is configured, and its address

list_settlement_assets

free

Assets, venues, operators and modes the oracle supports

check_venue_health

free

Which venues are answering right now

decode_decision_id

free

Is this attestation genuine, and what does it claim?

list_jurisdictions

free

Cities covered by permit intelligence

check_permit_activity

free

Whether an address has recent permit activity

get_crypto_spot

$0.01

Cross-venue spot price, agreement and spread

verify_decision

$0.02

Does an attested settlement still hold today?

resolve_price_event

$0.05

Settlement verdict with per-venue evidence

attest_price_event

$0.25

The verdict plus a signed decision_id and every candle behind it

get_permit_verdict

$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 test

The 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 tools
attest_price_eventA
Read-onlyIdempotent
Inspect

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_activityA
Read-onlyIdempotent
Inspect

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_healthA
Read-onlyIdempotent
Inspect

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_idA
Read-onlyIdempotent
Inspect

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_spotA
Read-onlyIdempotent
Inspect

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_verdictA
Read-onlyIdempotent
Inspect

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_jurisdictionsB
Read-onlyIdempotent
Inspect

FREE. Cities covered by the permit intelligence API, with pricing and payment details.

Inputs: no named parameters.

list_settlement_assetsA
Read-onlyIdempotent
Inspect

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_eventA
Read-onlyIdempotent
Inspect

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_decisionA
Read-onlyIdempotent
Inspect

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_statusA
Read-onlyIdempotent
Inspect

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

    A4.2/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      23
      75 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Pay-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.
      28
      1
      MIT