X420 MCP Server
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., "@X420 MCP Server run a website audit for https://example.com"
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.
x420-mcp
Model Context Protocol server for X420's pay-per-call agent services at https://signature-theme.com: website audits, hail and storm history, geocoding, DNS/TLS/RDAP lookups, government and chain data, and whatever X420 sells next. Every service becomes an MCP tool; every paid call is settled with x402 in USDC on Base from your own wallet.
X420 never sees your key. The private key is read from your environment inside this local process, signs an
EIP-3009 USDC authorization, and only that signature leaves the machine (as the PAYMENT-SIGNATURE header). It is
never logged, never written to disk by this package, and never sent to X420 or anyone else.
This spends real money. A successful paid call moves USDC on Base mainnet. Fund a dedicated wallet with only what
you are willing to spend, keep X420_MCP_MAX_USD low, and rotate the key when you stop using the server.
Install
npx x420-mcpThe server speaks MCP on stdin/stdout. On start it fetches the live catalog (GET https://signature-theme.com/a2a/catalog)
and registers one tool per service, named x420_<id> with dots replaced by underscores (sitescan.check →
x420_sitescan_check, hail.point-history → x420_hail_point-history), plus two free tools:
x420_catalog— the live catalog with prices, inputs and deliverables.x420_quote— a free price quote for one service and input (no order is placed).x420_spend_summary— what this server process has paid so far (calls, total USD, last-24h USD, the caps and what remains under each, the verified seller pay-to address).
Nothing is hard-coded: new X420 services appear on the next start.
Claude Desktop
claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"x420": {
"command": "npx",
"args": ["-y", "x420-mcp"],
"env": {
"X420_MCP_WALLET_PRIVATE_KEY": "0x<your private key>",
"X420_MCP_MAX_USD": "1.00"
}
}
}
}Claude Code
claude mcp add x420 -e X420_MCP_WALLET_PRIVATE_KEY=0x<your private key> -e X420_MCP_MAX_USD=1.00 -- npx -y x420-mcpCursor
.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"x420": {
"command": "npx",
"args": ["-y", "x420-mcp"],
"env": {
"X420_MCP_WALLET_PRIVATE_KEY": "0x<your private key>",
"X420_MCP_MAX_USD": "1.00"
}
}
}
}Without a key the server still starts: the free tools work and every paid tool returns an error explaining how to set the key. Nothing is spent until a key is present.
Related MCP server: NEX Agent Co. MCP Server
Environment
Variable | Default | Meaning |
| unset | 0x-prefixed private key of the paying wallet (USDC on Base). Unset = paid tools refuse with instructions. Never logged, never sent. |
|
| Per-call cap in USD. A service priced above it is refused before any request; a 402 asking for more than it is refused before signing. At the default, |
|
| Lifetime cap for the server process: the sum of all paid calls since it started may not exceed this. |
|
| Rolling 24-hour cap: the sum of paid calls in the last 24 hours may not exceed this. |
|
| The X420 seller to talk to. |
|
| CAIP-2 network the payer will sign on; a 402 on any other network is refused. |
Default caps
Out of the box the server pays at most $1.00 per call, $5.00 per rolling 24 hours and $5.00 over the life of the process. Two X420 services cost more than $1.00 and are therefore refused at the default:
Service | Price | At the default cap |
| $3.00 | refused ("above the per-call cap X420_MCP_MAX_USD=$1.00") |
| $7.00 | refused ("above the per-call cap X420_MCP_MAX_USD=$1.00") |
To allow them, raise the per-call cap in the server's env (and the daily/lifetime caps if several calls are planned):
"env": {
"X420_MCP_WALLET_PRIVATE_KEY": "0x<your private key>",
"X420_MCP_MAX_USD": "7",
"X420_MCP_MAX_DAILY_USD": "25",
"X420_MCP_MAX_TOTAL_USD": "25"
}Every refusal names the cap that blocked it, for example
refused by X420_MCP_MAX_DAILY_USD=$5.00: paying $0.50 for sitescan.check would bring rolling 24h spend to $5.25 (spent $4.75 across 9 paid calls so far).
x420_spend_summary shows the running totals at any time.
What the server will and will not sign
Before signing anything the payer checks the seller's 402 against fixed rules; any mismatch refuses and nothing is signed:
scheme
exacton the configured network only (X420_MCP_NETWORK, defaulteip155:8453);the asset must be that network's canonical USDC contract, compared as an address (Base
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, Base Sepolia0x036CbD53842c5426634e7929541eC2318f3dCF7e) — a token that merely calls itself "USD Coin" is refused;payTomust equal the address the seller advertises in its Agent Card (/.well-known/agent.json,payments.pay_to), fetched when the server starts; if the card cannot be read, paid tools refuse rather than pay an unverified recipient;the amount must be within
X420_MCP_MAX_USD, and must keep the process underX420_MCP_MAX_TOTAL_USDandX420_MCP_MAX_DAILY_USD.
How a paid call works
The tool call becomes
GET <origin>/a2a/x402/<service id>?<params>.X420 answers
402with an x402 v2PAYMENT-REQUIREDheader (exact scheme, USDC on Base, amount, pay-to).The server checks scheme, network, asset and amount against your cap, signs the authorization with your key (
@x402/fetch+@x402/evm), and retries withPAYMENT-SIGNATURE.X420's facilitator settles on Base and X420 returns the deliverable with a signed receipt; the tool result carries the deliverable, the receipt, the order and the settlement transaction hash from
PAYMENT-RESPONSE.
{
"service": "sitescan.check",
"price_usd": 0.5,
"paid_usd": 0.5,
"deliverable": { "target": "https://example.com", "summary": { "score": 82, "grade": "B", "findings": 3 }, "findings": [] },
"receipt": { "receipt_id": "...", "deliverable_sha256": "...", "payee": "x420:...", "sig": "<ed25519 hex>" },
"order": { "id": "...", "status": "delivered", "amount_usd": 0.5, "rail": "x402" },
"settlement": { "transaction": "0x...", "network": "eip155:8453", "payer": "0x...", "success": true, "error": null }
}A refused call (no key, over the cap, wrong network, non-USDC asset, missing input) returns an MCP error result with the reason, and nothing is signed.
No key? Use the hosted endpoint
X420 also serves the same tools over MCP Streamable HTTP at https://signature-theme.com/mcp. That endpoint holds
no wallet: x420_catalog and x420_quote work as above, and each paid tool validates your input and returns
payment instructions (price, pay-to address, network and the x402 URL) instead of the deliverable, so an agent with
its own x402 client can pay directly.
claude mcp add --transport http x420 https://signature-theme.com/mcpProgrammatic use
import { createX420McpServer } from "x420-mcp";
const { server, tools } = await createX420McpServer({ origin: "https://signature-theme.com", maxUsd: 1, privateKey: process.env.X420_MCP_WALLET_PRIVATE_KEY ?? null });x420-mcp/hosted exports createHostedMcpHandler({ origin }), the express-compatible stateless Streamable HTTP
handler behind the hosted endpoint.
Disclaimer
Automated services on public data; not professional, legal, insurance, engineering, medical, financial or tax advice.
MIT License. Source: https://github.com/BodhiNath/x420-mcp (packages/x420-mcp, built from src/mcp).
Available Tools
38 toolsx420_catalogARead-only
Free. Fetches X420's live service catalog from https://signature-theme.com/a2a/catalog: every service with its id, price in USD, input parameters and deliverable. Use it to see what the x420_* tools cost before calling one.
Inputs: no named parameters.
x420_chain_gas-estimateA
Base gas estimate: Current Base mainnet gas price, EIP-1559 fee estimate and base fee, reference costs for an ETH transfer and a typical ERC-20 transfer, and optionally an estimateGas for a call you describe (to, value, data). Source: Base mainnet RPC. L1 data fee not included. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: gas_price_gwei, max_fee_per_gas_gwei, base_fee_gwei, reference{eth_transfer, erc20_transfer_typical}, requested{estimate} - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {}.
Inputs: to, data, from, value_eth.
x420_chain_proof-of-paymentA
Base proof of payment: Verifies a Base mainnet transaction hash as a token payment: receipt status, block time, confirmations, every ERC-20 Transfer it emitted for the token (USDC by default), and pass/fail checks against an expected recipient and minimum amount. Source: Base mainnet RPC. Not a settlement guarantee. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.10 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: status, block, block_time, confirmations, transfers[{from, to, amount}], checks{}, verified - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"tx_hash":"0x9f2c6c1e7b3a4d5e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9012345678abcd","expected_to":"0x7C2E8c5D2F1bc1f0Cc6B7e3E4C2a1b9D8e7F6A5B","expected_amount":"0.10"}.
Inputs: tx_hash (required), token, expected_to, expected_amount, +1 more.
x420_chain_token-metadataA
Base token metadata: name, symbol, decimals and totalSupply of an ERC-20 contract on Base mainnet, read from the contract through the public RPC. Source: Base mainnet RPC. Says nothing about legitimacy. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: address, name, symbol, decimals, total_supply - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}.
Inputs: token (required).
x420_chain_wallet-balanceA
Base wallet balance: ETH and USDC balance of an address on Base mainnet at the current block, plus any one ERC-20 you name, read through the public RPC (free, no key). Source: Base mainnet RPC. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: block, eth{wei, ether}, usdc{atomic, amount}, token{symbol, amount} - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"address":"0x4200000000000000000000000000000000000006"}.
Inputs: address (required), token.
x420_csv_to-jsonA
CSV to JSON: Parses RFC 4180 CSV (quotes, escaped quotes, embedded newlines, custom delimiter) into JSON rows keyed by header, with optional number/boolean inference. Up to 500 KB and 10,000 rows. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.01 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: columns[], row_count, total_rows, truncated, ragged_rows, rows[] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"text":"name,sqft,hail\nSmith,2400,true\n"Jones, R",1800,false"}.
Inputs: text (required), header, max_rows, delimiter, +1 more.
x420_currency_convertA
Currency converter (ECB rates): Converts an amount between ~30 major fiat currencies using European Central Bank daily reference rates (frankfurter.dev, free, no key), latest or for a past date. Source: ECB via api.frankfurter.dev. Reference rates, not a dealable quote. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: amount, from, to, rate, result, date, source - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"amount":"100","from":"USD","to":"EUR"}.
Inputs: to (required), from (required), date, amount.
x420_dns_lookupA
DNS lookup: Resolves A, AAAA, MX, TXT, NS or CNAME records (or all six) for a hostname through this host's resolver (node:dns). Source: live DNS. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: name, records{TYPE: []}, errors, resolved_at - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"name":"example.com","type":"all"}.
Inputs: name (required), type.
x420_domain_rdapA
Domain registration (RDAP): Registration, expiry and last-changed dates, status flags, nameservers, registrar and DNSSEC for a domain from the registry's RDAP service (IANA bootstrap via rdap.org, free, no key). Source: registry RDAP. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.03 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: registered, registration_date, expiration_date, days_to_expiry, status[], nameservers[], registrar, dnssec, source - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"domain":"example.com"}.
Inputs: domain (required).
x420_evidence_timestampA
Evidence fingerprint and timestamp: sha256 / sha512 / keccak256 of supplied text or base64 bytes with the provider's ISO time and a statement of observation, delivered under the agent's ed25519-signed receipt. On-chain anchoring is a separate paid step. Not a notarisation or legal timestamp. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.01 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: sha256, sha512, keccak256, bytes, observed_at, statement, note - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"text":"Roof inspection photo set 2026-11-07, 14 files","label":"claim 4471 photos"}.
Inputs: text, label, base64.
x420_geo_distanceA
Distance and bearing: Great-circle distance (km, mi, nmi, m) and initial bearing between two coordinates. Pure computation. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.01 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: km, mi, nmi, m, bearing_deg, compass - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat1":"32.7357","lon1":"-97.1081","lat2":"32.7767","lon2":"-96.797"}.
Inputs: lat1 (required), lat2 (required), lon1 (required), lon2 (required).
x420_geo_elevationA
Elevation at a point: Ground elevation at a coordinate from the USGS 3D Elevation Program point query service (free, no key). Source: USGS 3DEP EPQS. US coverage; a DEM sample, not a survey. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: elevation, units, resolution_m, raster_id - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat":"32.7357","lon":"-97.1081"}.
Inputs: lat (required), lon (required), units.
x420_geo_flood-zoneA
FEMA flood zone at a point: Flood hazard zone(s) intersecting a coordinate from FEMA's National Flood Hazard Layer (layer 28, free, no key): zone code, subtype, SFHA flag, static BFE. Source: FEMA NFHL. Not an official flood zone determination. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.05 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: mapped, in_sfha, zones[{zone, subtype, sfha, static_bfe_ft, dfirm_id}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat":"32.7555","lon":"-97.3286"}.
Inputs: lat (required), lon (required).
x420_geo_geocodeA
Geocode US address: Street address → coordinates and parsed components using the US Census Bureau Geocoder (free, no key). Source: US Census Bureau. US addresses only; street-segment interpolation, not rooftop. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.03 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: match_count, matches[{matched_address, lat, lon, components}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"address":"1600 Pennsylvania Ave NW, Washington, DC 20500"}.
Inputs: address (required).
x420_geo_reverse-geocodeA
Reverse geocode (US geographies): Coordinates → state, county, place, metro area, census tract and block GEOIDs from the US Census Bureau Geocoder (free, no key). Source: US Census Bureau. Returns administrative geographies, not a street address; US only. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.03 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: in_us, state{name,fips,usps}, county, place, combined_statistical_area, urban_area, tract_geoid, block_geoid - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat":"32.7357","lon":"-97.1081"}.
Inputs: lat (required), lon (required).
x420_gov_federal-registerA
Federal Register search: Full-text search of Federal Register documents (rules, proposed rules, notices, presidential documents) newest first, with abstracts and links, from the Federal Register API (free, no key). Source: federalregister.gov. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.03 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: total, count, results[{document_number, title, type, publication_date, agencies, abstract, html_url, pdf_url}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"term":"roofing","per_page":"1"}.
Inputs: term (required), type, agency, per_page.
x420_gov_sec-edgar-companyA
SEC EDGAR company lookup: Finds an SEC registrant by ticker, name or CIK and returns its EDGAR profile (SIC, state, exchanges, filer category, business address) with its most recent filings and document links, from SEC EDGAR (free, no key). Source: SEC EDGAR. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.05 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: matches[], company{cik, name, tickers, sic_description, state_of_incorporation, ...}, recent_filings[{form, filed, accession, url}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"query":"OC","filings":"1"}.
Inputs: query (required), filings.
x420_gov_usaspending-awardsA
Federal awards search (USAspending): Keyword search of US federal contracts, grants, loans or IDVs for a fiscal year, optionally filtered to one awarding agency, sorted by amount, from the USAspending.gov API (free, no key). Source: USAspending.gov. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.05 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: count, has_more, awards[{award_id, recipient, amount_usd, awarding_agency, start_date, end_date, description, url}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"keyword":"roofing","award_type":"contracts","fiscal_year":"2026","limit":"1"}.
Inputs: keyword (required), limit, agency, award_type, +1 more.
x420_hail_point-historyA
Hail point history: Radar-detected hail signatures within a radius of a coordinate over the last N days (NOAA SWDI nx3hail). For roofing, claims and property agents that need a quick storm screen. PAID: $0.25 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: detections, max size, days with hail, source URL - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat":"32.7357","lon":"-97.1081","radius_km":"5","days":"30"}.
Inputs: lat (required), lon (required), days, radius_km.
x420_hash_digestA
Hash digest: sha256 / sha512 / sha1 / md5 / keccak256 of supplied text or base64 bytes. Pure computation, nothing stored. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.01 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: algorithm, bytes, digests{alg: hex} - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"text":"hello","algorithm":"all"}.
Inputs: text, base64, algorithm.
x420_http_endpoint-checkA
HTTP endpoint check: One GET or HEAD to a public URL: status, latency, redirects (each hop re-checked), final URL and the security/caching headers. Private and internal addresses are refused. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: status, ok, latency_ms, redirects, final_url, https, headers{} - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"url":"https://example.com/"}.
Inputs: url (required), method.
x420_id_generateA
ID generator: Generates UUID v4, time-ordered UUID v7, or ULID identifiers (1–100 per call) from the runtime CSPRNG. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.01 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: kind, count, generated_at, ids[] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"kind":"ulid","count":"2"}.
Inputs: kind, count.
x420_quoteARead-only
Free. Asks X420 for a price quote (POST https://signature-theme.com/a2a/quote) for one service and input: amount in USD, currency, rail, pay-to address, nonce and expiry. A quote costs nothing and does not place an order.
Inputs: service (required), rail, input.
x420_research_pubmedA
PubMed literature search: Searches PubMed (NCBI E-utilities, free, no key) and returns up to 20 bibliographic records: title, authors, journal, date, PMID, DOI and links. Source: NCBI PubMed. Citations only, no abstracts; not medical advice. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.05 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: total, count, results[{pmid, title, authors, journal, pubdate, doi, url}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"query":"hail storm injury","max":"1"}.
Inputs: query (required), max, min_year.
x420_sitescan_basicA
SiteScan Basic: Technical summary of a public website including robots.txt review. PAID: $3.00 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Above the default $1.00 per-call cap: refused until X420_MCP_MAX_USD=3 (or higher) is set in the MCP server's environment. Returns: JSON report - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"url":"https://example.com"}.
Inputs: url (required).
x420_sitescan_businessA
SiteScan Business: Expanded multi-page audit with sitemap check and recommendations. PAID: $7.00 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Above the default $1.00 per-call cap: refused until X420_MCP_MAX_USD=7 (or higher) is set in the MCP server's environment. Returns: JSON report, up to 4 pages - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"url":"https://example.com"}.
Inputs: url (required).
x420_sitescan_checkA
SiteScan API check: Machine-readable technical checks of one public page: security headers, SEO basics, accessibility signals, performance indicators. PAID: $0.50 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON report with score, grade, findings - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"url":"https://example.com"}.
Inputs: url (required).
x420_spend_summaryARead-only
Free. This server's own spending so far: paid calls, total USD, last-24h USD, the caps (X420_MCP_MAX_USD per call, X420_MCP_MAX_TOTAL_USD lifetime, X420_MCP_MAX_DAILY_USD rolling 24h) and what remains under each, plus whether a wallet is configured and the verified seller pay-to address.
Inputs: no named parameters.
x420_storm_date-finderA
Storm date finder: Candidate storm dates for a point over up to 365 days, ranking each day by NEXRAD radar hail signatures (NOAA SWDI nx3hail) combined with NWS ground reports (hail size, wind gusts, tornadoes) from the IEM LSR archive. Sources: NOAA NCEI SWDI, NWS LSR via IEM. Heuristic ranking, not a date-of-loss determination. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.10 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: summary{candidate_dates, top_date, max_hail_in, max_wind_mph}, candidates[{date, radar{detections, max_size_in}, ground{hail_reports, max_hail_in, max_wind_mph, tornado_reports}, score}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat":"32.7357","lon":"-97.1081","radius_km":"10","days":"365"}.
Inputs: lat (required), lon (required), end, days, +1 more.
x420_storm_reportsA
Storm ground reports: NWS Local Storm Reports (hail, wind, tornado, flood ground reports from spotters, officials and the public) within a radius of a coordinate over up to 365 days, from the Iowa Environmental Mesonet archive of NWS LSRs (free, no key). Source: NWS LSR via IEM. Not a damage determination. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.05 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: summary{hail, wind, tornado, flood, days}, reports[{ts, type_text, magnitude, unit, city, county, source, remark, distance_km}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat":"32.7357","lon":"-97.1081","radius_km":"25","days":"240"}.
Inputs: lat (required), lon (required), end, days, +1 more.
x420_time_zone-convertA
Time zone converter: Converts an instant or wall-clock time between IANA time zones with DST handled, returning ISO strings with offsets and abbreviations. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.01 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: utc, epoch_ms, from, to (iso, zone, abbreviation, utc_offset) - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"time":"2026-11-19T15:00:00Z","to_tz":"America/Chicago"}.
Inputs: to_tz (required), time, from_tz.
x420_tls_certificateA
TLS certificate check: Connects to a public host and reports the presented TLS certificate: subject, issuer, SANs, validity window, days remaining, chain trust, protocol and cipher. Source: direct handshake. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.03 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: subject, issuer, sans[], valid_from, valid_to, days_remaining, expired, authorized, covers_host, protocol, cipher - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"host":"example.com"}.
Inputs: host (required), port.
x420_units_convertA
Unit converter: Converts length, mass, area (incl. roofing squares), volume and temperature between common metric and US units. Pure arithmetic. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.01 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: value, from, to, category, result - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"value":"2400","from":"sqft","to":"square"}.
Inputs: to (required), from (required), value (required).
x420_validate_email-url-phoneA
Format validator (email, URL, phone): Syntax validation and normalisation: email (RFC 5322 simplified, lower-cased domain), URL (parsed, http/https), phone (E.164 normalisation with NANP rules). No network lookups. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.01 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: email{valid, normalized, domain}, url{valid, normalized, host}, phone{valid, e164, country_code, national} - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"email":"Owner@Example.COM","phone":"(817) 555-0142"}.
Inputs: url, email, phone, default_country.
x420_verify_domain-txtA
Domain TXT challenge: Checks whether a domain (or a named subdomain of it) publishes an expected token in DNS TXT, exactly or as key=token. Source: live DNS. Proves zone control at query time, nothing more. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: verified, matched_record, records_checked, checked_at - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"domain":"example.com","name":"_x420.example.com","token":"x420-8f3a7c1d"}.
Inputs: token (required), domain (required), name.
x420_verify_signatureA
Signature verifier: Checks an EIP-191 personal_sign signature against an Ethereum address (pure recovery, EOAs only), or an ed25519 signature over canonical JSON against an X420 agent public key. No network. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: scheme, valid, recovered/public_key, reason, message_sha256 - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"scheme":"eip191","message":"x420 quote q_8f3a nonce 7c1d","address":"0xa1B2c3d4E5f60718293a4B5C6d7E8F9012345678","signature":"0x5d1b…(130 hex)…1c"}.
Inputs: signature (required), scheme, address, message, +2 more.
x420_weather_alertsA
NWS active alerts: Active National Weather Service watches, warnings and advisories covering a US coordinate (free, no key). Source: NOAA/NWS api.weather.gov. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.02 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: count, alerts[{event, severity, certainty, urgency, headline, area, effective, expires, description, instruction}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat":"32.7357","lon":"-97.1081"}.
Inputs: lat (required), lon (required).
x420_weather_forecastA
NWS forecast: Official 7-day forecast periods for a US coordinate from the National Weather Service API (free, no key): temperature, precipitation chance, wind, short and detailed text. Source: NOAA/NWS api.weather.gov. Not professional, legal, insurance, engineering, medical, financial or tax advice. PAID: $0.03 USDC per call, settled on Base via x402 from the wallet in X420_MCP_WALLET_PRIVATE_KEY (real money). Returns: JSON: place, office, grid, periods[{name, start, end, temperature, precip_chance_pct, wind, short, detailed}] - the deliverable plus X420's signed receipt and the settlement transaction. Example input: {"lat":"32.7357","lon":"-97.1081","periods":"2"}.
Inputs: lat (required), lon (required), periods.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 38 tools
Most tools target distinct services or data sources, but several clusters overlap: SiteScan check/basic/business plus HTTP and TLS checks, hail/storm reports/date finder, and hash digest/evidence timestamp. Detailed descriptions help, but an agent can still misselect within these families.
All tools share an x420_ prefix and broad category grouping, which is readable. However, multiword names mix underscores and hyphens (e.g. x420_geo_reverse-geocode, x420_csv_to-json, x420_chain_wallet-balance) and use noun/verb forms inconsistently.
38 tools is well above the practical 3-15 range; many are tiny single-purpose utilities or tiered variants that could be consolidated. The broad marketplace scope explains some breadth, but the surface is heavy and burdens selection.
The surface covers discovery, quoting, spend tracking, and many paid service categories, so core workflows are present. Gaps remain around receipt/call history, refunds, wallet/config management, and generic order lifecycle, but agents can work around them.
Maintenance
Related MCP Connectors
Paid MCP tools behind one endpoint. Agents pay per call in USDC on Base via x402.
Pay-per-call MCP tools for agents via x402 USDC: Korean data, onchain, crypto, web and AI tools.
28 agent tools via x402: crypto data, tx checks, web fetch. MCP pays Base USDC; HTTP adds 3 rails.
Pay-per-use MCP tools for AI agents. USDC on Base via x402. No API keys.
Related MCP Servers
- AlicenseBqualityDmaintenanceExposes 25 paid API endpoints as MCP tools for AI agents, with payments in USDC on Base mainnet via the x402 protocol, enabling tasks like web search, company intelligence, and crypto research.25126 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to access 11 paid x402 endpoints as standard MCP tools, paying per call in USDC on Base without API keys, covering chat, code, vision, embeddings, crypto prices, weather, geolocation, forex, and WHOIS data.-
- AlicenseNot gradedqualityCmaintenanceExposes a live catalogue of specialist tools as MCP endpoints and returns x402 payment challenges for each call, letting agents pay per use in USDC from their own wallet without subscriptions or API keys.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access pay-per-call onchain and URL safety APIs over MCP, covering transaction explanations, token approval checks, address inspection, contract risk heuristics, URL safety, gas snapshots, ENS resolution, calldata decoding, and wallet portfolio data. Payments are handled per call in USDC on Base via x402, with no signup or API key required.1MIT