code402
Discover machine-payable APIs, probe x402 payment terms, and run seller operations. Non-custodial.
Should I use this
Quality & Safety
A
Findings (2)
- LOWTool 'crypto_ticker' description lacks action verbin crypto_ticker
- LOWTool 'fx_spot_price_oracle' description lacks action verbin fx_spot_price_oracle
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~14,588Tokens (tool definitions)
~2.0 KBTypical response size
Significant attention impact (11.40% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"code402": {
"url": "https://mcp.code402.dev/mcp"
}
}
}Remote endpoints
https://mcp.code402.dev/mcpstreamable-httphttps://rail.hcrb.in/mcpstreamable-httpWhat it can do
Tool inventory
Tools (57)
š¢ Read-onlyš” Writeš“ DeleteāŖ Unknown
š¢crypto_ticker(symbol)
Spot USD price for a crypto ticker or CoinGecko id from public price feeds, cached 60 s. Result carries a signed receipt.
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "Ticker symbol (btc, eth, sol, ā¦) or a CoinGecko asset id (bitcoin, ethereum, ā¦)."
}
},
"required": [
"symbol"
],
"examples": [
{
"symbol": "btc"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"symbol": {
"type": "string"
},
"coingecko_id": {
"type": "string"
},
"price_usd": {
"type": "number"
},
"currency": {
"type": "string"
},
"cached": {
"type": "boolean"
},
"fetched_at": {
"type": "string"
},
"reason": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"symbol"
]
}š¢erc20_balance(address, token_address, decimals)
Raw and formatted ERC-20 balanceOf for an address on Base, with decimals read from the token. Result carries a signed receipt.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Holder EVM address, 0x-prefixed."
},
"token_address": {
"type": "string",
"description": "ERC-20 token contract address, 0x-prefixed."
},
"decimals": {
"type": "number",
"description": "Token decimals override (optional)."
}
},
"required": [
"address",
"token_address"
],
"examples": [
{
"address": "0xc59c85e661d34084a7769f955d17fd38254a6235",
"token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"address": {
"type": "string"
},
"token_address": {
"type": "string"
},
"balance_raw": {
"type": "string"
},
"decimals": {
"type": "number"
},
"decimals_source": {
"type": "string"
},
"balance": {
"type": "number"
},
"reason": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"address",
"token_address"
]
}š¢fx_spot_price_oracle(base, quote)
Reference fiat and stablecoin conversion rate from a static table, not a live feed. Returns rate and inverse; result carries a signed receipt.
Input Schema
{
"type": "object",
"properties": {
"base": {
"type": "string",
"description": "Base currency symbol (e.g. USDC, EUR, GBP, JPY)."
},
"quote": {
"type": "string",
"description": "Quote currency symbol (e.g. USD, EUR, JPY)."
}
},
"required": [
"base",
"quote"
],
"examples": [
{
"base": "EUR",
"quote": "USD"
}
]
}Output Schema
{
"type": "object",
"properties": {
"pair": {
"type": "string"
},
"rate": {
"type": "number"
},
"inverse": {
"type": "number"
},
"timestamp": {
"type": "number"
},
"source": {
"type": "string"
}
},
"required": [
"pair",
"rate",
"inverse",
"timestamp",
"source"
]
}š¢block_info(block)
Base chain (8453) block header data: block number, timestamp, transaction count and base fee for any block. Result carries a signed receipt.
Input Schema
{
"type": "object",
"properties": {
"block": {
"type": "string",
"description": "Block number as hex (0xā¦) or decimal, or a tag (latest/earliest/pending/finalized/safe); defaults to latest."
}
},
"required": [],
"examples": [
{
"block": "latest"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"block": {
"type": "string"
},
"block_number": {
"type": "number"
},
"timestamp": {
"type": "number"
},
"timestamp_iso": {
"type": "string"
},
"tx_count": {
"type": "number"
},
"base_fee_gwei": {
"type": "number"
},
"reason": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"block_number"
]
}š¢tx_activity(address)
Outbound transaction count (nonce) and contract-or-EOA check for an address on Base. Result carries a signed receipt.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "EVM address, 0x-prefixed."
}
},
"required": [
"address"
],
"examples": [
{
"address": "0xc59c85e661d34084a7769f955d17fd38254a6235"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"address": {
"type": "string"
},
"tx_count": {
"type": "number"
},
"is_contract": {
"type": "boolean"
},
"first_funded_heuristic": {
"type": "boolean"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"address",
"tx_count"
]
}š¢token_contract_risk(address, chain)
Deterministic Base contract facts: ERC-20 metadata, proxy slots, owner(), privileged-function selectors and flags. Not a safety verdict. Result carries a signed receipt.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Contract address on Base, 0x + 40 hex."
},
"chain": {
"type": "string",
"enum": [
"base"
],
"description": "Optional. Only 'base' (Base mainnet) is supported."
}
},
"required": [
"address"
],
"examples": [
{
"address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
]
}Output Schema
{
"type": "object",
"properties": {
"valid": {
"type": "boolean"
},
"address": {
"type": "string"
},
"is_contract": {
"type": "boolean"
},
"tool": {
"type": "string"
},
"chain": {
"type": "string"
},
"block": {
"type": "object"
},
"erc20": {
"type": "object"
},
"proxy": {
"type": "object"
},
"owner": {
"type": "object"
},
"privileged_selectors": {
"type": "array"
},
"opcodes": {
"type": "object"
},
"flags": {
"type": "array"
},
"flag_counts": {
"type": "object"
},
"reason": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"address",
"is_contract",
"flags",
"scope"
]
}š¢clean_markdown_scraper(url, html)
Fetch a public web page by URL (or take your HTML) and return Markdown plus headings. No JavaScript rendering. Result carries a signed receipt.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) page to fetch (ports 80/443 only). Provide exactly one of url or html."
},
"html": {
"type": "string",
"description": "Raw HTML string to convert instead of fetching a URL (max 1 MiB). Provide exactly one of url or html."
}
},
"required": [],
"examples": [
{
"url": "https://example.com/"
}
]
}Output Schema
{
"type": "object",
"properties": {
"markdown": {
"type": "string"
},
"wordCount": {
"type": "number"
},
"headings": {
"type": "array"
},
"valid": {
"type": "boolean"
},
"tool": {
"type": "string"
},
"source": {
"type": "object"
},
"fetched_on": {
"type": "string"
},
"reason": {
"type": "string"
},
"code": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"scope": {
"type": "string"
}
},
"required": [
"markdown",
"wordCount"
]
}š¢context_distill(text)
Deterministic text digest: word count, top-5 most frequent meaningful words (stop words excluded), first sentence, and a keccak-256 content hash. Pure function ā no external calls, no ML.
Input Schema
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Arbitrary text to distill (any length; hashing is over the exact input)."
}
},
"required": [
"text"
],
"examples": [
{
"text": "The landlord demanded the deposit before the viewing. The deposit was paid before any viewing of the property."
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"word_count": {
"type": "number"
},
"meaningful_word_count": {
"type": "number"
},
"top_words": {
"type": "array"
},
"first_sentence": {
"type": "string"
},
"content_hash": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"word_count"
]
}š¢instant_json_schema_verifier(data, schema)
Validate JSON data payloads against schema definitions. Preflighted for agent tool call pipelines.
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"description": "The JSON data object to validate against the schema."
},
"schema": {
"type": "object",
"description": "The JSON schema object with expected properties and types."
}
},
"required": [
"data",
"schema"
],
"examples": [
{
"data": {
"name": "Apex Agent",
"version": 2
},
"schema": {
"required": [
"name",
"version"
],
"properties": {
"name": {
"type": "string"
},
"version": {
"type": "number"
}
}
}
}
]
}Output Schema
{
"type": "object",
"properties": {
"valid": {
"type": "boolean"
},
"errors": {
"type": "array"
},
"execution_ms": {
"type": "number"
}
},
"required": [
"valid",
"errors",
"execution_ms"
]
}š¢balance_check(address, token_address)
Native ETH and one ERC-20 balance (default USDC) for an address on Base, raw and formatted. Result carries a signed receipt.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "EVM address, 0x-prefixed."
},
"token_address": {
"type": "string",
"description": "ERC-20 token contract address (optional; defaults to USDC on Base)."
}
},
"required": [
"address"
],
"examples": [
{
"address": "0xc59c85e661d34084a7769f955d17fd38254a6235"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"address": {
"type": "string"
},
"native": {
"type": "object"
},
"token": {
"type": "object"
},
"reason": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"address"
]
}š¢calculate_fx_savings(amount_usdc, amount_usd, amount, currency)
Arithmetic comparison of a USDC settlement against comparator percentages YOU supply (bank_fee_pct, custodial_fee_pct) across 14 global fiat currencies. The comparators are assumptions, not measurements of any bank or provider; no protocol fee is deducted on this rail.
Input Schema
{
"type": "object",
"properties": {
"amount_usdc": {
"type": "number",
"description": "Gross invoice settlement volume in USD/USDC."
},
"amount_usd": {
"type": "number",
"description": "Gross invoice settlement volume in USD/USDC (alias)."
},
"amount": {
"type": "number",
"description": "Gross invoice settlement volume in USD/USDC (alias)."
},
"currency": {
"type": "string",
"description": "Target currency for local comparison (e.g. EUR, GBP, BRL, INR, ARS, PHP, NGN, SGD)."
}
},
"examples": [
{
"amount_usdc": 50000,
"currency": "BRL"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"amount_usdc": {
"type": "number"
},
"currency": {
"type": "string"
},
"legacy_swift_fee_usd": {
"type": "number"
},
"deel_fee_usd": {
"type": "number"
},
"code402_protocol_fee_usd": {
"type": "number"
},
"retained_savings_usd": {
"type": "number"
},
"pct_retained": {
"type": "number"
},
"local_currency": {
"type": "object"
},
"scope": {
"type": "string"
}
},
"required": [
"amount_usdc",
"retained_savings_usd",
"pct_retained"
]
}š¢iban_check(iban)
Validate IBAN structure and MOD-97 checksum. Does not establish account ownership, beneficiary identity or absence of fraud.
Input Schema
{
"type": "object",
"properties": {
"iban": {
"type": "string",
"description": "IBAN to validate; spaces allowed."
}
},
"required": [
"iban"
],
"examples": [
{
"iban": "GB82 WEST 1234 5698 7654 32"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢lei_check(lei)
Validate a 20-character LEI and MOD-97 check digits. No registry lookup, active-registration check or legal-entity identity verification.
Input Schema
{
"type": "object",
"properties": {
"lei": {
"type": "string",
"description": "20-character Legal Entity Identifier."
}
},
"required": [
"lei"
],
"examples": [
{
"lei": "529900T8BM49AURSDO55"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢vat_mod97_check(vat_number)
Check the supported Belgian VAT format and MOD-97 checksum. BE only; not VIES, other EU VAT formats, registration status or tax compliance.
Input Schema
{
"type": "object",
"properties": {
"vat_number": {
"type": "string",
"description": "Belgian VAT id in the supported BE mod-97 format (BE prefix optional); not a VIES lookup."
}
},
"required": [
"vat_number"
],
"examples": [
{
"vat_number": "BE0417497106"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢swift_bic_check(bic)
Check SWIFT/BIC structure and country code. Does not establish bank existence, active routing or beneficiary identity.
Input Schema
{
"type": "object",
"properties": {
"bic": {
"type": "string",
"description": "SWIFT/BIC code, 8 or 11 characters; spaces/dashes allowed."
}
},
"required": [
"bic"
],
"examples": [
{
"bic": "DEUTDEFF500"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢batch_validate(items)
Validate up to 50 tax, bank and legal-entity identifiers (IBAN, LEI, VAT, SWIFT/BIC, ABA routing, EIN, IFSC, ABN, GSTIN, ISIN, SEDOL, EAN-13, ISBN, E.164 or Luhn checks) in one batch request. Each result states its scope. Compare the current batch quote with individual quotes; savings depend on batch size.
Input Schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"description": "List of {tool, value} checks (max 50).",
"items": {
"type": "object",
"required": [
"tool",
"value"
],
"properties": {
"tool": {
"type": "string",
"enum": [
"iban-check",
"lei-check",
"vat-mod97-check",
"company-number-format",
"swift-bic-check",
"aba-routing-check",
"ein-format-check",
"ifsc-check",
"abn-check",
"luhn-check",
"isbn-check",
"e164-check",
"sedol-check",
"isin-check",
"ean13-check",
"gstin-check",
"context-distill"
],
"description": "which validator to run"
},
"value": {
"type": "string",
"description": "the identifier (or text, for context-distill) to check"
}
}
}
}
},
"required": [
"items"
],
"examples": [
{
"items": [
{
"tool": "iban-check",
"value": "GB82 WEST 1234 5698 7654 32"
},
{
"tool": "lei-check",
"value": "529900T8BM49AURSDO55"
},
{
"tool": "vat-mod97-check",
"value": "BE0417497106"
}
]
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"count": {
"type": "number"
},
"valid_count": {
"type": "number"
},
"invalid_count": {
"type": "number"
},
"results": {
"type": "array"
},
"scope": {
"type": "string"
}
},
"required": [
"count",
"results"
]
}š¢vendor_onboarding_pack(iban, lei, vat_number, company_number)
Check supplied IBAN, LEI, Belgian VAT and UK company-number fields in one result. Structural checks only; no ownership, registry or fraud clearance.
Input Schema
{
"type": "object",
"properties": {
"iban": {
"type": "string",
"description": "Vendor IBAN (optional)."
},
"lei": {
"type": "string",
"description": "Vendor LEI (optional)."
},
"vat_number": {
"type": "string",
"description": "Vendor VAT number, BE mod-97 (optional)."
},
"company_number": {
"type": "string",
"description": "Vendor UK company number (optional)."
}
},
"required": [],
"examples": [
{
"iban": "GB82 WEST 1234 5698 7654 32",
"lei": "529900T8BM49AURSDO55",
"vat_number": "BE0417497106",
"company_number": "12345678"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"checked_count": {
"type": "number"
},
"all_valid": {
"type": "boolean"
},
"verdict": {
"type": "string"
},
"results": {
"type": "array"
},
"scope": {
"type": "string"
}
},
"required": [
"checked_count",
"all_valid"
]
}š¢india_supplier_check(gstin, pan, vpa, ifsc)
One call, one receipt: GSTIN + PAN + UPI VPA + IFSC for an Indian counterparty. Four deterministic structural checks, each stating its own scope. Built for cross-border procurement where the buyer is an agent that cannot open an INR account.
Input Schema
{
"type": "object",
"properties": {
"gstin": {
"type": "string",
"description": "GSTIN (15 chars, optional)"
},
"pan": {
"type": "string",
"description": "PAN (10 chars, optional)"
},
"vpa": {
"type": "string",
"description": "UPI VPA handle (optional)"
},
"ifsc": {
"type": "string",
"description": "IFSC bank code (optional)"
}
},
"required": [],
"examples": [
{
"gstin": "27AAPFU0939F1ZV",
"pan": "AAACP1234M",
"vpa": "merchant@okhdfcbank",
"ifsc": "HDFC0001234"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"corridor": {
"type": "string"
},
"checked_count": {
"type": "number"
},
"all_valid": {
"type": "boolean"
},
"verdict": {
"type": "string"
},
"results": {
"type": "array"
},
"next_steps": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"checked_count",
"all_valid"
]
}š¢pre_disbursement_guard(recipient_iban, vendor_domain, declared_country, company_number, lei, ...)
Check supplier tax and bank identifiers (IBAN, LEI, EU VAT, UK company number), domain-age evidence and country mismatch signals before vendor payment. Requires a preceding receipt hash. An advisory result is not verified identity, fraud clearance or authorization to release funds.
Input Schema
{
"type": "object",
"properties": {
"recipient_iban": {
"type": "string",
"description": "Recipient bank IBAN (optional)."
},
"vendor_domain": {
"type": "string",
"description": "Vendor website domain or invoicing email address (optional)."
},
"declared_country": {
"type": "string",
"description": "2-letter ISO country code where vendor claims to be registered (optional, e.g. 'GB', 'US', 'DE')."
},
"company_number": {
"type": "string",
"description": "Official corporate registration number, e.g. UK Companies House 8 digits/chars (optional)."
},
"lei": {
"type": "string",
"description": "ISO 17442 Legal Entity Identifier (optional)."
},
"vat_number": {
"type": "string",
"description": "EU VAT number (optional)."
},
"physical_address": {
"type": "string",
"description": "Vendor physical office address (optional)."
},
"invoice_amount_usd": {
"type": "number",
"description": "Disbursement transaction amount in USD (optional)."
},
"prev_receipt_hash": {
"type": "string",
"description": "Preceding verification receipt hash (may also be passed via X-PREV-RECEIPT-HASH header)."
}
},
"required": [],
"examples": [
{
"recipient_iban": "GB82WEST12345698765432",
"vendor_domain": "[email protected]",
"declared_country": "GB",
"company_number": "01234567",
"invoice_amount_usd": 4500,
"prev_receipt_hash": "0x0000000000000000000000000000000000000000000000000000000000000000"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"clear_to_disburse": {
"type": "boolean"
},
"risk_level": {
"type": "string"
},
"risk_score": {
"type": "number"
},
"decision": {
"type": "string"
},
"summary": {
"type": "string"
},
"checks": {
"type": "object"
},
"flags_triggered": {
"type": "array"
},
"recommendations": {
"type": "array"
},
"inspected_counterparty": {
"type": "object"
},
"scope": {
"type": "string"
}
},
"required": [
"clear_to_disburse",
"risk_level",
"risk_score",
"decision"
]
}š¢gstin_check(gstin)
Validate an Indian GSTIN by structure (2-digit state code + PAN + entity code + 'Z') and its mod-36 cross-sum checksum.
Input Schema
{
"type": "object",
"properties": {
"gstin": {
"type": "string",
"description": "15-character Indian Goods and Services Tax Identification Number."
}
},
"required": [
"gstin"
],
"examples": [
{
"gstin": "27AAPFU0939F1ZV"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢ifsc_check(ifsc)
Check the 11-character Indian IFSC format, including its fifth-character zero. No bank-branch registry lookup or account verification.
Input Schema
{
"type": "object",
"properties": {
"ifsc": {
"type": "string",
"description": "11-character Indian Financial System Code."
}
},
"required": [
"ifsc"
],
"examples": [
{
"ifsc": "HDFC0000123"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢sanctions_address_screen(subject)
Screen an EVM wallet address or ISO country code by exact comparison against the identified sanctions address snapshot and existing operator block policy. Current legal status is unknown; is_sanctioned is null. valid=false preserves a local block; valid=null never authorizes a transaction. Names are not screened. Missing, stale or incomplete evidence is explicit; no UN/EU coverage or sanctions clearance is provided.
Input Schema
{
"type": "object",
"properties": {
"subject": {
"type": "string",
"description": "EVM address (0x...) or ISO 3166-1 country code / jurisdiction name"
}
},
"required": [
"subject"
],
"examples": [
{
"subject": "0x7f367cc41522ce07553e823bf3be79a889debe1b"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": [
"boolean",
"null"
]
},
"is_sanctioned": {
"type": "null"
},
"blocklist_match": {
"type": [
"boolean",
"null"
]
},
"current_legal_status": {
"type": "string"
},
"screening_status": {
"type": "string"
},
"snapshot_status": {
"type": "string"
},
"snapshot_sha256": {
"type": "string"
},
"match_type": {
"type": "string"
},
"subject": {
"type": "string"
},
"sanction_program": {
"type": [
"string",
"null"
]
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"tool",
"valid",
"is_sanctioned",
"blocklist_match",
"current_legal_status",
"screening_status"
]
}š¢company_number_format(company_number)
Check supported UK company-number syntax. No Companies House lookup, entity-existence check or active-registration verification.
Input Schema
{
"type": "object",
"properties": {
"company_number": {
"type": "string",
"description": "8 digits, or 2 letters + 6 digits."
}
},
"required": [
"company_number"
],
"examples": [
{
"company_number": "12345678"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢aba_routing_check(aba_routing, routing)
Validate a US ABA routing number by its (3,7,1)-weight mod-10 Fedwire/ACH checksum. Catches mistyped or invalid routing numbers before payment; does NOT prevent transfer reversals or establish the recipient. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"aba_routing": {
"type": "string",
"description": "9-digit US bank routing number."
},
"routing": {
"type": "string",
"description": "9-digit US bank routing number (alias)."
}
},
"examples": [
{
"aba_routing": "021000021"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢ein_format_check(ein)
Validate US Employer Identification Number FORMAT (NN-NNNNNNN). Use during US business counterparty KYB verification. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"ein": {
"type": "string",
"description": "US EIN, 9 digits; dashes/spaces allowed."
}
},
"required": [
"ein"
],
"examples": [
{
"ein": "12-3456789"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢abn_check(abn)
Validate an Australian Business Number by its mod-89 checksum (11 digits). Required before invoice payment to Australian contractors. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"abn": {
"type": "string",
"description": "11-digit Australian Business Number; spaces allowed."
}
},
"required": [
"abn"
],
"examples": [
{
"abn": "51 824 753 556"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢e164_check(phone)
Validate a phone number's E.164 structure (+CC, 8-15 digits, no leading zero) before dispatching SMS alerts or OTPs. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"phone": {
"type": "string",
"description": "International phone number, e.g. +14155552671."
}
},
"required": [
"phone"
],
"examples": [
{
"phone": "+14155552671"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢sedol_check(sedol)
Validate a UK/Ireland security identifier by its (1,3,1,7,3,9)-weight mod-10 checksum. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"sedol": {
"type": "string",
"description": "7-character SEDOL code."
}
},
"required": [
"sedol"
],
"examples": [
{
"sedol": "B0YBKJ7"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢isin_check(isin)
Validate an ISIN (ISO 6166) by structure and Luhn mod-10 check digit over the A=10ā¦Z=35 converted string.
Input Schema
{
"type": "object",
"properties": {
"isin": {
"type": "string",
"description": "12-character ISIN: 2-letter country code + 9 alphanumerics + check digit; spaces allowed."
}
},
"required": [
"isin"
],
"examples": [
{
"isin": "US0378331005"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢ean13_check(code)
Validate an EAN-13 barcode by its mod-10 checksum (odd positions x1, even positions x3).
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "13-digit EAN-13 barcode; spaces/dashes allowed."
}
},
"required": [
"code"
],
"examples": [
{
"code": "5901234123457"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢cnpj_check(cnpj)
Validate Brazilian corporate tax ID (CNPJ) with official dual mod-11 check digits. Required for Brazilian B2B payments, PIX verification, and vendor due diligence. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "14-digit Brazilian CNPJ; punctuation allowed (e.g. 00.000.000/0001-91)."
}
},
"required": [
"cnpj"
],
"examples": [
{
"cnpj": "00.000.000/0001-91"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢uscc_check(uscc)
Validate 18-character Chinese business registration and tax code using GB 32100-2015 ISO 7064 Mod-31-3 checksum. Required for B2B supply chain trade with Chinese manufacturers. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"uscc": {
"type": "string",
"description": "18-character Chinese Unified Social Credit Code (e.g. 91330100799655058B)."
}
},
"required": [
"uscc"
],
"examples": [
{
"uscc": "91330100799655058B"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢japan_corp_check(number)
Validate 13-digit Japanese Corporate Number assigned by the National Tax Agency using Mod-9 check digit algorithm. Required for Japanese B2B SaaS and enterprise billing. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"number": {
"type": "string",
"description": "13-digit Japanese Corporate Number (e.g. 1180301018771)."
}
},
"required": [
"number"
],
"examples": [
{
"number": "1180301018771"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢kra_pin_check(pin)
Validate Kenyan Revenue Authority Tax PIN structure (A/P followed by 9 digits and checksum character). Required for M-Pesa B2B disbursement and Kenyan remote agency invoicing. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"pin": {
"type": "string",
"description": "11-character KRA PIN (e.g. P051112223Z)."
}
},
"required": [
"pin"
],
"examples": [
{
"pin": "P051112223Z"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢rfc_check(rfc)
Validate Mexican SAT RFC corporate (12-char) or individual (13-char) tax code and homoclave. Required for Mexican contractor invoicing and SPEI cross-border settlements. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"rfc": {
"type": "string",
"description": "12 or 13 character Mexican RFC (e.g. BBA830831LJ2)."
}
},
"required": [
"rfc"
],
"examples": [
{
"rfc": "BBA830831LJ2"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢iso4217_currency_check(currency)
Validate 3-letter alpha or 3-digit numeric currency codes against ISO 4217 standard. Returns minor unit decimals, symbol, official name, countries, and onchain Base L2 settlement token mapping (USDC/EURC).
Input Schema
{
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "3-letter ISO 4217 code (e.g. USD, EUR, JPY, CNY, BRL, KES, MXN) or 3-digit numeric code (e.g. 840, 978, 392)."
}
},
"required": [
"currency"
],
"examples": [
{
"currency": "EUR"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢upi_vpa_check(vpa)
Deterministic structural validation of an Indian UPI Virtual Payment Address (VPA / handle): local-part syntax, handle against a LOCAL list of accredited PSP handles (okhdfcbank, okaxis, paytm, ybl and others), and length rules. It is NOT a live registry lookup: no request leaves this worker, and an unlisted handle is reported as unrecognised rather than nonexistent. This does not establish that the VPA is registered, reachable or owned by anyone.
Input Schema
{
"type": "object",
"properties": {
"vpa": {
"type": "string",
"description": "UPI Virtual Payment Address (e.g. 'merchant@okhdfcbank', '9876543210@paytm')"
}
},
"required": [
"vpa"
],
"examples": [
{
"vpa": "merchant@okhdfcbank"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"username": {
"type": "string"
},
"handle": {
"type": "string"
},
"accredited_psp": {
"type": "boolean"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"tool",
"valid"
]
}š¢pan_format_check(pan)
Deterministic validation of Indian Permanent Account Number (PAN) issued by CBDT / Income Tax Department with 4th-character entity type classification (Individual, Company, Firm, Trust, HUF).
Input Schema
{
"type": "object",
"properties": {
"pan": {
"type": "string",
"description": "10-character PAN string (e.g. 'AAACP1234M')"
}
},
"required": [
"pan"
],
"examples": [
{
"pan": "AAACP1234M"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"entity_code": {
"type": "string"
},
"entity_type": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"tool",
"valid"
]
}š¢uae_trn_check(trn)
Deterministic validation of UAE 15-digit Tax Registration Number (TRN) issued by the Federal Tax Authority (FTA) for VAT purposes.
Input Schema
{
"type": "object",
"properties": {
"trn": {
"type": "string",
"description": "15-digit UAE TRN string (starts with 100)"
}
},
"required": [
"trn"
],
"examples": [
{
"trn": "100123456700003"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"authority": {
"type": "string"
},
"trn_type": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"tool",
"valid"
]
}š¢china_supplier_check(uscc, iban, swift)
One call, one receipt: USCC + settlement IBAN + SWIFT/BIC for a Chinese counterparty. Deterministic structure and checksum validation with explicit scope per identifier.
Input Schema
{
"type": "object",
"properties": {
"uscc": {
"type": "string",
"description": "Unified Social Credit Code (optional)"
},
"iban": {
"type": "string",
"description": "Settlement IBAN (optional)"
},
"swift": {
"type": "string",
"description": "SWIFT/BIC (optional)"
}
},
"required": [],
"examples": [
{
"uscc": "91350100M000100Y43",
"iban": "GB82WEST12345698765432",
"swift": "DEUTDEFF"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"corridor": {
"type": "string"
},
"checked_count": {
"type": "number"
},
"all_valid": {
"type": "boolean"
},
"verdict": {
"type": "string"
},
"results": {
"type": "array"
},
"next_steps": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"checked_count",
"all_valid"
]
}š¢japan_supplier_check(corporate_number, iban)
One call, one receipt: 13-digit Corporate Number + settlement IBAN for a Japanese counterparty. Deterministic check digits, explicit scope.
Input Schema
{
"type": "object",
"properties": {
"corporate_number": {
"type": "string",
"description": "13-digit Corporate Number (optional)"
},
"iban": {
"type": "string",
"description": "Settlement IBAN (optional)"
}
},
"required": [],
"examples": [
{
"corporate_number": "7000012050002",
"iban": "GB82WEST12345698765432"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"corridor": {
"type": "string"
},
"checked_count": {
"type": "number"
},
"all_valid": {
"type": "boolean"
},
"verdict": {
"type": "string"
},
"results": {
"type": "array"
},
"next_steps": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"checked_count",
"all_valid"
]
}š¢latam_supplier_check(cnpj, rfc, iban)
One call, one receipt: Brazilian CNPJ + Mexican RFC + settlement IBAN. Deterministic checks for the two largest LatAm corridors in one paid call.
Input Schema
{
"type": "object",
"properties": {
"cnpj": {
"type": "string",
"description": "Brazilian CNPJ (optional)"
},
"rfc": {
"type": "string",
"description": "Mexican RFC (optional)"
},
"iban": {
"type": "string",
"description": "Settlement IBAN (optional)"
}
},
"required": [],
"examples": [
{
"cnpj": "04.252.011/0001-10",
"rfc": "GODE561231GR8",
"iban": "GB82WEST12345698765432"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"corridor": {
"type": "string"
},
"checked_count": {
"type": "number"
},
"all_valid": {
"type": "boolean"
},
"verdict": {
"type": "string"
},
"results": {
"type": "array"
},
"next_steps": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"checked_count",
"all_valid"
]
}š¢gulf_supplier_check(trn, iban, swift)
One call, one receipt: UAE TRN + settlement IBAN + SWIFT/BIC. Deterministic structure validation for Gulf trade corridors, scope stated per identifier.
Input Schema
{
"type": "object",
"properties": {
"trn": {
"type": "string",
"description": "UAE TRN (15 digits, optional)"
},
"iban": {
"type": "string",
"description": "Settlement IBAN (optional)"
},
"swift": {
"type": "string",
"description": "SWIFT/BIC (optional)"
}
},
"required": [],
"examples": [
{
"trn": "100123456700003",
"iban": "AE070331234567890123456",
"swift": "EBILAEAD"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"corridor": {
"type": "string"
},
"checked_count": {
"type": "number"
},
"all_valid": {
"type": "boolean"
},
"verdict": {
"type": "string"
},
"results": {
"type": "array"
},
"next_steps": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"checked_count",
"all_valid"
]
}š¢africa_supplier_check(kra_pin, iban, swift)
One call, one receipt: Kenya KRA PIN + settlement IBAN + SWIFT/BIC. Deterministic structural checks for East African trade corridors.
Input Schema
{
"type": "object",
"properties": {
"kra_pin": {
"type": "string",
"description": "KRA PIN (optional)"
},
"iban": {
"type": "string",
"description": "Settlement IBAN (optional)"
},
"swift": {
"type": "string",
"description": "SWIFT/BIC (optional)"
}
},
"required": [],
"examples": [
{
"kra_pin": "P051234567X",
"iban": "GB82WEST12345698765432",
"swift": "BARCKENX"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"corridor": {
"type": "string"
},
"checked_count": {
"type": "number"
},
"all_valid": {
"type": "boolean"
},
"verdict": {
"type": "string"
},
"results": {
"type": "array"
},
"next_steps": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"checked_count",
"all_valid"
]
}š¢rent_deposit_guard(deposit_iban, property_country, deposit_before_viewing)
Check deposit IBAN checksum and supplied country/viewing indicators. Rule-based risk signals only; no ownership verification, escrow protection or guarantee against theft.
Input Schema
{
"type": "object",
"properties": {
"deposit_iban": {
"type": "string",
"description": "IBAN the deposit would be paid to."
},
"property_country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country of the property, e.g. DE."
},
"deposit_before_viewing": {
"type": "boolean",
"description": "True if a deposit is demanded before any viewing."
}
},
"required": [
"deposit_iban"
],
"examples": [
{
"deposit_iban": "GB82WEST12345698765432",
"property_country": "DE",
"deposit_before_viewing": true
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"risk_score": {
"type": "number"
},
"band": {
"type": "string",
"enum": [
"low",
"elevated",
"high"
]
},
"flags": {
"type": "array"
},
"flags_fired": {
"type": "array"
},
"recommendation": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"risk_score",
"band"
]
}š¢rental_listing_risk(payment_irreversible, contact_moves_offplatform, landlord_abroad_cannot_meet, no_in_person_viewing, urgency_pressure, ...)
Explainable tenancy fraud risk score evaluated across irreversible payment demands, off-platform pressure, stolen photos, and advance wire signals. Deterministic rule engine.
Input Schema
{
"type": "object",
"properties": {
"payment_irreversible": {
"type": "boolean",
"description": "Paid via crypto/gift-card/wire-only."
},
"contact_moves_offplatform": {
"type": "boolean",
"description": "Pushed off the listing platform."
},
"landlord_abroad_cannot_meet": {
"type": "boolean",
"description": "Landlord 'abroad', can't meet in person."
},
"no_in_person_viewing": {
"type": "boolean",
"description": "No viewing before payment."
},
"urgency_pressure": {
"type": "boolean",
"description": "Pressure to secure today."
},
"photos_reverse_image_hit": {
"type": "boolean",
"description": "Listing photos found elsewhere (stolen)."
},
"identity_docs_requested_upfront": {
"type": "boolean",
"description": "Full ID/bank docs demanded upfront."
},
"price_below_market_pct": {
"type": "number",
"description": "How far below local market the rent is asked, in percent."
}
},
"required": [],
"examples": [
{
"payment_irreversible": true,
"no_in_person_viewing": true,
"price_below_market_pct": 45
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"risk_score": {
"type": "number"
},
"band": {
"type": "string",
"enum": [
"low",
"elevated",
"high"
]
},
"flags": {
"type": "array"
},
"flags_fired": {
"type": "array"
},
"recommendation": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"risk_score",
"band"
]
}š¢rental_verdict(deposit_iban, property_country, deposit_before_viewing, landlord_lei, landlord_company_no, ...)
Combine deposit identifier checks with supplied country, viewing and listing indicators. Does not verify landlord identity, property ownership or safety of payment.
Input Schema
{
"type": "object",
"properties": {
"deposit_iban": {
"type": "string",
"description": "Deposit IBAN."
},
"property_country": {
"type": "string",
"description": "Property country, ISO alpha-2."
},
"deposit_before_viewing": {
"type": "boolean",
"description": "True if a deposit is demanded before any viewing."
},
"landlord_lei": {
"type": "string",
"description": "Landlord LEI (optional)."
},
"landlord_company_no": {
"type": "string",
"description": "Landlord UK company number (optional)."
},
"payment_irreversible": {
"type": "boolean",
"description": "Payment demanded via crypto/gift-card/wire-only."
},
"contact_moves_offplatform": {
"type": "boolean",
"description": "Contact pushed off the listing platform."
},
"no_in_person_viewing": {
"type": "boolean",
"description": "No in-person or video viewing before payment."
},
"urgency_pressure": {
"type": "boolean",
"description": "Pressure to secure the property today."
},
"price_below_market_pct": {
"type": "number",
"description": "How far below local market the rent is asked, in percent."
}
},
"required": [
"deposit_iban"
],
"examples": [
{
"deposit_iban": "GB82WEST12345698765432",
"property_country": "DE",
"deposit_before_viewing": true,
"landlord_lei": "529900T8BM49AURSDO55"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"verdict": {
"type": "string",
"enum": [
"clear",
"caution",
"high-risk"
]
},
"risk_score": {
"type": "number"
},
"band": {
"type": "string"
},
"flags": {
"type": "array"
},
"components": {
"type": "object"
},
"summary": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"verdict",
"risk_score"
]
}š¢reconcile(pain001_xml, pacs008_xml, camt053_xml, nacha_ach)
Deterministic reconciliation verdicts: pain.001/pacs.008 instructions vs camt.053 statements or NACHA ACH files, matched by end-to-end id and BigInt-exact amounts. Verdicts: SETTLED, UNPAID, AMOUNT_MISMATCH, DUPLICATE_PAYMENT, plus unmatched statement entries. Facts computed from the documents only ā never inferred, never guessed. Returns signed XDR-1 receipt.
Input Schema
{
"type": "object",
"properties": {
"pain001_xml": {
"type": "string",
"description": "pain.001 instructions (or use pacs008_xml)"
},
"pacs008_xml": {
"type": "string",
"description": "pacs.008/PIX instructions (or use pain001_xml)"
},
"camt053_xml": {
"type": "string",
"description": "camt.053 statement (or use nacha_ach)"
},
"nacha_ach": {
"type": "string",
"description": "NACHA ACH text (94-char records) instead of camt053_xml"
}
},
"examples": [
{
"pain001_xml": "<Document>ā¦</Document>",
"camt053_xml": "<Document>ā¦</Document>"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"normalized": {
"type": "string"
},
"country": {
"type": "string"
},
"reason": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"reason"
]
}š¢create_b2b_invoice(amount_usdc, merchant, client_name, memo, referrer)
Create a merchant-direct Base token invoice. New automated payments require a durable EOA authorization journal and a configured provider. No active protocol fee; no generic bank-wire authority, independent delivery or contract-wallet guarantee.
Input Schema
{
"type": "object",
"properties": {
"amount_usdc": {
"type": "number",
"description": "Invoice total in USDC (e.g. 50000)."
},
"merchant": {
"type": "string",
"description": "Beneficiary contractor Base EVM wallet address (0x...)."
},
"client_name": {
"type": "string",
"description": "Client enterprise organization name (optional)."
},
"memo": {
"type": "string",
"description": "Engagement scope / milestone description (optional)."
},
"referrer": {
"type": "string",
"description": "Optional attribution reference. Referral payouts and protocol fees are not active."
}
},
"required": [
"amount_usdc",
"merchant"
],
"examples": [
{
"amount_usdc": 50000,
"merchant": "0xc59c85e661d34084a7769f955d17fd38254a6235",
"client_name": "Apex AI",
"memo": "Sprint #14 Milestones"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"invoice_id": {
"type": "string"
},
"amount_usdc": {
"type": "number"
},
"merchant": {
"type": "string"
},
"status": {
"type": "string"
},
"cart_hash": {
"type": "string"
},
"protocol_fee_usdc": {
"type": "number"
},
"invoice_url": {
"type": "string"
},
"pay_url": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"invoice_id",
"invoice_url",
"pay_url"
]
}š¢get_b2b_invoice(invoice_id)
Read public recorded invoice status and held-operation next action. Private records and credentials require a separate fresh read-only signature from the durably confirmed original payer; URLs and payment vouchers grant no read authority.
Input Schema
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"description": "Unique invoice identifier, e.g. inv_a1b2c3d4e5f6."
}
},
"required": [
"invoice_id"
],
"examples": [
{
"invoice_id": "inv_example1234"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"invoice_id": {
"type": "string"
},
"status": {
"type": "string"
},
"amount_usdc": {
"type": "number"
},
"merchant": {
"type": "string"
},
"tx_hash": {
"type": "string"
},
"settled_at": {
"type": "number"
},
"private_record_url": {
"type": "string"
},
"private_record_requires": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"invoice_id",
"status"
]
}š¢simulate_spend_sentinel(scenario)
Run synthetic prompt-injection halts, malformed-delivery rejection, and bounded-spend eligibility examples under AP2 envelopes. No live escrow, refund, facilitator or chain action occurs.
Input Schema
{
"type": "object",
"properties": {
"scenario": {
"type": "string",
"description": "Simulation scenario: 'injection' (prompt attack), 'garbage' (bad subagent output), or 'provable' (verified settlement). Default 'injection'."
}
},
"examples": [
{
"scenario": "injection"
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"is_synthetic": {
"type": "boolean"
},
"simulated": {
"type": "boolean"
},
"scenario": {
"type": "string"
},
"status": {
"type": "number"
},
"code": {
"type": "string"
},
"verdict": {
"type": "string"
},
"requested_amount_usdc": {
"type": "number"
},
"actual_wallet_loss_usdc": {
"type": "number"
},
"action_taken": {
"type": "string"
},
"settlement_recipient": {
"type": [
"string",
"null"
]
},
"telemetry": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"valid",
"scenario",
"verdict"
]
}š¢aci_trust_lookup(subject, role, settled_calls_90d, settlement_success_rate, dispute_loss_rate, ...)
Deterministic agent trust scoring and non-custodial unsettled exposure advisory evaluation (ACI-1). Quantifies counterparty grade (T0-T3), historical success rate, and maximum suggested settlement exposure without uncollateralized lending or float.
Input Schema
{
"type": "object",
"properties": {
"subject": {
"type": "string",
"description": "Agent wallet address (0x...) or canonical ANS identifier (c402:...) to evaluate"
},
"role": {
"type": "string",
"description": "Agent role: 'payer' or 'seller' (default 'payer')"
},
"settled_calls_90d": {
"type": "number",
"description": "Number of settled transactions in the past 90 days"
},
"settlement_success_rate": {
"type": "number",
"description": "Historical settlement success rate 0.0 to 1.0"
},
"dispute_loss_rate": {
"type": "number",
"description": "Historical dispute loss rate 0.0 to 1.0"
},
"first_seen_days": {
"type": "number",
"description": "Days since first active on-chain settlement"
},
"sponsor_attestations": {
"type": "array",
"description": "Array of signed sponsorship edges"
}
},
"required": [
"subject"
],
"examples": [
{
"subject": "0x1111111111111111111111111111111111111111",
"settled_calls_90d": 1500,
"settlement_success_rate": 0.999,
"first_seen_days": 120
}
]
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"standard": {
"type": "string"
},
"subject": {
"type": "string"
},
"tier": {
"type": "string"
},
"score_bp": {
"type": "number"
},
"unsettled_exposure_hint_minor": {
"type": "string"
},
"evidence": {
"type": "object"
},
"policy_notice": {
"type": "string"
},
"receipt_digest": {
"type": "string"
}
},
"required": [
"ok",
"standard",
"subject",
"tier",
"score_bp"
]
}š¢csp_commitment_create(invoice_object, salt_hex, stealth_recipient, ephemeral_pubkey, view_tag)
Generates cryptographic commitments to commercial terms and formats ERC-5564 dual-key stealth address announcements (CSP-1) for invoice-scale B2B payments on Base L2.
Input Schema
{
"type": "object",
"properties": {
"invoice_object": {
"type": "object",
"description": "Structured invoice or commercial agreement object to commit to"
},
"salt_hex": {
"type": "string",
"description": "Optional 32-byte salt (0x...). If omitted, cryptographically derived"
},
"stealth_recipient": {
"type": "string",
"description": "Optional Base L2 stealth recipient address for announcement"
},
"ephemeral_pubkey": {
"type": "string",
"description": "Optional ephemeral public key for ERC-5564 announcement"
},
"view_tag": {
"type": "string",
"description": "Optional 1-byte hex view tag (0xNN)"
}
},
"required": [
"invoice_object"
],
"examples": [
{
"invoice_object": {
"invoice_id": "INV-402",
"amount_usdc": 5000,
"line_items": [
{
"sku": "H100_HR",
"qty": 10
}
]
}
}
]
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"standard": {
"type": "string"
},
"invoice_commitment": {
"type": "string"
},
"salt_hex": {
"type": "string"
},
"canonical_jcs": {
"type": "string"
},
"announcement": {
"type": "object"
}
},
"required": [
"ok",
"standard",
"invoice_commitment",
"salt_hex"
]
}š¢iso20022_validate(raw_payload, format, namespace, transactions)
Deterministic validation for institutional ISO 20022 XML/JSON payment messages (pain.001 credit transfer, pacs.008 customer credit, camt.053 bank statement) with XML DOCTYPE security guards, BigInt CtrlSum decimal sums, and ISO 13616 / 9362 / 17442 checksums (BAP-1).
Input Schema
{
"type": "object",
"properties": {
"raw_payload": {
"type": "string",
"description": "Raw ISO 20022 XML or JSON message text"
},
"format": {
"type": "string",
"description": "'xml' or 'json' (default auto-detected)"
},
"namespace": {
"type": "string",
"description": "Expected ISO 20022 schema namespace (e.g. 'pain.001.001.09')"
},
"transactions": {
"type": "array",
"description": "Structured transactions array for JSON validation"
}
},
"required": [
"raw_payload"
],
"examples": [
{
"raw_payload": "<Document xmlns=\"urn:iso:std:iso:20022:tech:xsd:pain.001.001.09\"><CstmrCdtTrfInitn><GrpHdr><MsgId>MSG-2026-001</MsgId><NbOfTxs>1</NbOfTxs><CtrlSum>100.00</CtrlSum></GrpHdr><PmtInf><CdtTrfTxInf><Amt><InstdAmt Ccy=\"USD\">100.00</InstdAmt></Amt><CdtrAgt><FinInstnId><BICFI>DEUTDEDDFXX</BICFI></FinInstnId></CdtrAgt><CdtrAcct><Id><IBAN>DE89370400440532013000</IBAN></Id></CdtrAcct></CdtTrfTxInf></PmtInf></CstmrCdtTrfInitn></Document>"
}
]
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"standard": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"namespace": {
"type": "string"
},
"message_id": {
"type": "string"
},
"tx_count": {
"type": "number"
},
"ctrl_sum_minor": {
"type": "string"
},
"findings": {
"type": "array"
},
"receipt_digest": {
"type": "string"
}
},
"required": [
"ok",
"standard",
"valid"
]
}š¢iso20022_to_x402_intent(instruction, counterparty_wallet_directory, seller_pay_to_address, chain_id)
Translates validated ISO 20022 payment instructions (pain.001 / pacs.008) into deterministic EIP-712 payment-intent templates for autonomous x402 Base L2 USDC settlement (BAP-1). Zero custody, no fiat leg.
Input Schema
{
"type": "object",
"properties": {
"instruction": {
"type": "object",
"description": "Validated BAP-1 payment instruction object"
},
"counterparty_wallet_directory": {
"type": "object",
"description": "Enterprise IBAN -> 0x Base L2 wallet address map"
},
"seller_pay_to_address": {
"type": "string",
"description": "Fallback recipient Base L2 address"
},
"chain_id": {
"type": "number",
"description": "Target chain ID (default 8453 for Base)"
}
},
"required": [
"instruction"
],
"examples": [
{
"instruction": {
"end_to_end_id": "E2E-1001",
"instructed_amount": {
"currency": "USD",
"amount_str": "250.00",
"amount_minor": "250000000"
},
"debtor": {
"iban": "DE89370400440532013000"
},
"creditor": {
"iban": "DE77100100100123456789"
}
},
"seller_pay_to_address": "0xc59c85e661d34084a7769f955d17fd38254a6235"
}
]
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"standard": {
"type": "string"
},
"intent_template": {
"type": "object"
},
"status": {
"type": "string"
},
"notice": {
"type": "string"
}
},
"required": [
"ok",
"standard",
"intent_template",
"status"
]
}š¢check_price(tool, amount)
Instant zero-cost pricing hook for code402 tools. Returns the live price, an opaque quote_id, TTL, and the settlement URL. Free forever ā feeds the price index into an agent planner's context without creating any financial obligation. If the planner acts on the quote, it hits the settlement_url with an EIP-3009 signed voucher.
Input Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string",
"description": "Target tool name (e.g. 'iban-check', 'vendor-onboarding-pack')"
},
"amount": {
"type": "number",
"description": "Optional batch count or volume units (default 1)"
}
},
"required": [
"tool"
],
"examples": [
{
"tool": "iban-check",
"amount": 1
}
]
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"valid": {
"type": "boolean"
},
"price": {
"type": "number"
},
"currency": {
"type": "string"
},
"quote_id": {
"type": "string"
},
"ttl_ms": {
"type": "number"
},
"settlement_url": {
"type": "string"
},
"scope": {
"type": "string"
}
},
"required": [
"tool",
"valid",
"price",
"quote_id",
"settlement_url"
]
}š¢receipt_verify(receipt)
Verifies a signed XDR-1 receipt from ANY x402 service: recomputes the canonical digest and recovers the signer, then compares it to the declared signer. Free forever ā no account, no quota, no storage (stateless). A valid receipt proves the signer signed that tool call at that timestamp; it does NOT prove funds moved or any business claim.
Input Schema
{
"type": "object",
"properties": {
"receipt": {
"type": "string",
"description": "The full XDR-1 receipt object: v, tool, tool_version, input_hash, output_hash, payer, recipient, amount, nonce, ts, tier, signer, signature (optional successor/stream_state)."
}
},
"required": [
"receipt"
],
"examples": [
{
"receipt": {
"v": "XDR-1",
"tool": "iban-check",
"tool_version": "1",
"input_hash": "0xā¦",
"output_hash": "0xā¦",
"payer": "0xc59c85e661d34084a7769f955d17fd38254a6235",
"recipient": "0xc59c85e661d34084a7769f955d17fd38254a6235",
"amount": "0",
"nonce": "0xā¦",
"ts": 0,
"tier": "free",
"signer": "0xa036e2e3e19c6d02f30b3a9eb0acd057e6d9a5c8",
"signature": "0xā¦"
}
}
]
}Output Schema
{
"type": "object",
"properties": {
"valid": {
"type": "boolean"
},
"signer_recovered": {
"type": "string"
},
"declared_signer": {
"type": "string"
},
"digest": {
"type": "string"
},
"canonical": {
"type": "string"
},
"scope": {
"type": "string"
}
}
}Community
Evidence
Recent observations
verifiedversion not recorded57 tools
failed observationversion not recordedā
verifiedversion not recorded24 tools
failed observationversion not recordedā
verifiedversion not recorded24 tools
failed observationversion not recordedā
verifiedversion not recorded13 tools
failed observationversion not recordedā
verifiedversion not recorded12 tools
verifiedversion not recorded10 tools