Permit Verdicts

Working · 1.4 s

io.github.okwithit9-debug/permit-verdictsv0.3.0

Building-permit verdicts by address, with cited records. SF, Seattle, Austin, NYC. Pay per call.

Legal & Government Crypto & Web3

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://permit-api-production-7375.up.railway.app/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

attest_price_event Read-only

Settlement verdict plus a citable record: a signed decision_id, an integrity hash over the evidence, and every candle that determined the outcome. Use this 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, so anyone you show it to can authenticate it for free and re-check it for $0.02 without you supplying anything else. Paid: $0.25 in USDC via x402.

assetstring, required

Asset symbol, e.g. BTC, ETH, SOL

operatorstring, required

Comparison against the threshold

thresholdnumber, required

Price threshold in USD

tostring

ISO-8601 window end. Defaults to now.

fromstring

ISO-8601 window start. Defaults to 24h before `to`.

modestring

touch (default) or close

payment_headerstring

X-PAYMENT header from a settled x402 payment.

Tools (10)

attest_price_event

read-only

Argument	Type	Description
to	string	ISO-8601 window end. Defaults to now.
from	string	ISO-8601 window start. Defaults to 24h before `to`.
mode	string	touch (default) or close
asset*	string	Asset symbol, e.g. BTC, ETH, SOL
operator*	string	Comparison against the threshold
threshold*	number	Price threshold in USD
payment_header	string	X-PAYMENT header from a settled x402 payment.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "asset",
    "operator",
    "threshold"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "ISO-8601 window end. Defaults to now."
    },
    "from": {
      "type": "string",
      "description": "ISO-8601 window start. Defaults to 24h before `to`."
    },
    "mode": {
      "enum": [
        "touch",
        "close"
      ],
      "type": "string",
      "description": "touch (default) or close"
    },
    "asset": {
      "type": "string",
      "description": "Asset symbol, e.g. BTC, ETH, SOL"
    },
    "operator": {
      "enum": [
        "above",
        "at_or_above",
        "below",
        "at_or_below"
      ],
      "type": "string",
      "description": "Comparison against the threshold"
    },
    "threshold": {
      "type": "number",
      "description": "Price threshold in USD",
      "exclusiveMinimum": 0
    },
    "payment_header": {
      "type": "string",
      "description": "X-PAYMENT header from a settled x402 payment."
    }
  }
}

check_permit_activity

FREE. Quick check on whether a street address has building-permit activity on record: how many permits, how many are open, and when the last activity was. No permit detail and no verdict — use get_permit_verdict for those. Full paid feeds for humans: https://permitverdict.com/pricing

read-only

Argument	Type	Description
address*	string	Street address, e.g. '760 14th St'
jurisdiction*	string	Covered city, e.g. san_francisco

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jurisdiction",
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "minLength": 3,
      "description": "Street address, e.g. '760 14th St'"
    },
    "jurisdiction": {
      "enum": [
        "san_francisco",
        "seattle",
        "austin",
        "nyc",
        "chicago",
        "los_angeles",
        "new_orleans"
      ],
      "type": "string",
      "description": "Covered city, e.g. san_francisco"
    }
  }
}

decode_decision_id

FREE. Read what a Permit Verdict decision_id claims and check whether we actually issued it. The id is signed by the same wallet that receives payment, so forgery and after-the-fact editing are both detectable. Needs no payment. This tells you the record is genuine; it does NOT tell you the verdict is still correct — use verify_decision for that. Full paid feeds for humans: https://permitverdict.com/pricing

read-only

Argument	Type	Description
decision_id*	string	A decision_id of the form pv1.<payload>.<signature>

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "decision_id"
  ],
  "properties": {
    "decision_id": {
      "type": "string",
      "description": "A decision_id of the form pv1.<payload>.<signature>"
    }
  }
}

find_active_projects

FREE PREVIEW (5 results). Recently permitted construction projects in a covered city, filtered by declared budget. Use feed='investor' instead to surface expired and abandoned permits (stalled projects, often motivated owners). Full paid feeds for humans: https://permitverdict.com/pricing

read-only

Argument	Type	Description
days	integer	Lookback window, default 30
feed	string	contractor = newly filed/issued permits (default); investor = expired/stalled
max_cost	number	Maximum declared job value, 0 = no ceiling
min_cost	number	Minimum declared job value, default 50000
jurisdiction*	string	Covered city, e.g. san_francisco

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jurisdiction"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 180,
      "minimum": 1,
      "description": "Lookback window, default 30"
    },
    "feed": {
      "enum": [
        "contractor",
        "investor"
      ],
      "type": "string",
      "description": "contractor = newly filed/issued permits (default); investor = expired/stalled"
    },
    "max_cost": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum declared job value, 0 = no ceiling"
    },
    "min_cost": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum declared job value, default 50000"
    },
    "jurisdiction": {
      "enum": [
        "san_francisco",
        "seattle",
        "austin",
        "nyc",
        "chicago",
        "los_angeles",
        "new_orleans"
      ],
      "type": "string",
      "description": "Covered city, e.g. san_francisco"
    }
  }
}

get_crypto_spot

Live cross-venue spot price with venue agreement and spread. A wide spread means venues disagree and any settlement in that range is contestable. Paid: $0.01 in USDC via x402.

read-only

Argument	Type	Description
asset*	string	Asset symbol, e.g. BTC, ETH, SOL
payment_header	string	X-PAYMENT header from a settled x402 payment.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "Asset symbol, e.g. BTC, ETH, SOL"
    },
    "payment_header": {
      "type": "string",
      "description": "X-PAYMENT header from a settled x402 payment."
    }
  }
}

get_permit_verdict

Address-level building-permit intelligence for a covered city: normalized permit history + activity signals + a decision-ready verdict with cited public records. Paid: $2.00 in USDC on base via x402.

read-only

Argument	Type	Description
address*	string	Street address, e.g. '760 14th St'
jurisdiction*	string	Covered city, e.g. san_francisco
payment_header	string	Optional X-PAYMENT header value from a completed x402 payment. Omit on first call to receive payment requirements.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jurisdiction",
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "minLength": 3,
      "description": "Street address, e.g. '760 14th St'"
    },
    "jurisdiction": {
      "enum": [
        "san_francisco",
        "seattle",
        "austin",
        "nyc",
        "chicago",
        "los_angeles",
        "new_orleans"
      ],
      "type": "string",
      "description": "Covered city, e.g. san_francisco"
    },
    "payment_header": {
      "type": "string",
      "description": "Optional X-PAYMENT header value from a completed x402 payment. Omit on first call to receive payment requirements."
    }
  }
}

list_jurisdictions

List cities covered by the Permit Intelligence API, with pricing and payment details. Free. Full paid feeds for humans: https://permitverdict.com/pricing

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_settlement_assets

FREE. Which crypto assets, venues, operators and modes the settlement oracle supports, plus pricing. Full paid feeds for humans: https://permitverdict.com/pricing

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

resolve_price_event

Settlement verdict for a crypto price event. Answers 'did this asset trade or close above/below a threshold during a window?' with YES/NO/DISPUTED/UNRESOLVED, per-venue evidence from Hyperliquid, Coinbase and Kraken, and stated confidence. (Binance is configured but blocks this host's region; it is reported unavailable rather than silently counted.) Use mode='close' when a market settles on candle closes and mode='touch' when any intrabar print counts — they give different answers and that difference is the most common settlement dispute. Paid: $0.05 in USDC via x402.

read-only

Argument	Type	Description
to	string	ISO-8601 window end. Defaults to now.
from	string	ISO-8601 window start. Defaults to 24h before `to`.
mode	string	touch = any intrabar print counts (default); close = only candle closes count
asset*	string	Asset symbol, e.g. BTC, ETH, SOL
operator*	string	Comparison against the threshold
threshold*	number	Price threshold in USD
payment_header	string	X-PAYMENT header from a settled x402 payment. Omit on first call to receive payment requirements.

verify_decision

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, but only a fresh resolution proves it is still true. Exchanges revise candle history, and a venue that was unreachable at issue time may answer differently now. Paid: $0.02 in USDC via x402 — cheaper than resolving fresh because you are checking someone else's answer rather than buying a new one.

read-only

Argument	Type	Description
decision_id*	string	A decision_id issued by /v1/oracle/attest
payment_header	string	X-PAYMENT header from a settled x402 payment. Omit on first call to receive payment requirements.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "decision_id"
  ],
  "properties": {
    "decision_id": {
      "type": "string",
      "description": "A decision_id issued by /v1/oracle/attest"
    },
    "payment_header": {
      "type": "string",
      "description": "X-PAYMENT header from a settled x402 payment. Omit on first call to receive payment requirements."
    }
  }
}