xyz.chainverdict/chainverdict

Official20 tools

by alexanderbalieu-connections · JavaScript

Pay-per-call x402 checks before an agent moves money: token safety, wallet risk, identifiers.

xyz.chainverdict/chainverdict (MCP) Server

The xyz.chainverdict/chainverdict MCP server performs pay-per-call x402 safety checks that gate actions before an agent moves money or trusts a counterparty. It focuses on token safety verdicts, wallet risk profiles, on-chain payment verification, financial-identifier validation, and live domain security posture.

🛠️ Key Features

Deterministic checks with no LLM inference
Token safety verdicts on Base
Wallet risk profiles and on-chain payment verification
Financial-identifier validation
Live domain security posture
Evidence records per response, including freshness, what is checked, and what it does not establish
Evidence is Ed25519-signed
20 tools exposed by the server

🚀 Use Cases

Pre-flight verification before transferring funds
Counterparty trust gating for autonomous agents
Validating payment details and identifiers on Base
Domain posture checks prior to trusting endpoints

⚡ Developer Benefits

No accounts, no API keys, and no signup
Paid per request in USDC on Base over x402
Signed evidence to support downstream audit and decisioning
Explicit statements about freshness and non-claims

⚠️ Limitations

Evidence “does not establish” broader guarantees beyond what the checks cover
Performs deterministic checks only; it does not use LLM inference

Captured live from the server via tools/list.

payment_info

Free. Explains how to call the paid tools on this server: the x402 protocol, the network and asset, the settlement address, and the price of every tool.

Parameters

No parameters.

Raw schema

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

token_verdict

Heuristic ERC-20 safety verdict on Base: bytecode risk capabilities, ownership, metadata, 0-100 score, hold/caution/avoid. $0.01 per call.

Parameters1

address

string

required

ERC-20 token contract address on Base (0x-prefixed, 42 chars)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "ERC-20 token contract address on Base (0x-prefixed, 42 chars)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

wallet_dossier

Profile of a Base address: EOA vs contract, balance, activity band, flags. $0.01 per call.

Parameters1

address

string

required

Base address to profile (0x-prefixed, 42 chars; EOA or contract)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Base address to profile (0x-prefixed, 42 chars; EOA or contract)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_iban

IBAN mod-97 checksum + country length rules. $0.001 per call.

Parameters1

iban

string

required

IBAN including 2-letter country prefix (e.g. DE89 3704 0044 0532 0130 00; spaces tolerated)

Raw schema

{
  "type": "object",
  "properties": {
    "iban": {
      "type": "string",
      "description": "IBAN including 2-letter country prefix (e.g. DE89 3704 0044 0532 0130 00; spaces tolerated)"
    }
  },
  "required": [
    "iban"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_vat

EU VAT format validation with deterministic checksums (DE, IT, LU, PL, SI). $0.001 per call.

Parameters1

vat

string

required

EU VAT number including country prefix (e.g. DE123456789, LU12345678)

Raw schema

{
  "type": "object",
  "properties": {
    "vat": {
      "type": "string",
      "description": "EU VAT number including country prefix (e.g. DE123456789, LU12345678)"
    }
  },
  "required": [
    "vat"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_bic

BIC/SWIFT structural validation and decomposition. $0.001 per call.

Parameters1

bic

string

required

BIC/SWIFT code, 8 or 11 characters (e.g. DEUTDEFF or DEUTDEFF500)

Raw schema

{
  "type": "object",
  "properties": {
    "bic": {
      "type": "string",
      "description": "BIC/SWIFT code, 8 or 11 characters (e.g. DEUTDEFF or DEUTDEFF500)"
    }
  },
  "required": [
    "bic"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

html_to_markdown

Convert raw HTML to clean Markdown. $0.002 per call.

Parameters1

html

string

required

Raw HTML string to convert (full document or fragment)

Raw schema

{
  "type": "object",
  "properties": {
    "html": {
      "type": "string",
      "description": "Raw HTML string to convert (full document or fragment)"
    }
  },
  "required": [
    "html"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

text_diff

Diff two texts (lines/words/chars). $0.002 per call.

Parameters3

a	string	required	Original text (left side of the diff)
b	string	required	Modified text (right side of the diff)
mode	string	optional	Diff granularity; defaults to lines

Raw schema

{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "description": "Original text (left side of the diff)"
    },
    "b": {
      "type": "string",
      "description": "Modified text (right side of the diff)"
    },
    "mode": {
      "description": "Diff granularity; defaults to lines",
      "type": "string",
      "enum": [
        "lines",
        "words",
        "chars"
      ]
    }
  },
  "required": [
    "a",
    "b"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_payment

Decode ERC-20 transfers in a Base transaction: amounts, counterparties, confirmations. $0.02 per call.

Parameters1

txhash

string

required

Base transaction hash to decode (0x-prefixed, 66 chars)

Raw schema

{
  "type": "object",
  "properties": {
    "txhash": {
      "type": "string",
      "description": "Base transaction hash to decode (0x-prefixed, 66 chars)"
    }
  },
  "required": [
    "txhash"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_token

Is this the real USDC/EURC/WETH/cbBTC/USDT on Base? Anti-phishing for stablecoin payments. $0.005 per call.

Parameters1

query

string

required

Token contract address (0x…) or symbol (e.g. USDC, WETH) to verify against the canonical Base list

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Token contract address (0x…) or symbol (e.g. USDC, WETH) to verify against the canonical Base list"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_lei

Legal Entity Identifier checksum validation. $0.002 per call.

Parameters1

lei

string

required

20-character Legal Entity Identifier (ISO 17442), e.g. 5299000J2N45DDNE4Y28

Raw schema

{
  "type": "object",
  "properties": {
    "lei": {
      "type": "string",
      "description": "20-character Legal Entity Identifier (ISO 17442), e.g. 5299000J2N45DDNE4Y28"
    }
  },
  "required": [
    "lei"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_isin

Securities identifier checksum validation. $0.001 per call.

Parameters1

isin

string

required

12-character International Securities Identification Number (ISO 6166), e.g. US0378331005

Raw schema

{
  "type": "object",
  "properties": {
    "isin": {
      "type": "string",
      "description": "12-character International Securities Identification Number (ISO 6166), e.g. US0378331005"
    }
  },
  "required": [
    "isin"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

security_email

Live DNS check of a domain's email authentication records. $0.01 per call.

Parameters2

domain	string	required	Domain to check, without scheme (e.g. example.com)
selector	string	optional	Optional DKIM selector to look up (e.g. google, default, s1)

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to check, without scheme (e.g. example.com)"
    },
    "selector": {
      "description": "Optional DKIM selector to look up (e.g. google, default, s1)",
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

security_tls

Live TLS handshake: cert validity, issuer, expiry countdown. $0.01 per call.

Parameters1

domain

string

required

Hostname to probe over TLS on port 443, without scheme (e.g. example.com)

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Hostname to probe over TLS on port 443, without scheme (e.g. example.com)"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

security_typosquat

Flags homoglyph and edit-distance look-alikes of known brands (c0inbase, b1nance, etc.). $0.005 per call.

Parameters2

domain	string	required	Domain to analyse for brand impersonation (e.g. c0inbase.com)
brands	string	optional	Optional comma-separated brand list to check against (defaults to a built-in set)

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to analyse for brand impersonation (e.g. c0inbase.com)"
    },
    "brands": {
      "description": "Optional comma-separated brand list to check against (defaults to a built-in set)",
      "type": "string"
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

data_gas

Live Base gas conditions: base fee, priority fees, congestion, est transfer cost. $0.002 per call.

Parameters

No parameters.

Raw schema

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

data_block

Latest block number, timestamp, tx count, gas utilization. $0.001 per call.

Parameters

No parameters.

Raw schema

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

data_token_supply

Total/circulating/burned supply and burn percentage for an ERC-20 on Base. $0.003 per call.

Parameters1

address

string

required

ERC-20 token contract address on Base (0x-prefixed, 42 chars)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "ERC-20 token contract address on Base (0x-prefixed, 42 chars)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

data_token_activity

Recent transfer count, volume, unique senders/receivers, activity level. $0.005 per call.

Parameters2

address	string	required	ERC-20 token contract address on Base (0x-prefixed, 42 chars)
blocks	number	optional	Look-back window in blocks (default 2000, ~1 hour on Base)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "ERC-20 token contract address on Base (0x-prefixed, 42 chars)"
    },
    "blocks": {
      "description": "Look-back window in blocks (default 2000, ~1 hour on Base)",
      "type": "number"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

data_portfolio

ETH + canonical token balances (USDC/WETH/cbBTC/EURC) for an address. $0.004 per call.

Parameters1

address

string

required

Base address to read balances for (0x-prefixed, 42 chars)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Base address to read balances for (0x-prefixed, 42 chars)"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md5 KBView on GitHub

ChainVerdict — chainverdict.xyz

Checks an autonomous agent runs before it moves money or trusts a counterparty: token safety verdicts and wallet risk profiles on Base, on-chain payment verification, financial-identifier validation, and live domain security posture.

Every call is paid per request in USDC on Base over the x402 protocol — no accounts, no API keys, no signup. Every response carries an evidence record saying what was checked, how fresh it is and what it does not establish, and is Ed25519-signed. No LLM inference anywhere: every answer is a deterministic computation or a live read of external state, so the same input returns the same answer forever.

MCP server

ChainVerdict is a remote MCP (Model Context Protocol) server, built on the official @modelcontextprotocol/sdk and served over Streamable HTTP at:

code

https://chainverdict.xyz/mcp

It is published in the official MCP registry as xyz.chainverdict/chainverdict.

initialize and tools/list are free, so registries and clients can index the server without paying.
tools/call is x402-paid at the price of the route behind the tool — except payment_info, which is free.
20 MCP tools, all read-only and idempotent, annotated with readOnlyHint / destructiveHint / idempotentHint / openWorldHint.
No MCP resources or prompts are exposed; this server is tools-only.

Tool descriptions interpolate the live price from the same map the payment middleware charges from, so tools/list can never advertise a rate that is not the rate. test/mcp-parity.test.js fails the build if a tool exists for a route that is no longer sold, or if a sold route has no tool.

Tools

Tool	What it answers
`payment_info`	Free. How x402 payment works, the price of every tool, where payments settle.
`token_verdict`	Is this ERC-20 on Base a scam, a honeypot, or safe to hold?
`wallet_dossier`	Wallet risk profile for a Base address before you pay it.
`verify_payment`	Decode and confirm an on-chain payment on Base.
`verify_token`	Resolve a symbol or address to the canonical Base token.
`validate_iban` `validate_vat` `validate_bic` `validate_lei` `validate_isin`	Deterministic check-digit and format validation.
`security_email` `security_tls` `security_typosquat`	SPF/DMARC/DKIM posture, live TLS probe, brand look-alike analysis.
`data_gas` `data_block` `data_token_supply` `data_token_activity` `data_portfolio`	Live Base chain reads.
`html_to_markdown` `text_diff`	Document utilities.

POST /v1/batch/validate is HTTP-only by design: 500 identifiers do not belong in a tool-call argument.

HTTP rate card

Every endpoint answers an unpaid request with a 402 quote.

Route	Price
`GET /v1/token/verdict/*`	$0.01
`GET /v1/wallet/dossier/*`	$0.01
`GET /v1/validate/iban/*`	$0.001
`GET /v1/validate/vat/*`	$0.001
`GET /v1/validate/bic/*`	$0.001
`POST /v1/doc/html-to-markdown`	$0.002
`POST /v1/doc/diff`	$0.002
`GET /v1/verify/payment/*`	$0.02
`GET /v1/verify/token/*`	$0.005
`GET /v1/validate/lei/*`	$0.002
`GET /v1/validate/isin/*`	$0.001
`POST /v1/batch/validate`	$0.10
`GET /v1/security/email/*`	$0.01
`GET /v1/security/tls/*`	$0.01
`GET /v1/security/typosquat/*`	$0.005
`GET /v1/data/gas`	$0.002
`GET /v1/data/block`	$0.001
`GET /v1/data/supply/*`	$0.003
`GET /v1/data/activity/*`	$0.005
`GET /v1/data/portfolio/*`	$0.004

Free to read before you pay for anything: / (discovery), /health, /openapi.json, /llms.txt, /v1/methodology, /.well-known/x402.json.

The whole portfolio, machine-readable: https://pulse.chainverdict.xyz/.well-known/portfolio.json

Local dev

bash

npm ci
X402_ENABLED=false npm start   # free mode, no payments
npm test                       # 34 tests

Ops

Stateless. No database, no cron, no maintained data set. Sources are pure arithmetic over public specifications plus live Base RPC.

Limitations

These are informational signals. None is a compliance control, none discharges a legal obligation, and none is regulated financial, legal or compliance advice. A valid signature proves a response came from this service unaltered — not that the answer is correct. A signed wrong answer is still wrong, and still signed.

Operated by Alexander Balieu, independent professional established in Luxembourg.

Licence

MIT. See LICENSE.

Install

Tools (20)

payment_infotoken_verdictwallet_dossiervalidate_ibanvalidate_vatvalidate_bichtml_to_markdowntext_diff

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://chainverdict.xyz/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "chainverdict": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://chainverdict.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

xyz.chainverdict/chainverdict (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

payment_info

token_verdict

wallet_dossier

validate_iban

validate_vat

validate_bic

html_to_markdown

text_diff

verify_payment

verify_token

validate_lei

validate_isin

security_email

security_tls

security_typosquat

data_gas

data_block

data_token_supply

data_token_activity

data_portfolio

ChainVerdict — chainverdict.xyz

MCP server

Tools

HTTP rate card

Local dev

Ops

Limitations

Licence

Install

Remote endpoint

Related servers