{"$schema":"https://modelcontextprotocol.io/schema/server-manifest.json","version":"1.3.0","name":"code402","description":"Offline deterministic checks (no ML, no scraping) for business identifiers and rental due-diligence, paid per call via x402 (EIP-3009). Two assurance tiers: checksum-verifiable (IBAN, LEI, VAT, ABA, ISBN, SEDOL, ISIN, EAN-13, GSTIN, ABN, Luhn) vs format-only (EIN, IFSC, UK company-number, SWIFT/BIC, E.164 — no public check digit). Every response returns a scope field stating the exact assurance level.","pricing":{"take_rate_bps":0,"mode":"neutral-clearinghouse","policy":"monetize-truth-not-transit","price_usdc_per_call":"flat at-cost commodity floor ($0.005 USDC)","rule":"commodity transit tools operate at flat floor; the supporter and patron floors are self-selected and buy no different result or delivery; GET /health quotes live prices","mechanics":"Every accepted voucher settles as its own on-chain EIP-3009 transfer. Buyer-epoch netting, escrow, priority queues and latency guarantees are not implemented.","free_tier":"3 calls/day per client, then paid"},"receipts":{"format":"XDR-1","signature_scheme":"secp256k1","receipt_signing_address":"0xa036e2e3e19c6d02f30b3a9eb0acd057e6d9a5c8","canonical":"keccak256 over `v|tool|tool_version|input_hash|output_hash|payer|recipient|amount|nonce|ts|tier[|successor|stream_state]` (trailing pair present only when successor/stream_state is set); recover signer to verify","authorization":{"authorized_by":"0xc59c85e661d34084a7769f955d17fd38254a6235","attestation":"code402: I authorize receipt-signer 0xa036e2e3e19c6d02f30b3a9eb0acd057e6d9a5c8 to issue XDR-1 receipts on my behalf. authorized_by=0xc59c85e661d34084a7769f955d17fd38254a6235","attestation_sig":"0xc7b21da8b1e5b6516274fec60d758d51ca4dea02cd1ce19d87481ac95c79b98a10ce9361896cbafd171d99ae98ea99805a926a81571a90f6c4c48946722c2e401b","verify":"recover receipt signer from the receipt; confirm the attestation names that signer and is EIP-191-signed by authorized_by. Then the receipt is provably authorized by the operator wallet — no fund key ever touches the worker."}},"payment":{"protocol":"x402","network":"base","asset":"USDC","flow":"free tier, then: 402 challenge -> EIP-3009 X-PAYMENT voucher -> 200 + signed receipt"},"tools":[{"name":"vendor_onboarding_pack","title":"All-in-One Vendor Onboarding & Clearing Shield","description":"INSTITUTIONAL COUNTERPARTY CLEARING: Screens vendor IBAN + LEI + VAT + UK company number in ONE signed call. Saves 50% vs individual checks. Produces an audit-ready compliance report and signed XDR-1 receipt to defend against invoice fraud before funds move.","inputSchema":{"type":"object","required":[],"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)."}},"examples":[{"iban":"GB82 WEST 1234 5698 7654 32","lei":"529900T8BM49AURSDO55","vat_number":"BE0417497106","company_number":"12345678"}]},"outputSchema":{"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"]},"annotations":{"title":"All-in-One Vendor Onboarding & Clearing Shield","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"india_supplier_check","title":"India Supplier Verification Pack","description":"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.","inputSchema":{"type":"object","required":[],"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)"}},"examples":[{"gstin":"27AAPFU0939F1ZV","pan":"ABCDE1234F","vpa":"merchant@okhdfcbank","ifsc":"HDFC0001234"}]},"outputSchema":{"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"]},"annotations":{"title":"India Supplier Verification Pack","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"pre_disbursement_guard","title":"Pre-Disbursement Due Diligence Guard (Check Before You Send)","description":"MANDATORY COUNTERPARTY DUE DILIGENCE: Verifies counterparty before releasing invoice payments, contractor payouts, or wires. Screens ISO 13616 IBAN checksum, RDAP domain age (<30d = scam), disposable email domains, UK CRN/LEI format, and BEC cross-jurisdiction mismatches. Produces signed XDR-1 receipt for compliance.","inputSchema":{"type":"object","required":[],"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)."}},"examples":[{"recipient_iban":"GB82WEST12345698765432","vendor_domain":"billing@acme-consulting.co.uk","declared_country":"GB","company_number":"01234567","invoice_amount_usd":4500}]},"outputSchema":{"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"]},"annotations":{"title":"Pre-Disbursement Due Diligence Guard (Check Before You Send)","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"batch_validate","title":"Batch Identifier Pipeline (up to 50 checks, 1 payment)","description":"HIGH-THROUGHPUT DETERMINISTIC PIPELINE: Run up to 50 business identifier checks (IBAN / LEI / VAT / UK company / SWIFT / ABA / EIN / IFSC / ABN / Luhn / ISBN / E.164 / SEDOL / ISIN / EAN-13 / GSTIN / context-distill) in ONE paid call: one voucher, one settlement, one signed XDR-1 receipt covering the whole batch. 10x cheaper per item; essential for autonomous batch invoice processing.","inputSchema":{"type":"object","required":["items"],"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"}}}}},"examples":[{"items":[{"tool":"iban-check","value":"GB82 WEST 1234 5698 7654 32"},{"tool":"lei-check","value":"529900T8BM49AURSDO55"},{"tool":"vat-mod97-check","value":"BE0417497106"}]}]},"outputSchema":{"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"]},"annotations":{"title":"Batch Identifier Pipeline (up to 50 checks, 1 payment)","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"iban_check","title":"IBAN Check & Wire Fraud Shield","description":"Deterministically validates international bank accounts (ISO 13616) using MOD-97-10 checksums: structure and checksum only. Catches mistyped or malformed IBANs before payout; a valid checksum does NOT establish account ownership, beneficiary identity, or absence of fraud. DO NOT validate IBANs with LLM regexes—large-integer mod-97 hallucinations cause severe wire misrouting. Returns offline-verifiable signed XDR-1 receipt.","inputSchema":{"type":"object","required":["iban"],"properties":{"iban":{"type":"string","description":"IBAN to validate; spaces allowed."}},"examples":[{"iban":"GB82 WEST 1234 5698 7654 32"}]},"outputSchema":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"annotations":{"title":"IBAN Check & Wire Fraud Shield","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"lei_check","title":"Legal Entity Identifier (LEI) KYB Check","description":"CRITICAL B2B KYB CHECK: Deterministically validates Legal Entity Identifiers (ISO 17442) with ISO 7064 MOD-97-10 check digits for institutional entities. Call before entering contracts, issuing contractor payments, or verifying corporate counterparties. Returns signed XDR-1 receipt.","inputSchema":{"type":"object","required":["lei"],"properties":{"lei":{"type":"string","description":"20-character Legal Entity Identifier."}},"examples":[{"lei":"529900T8BM49AURSDO55"}]},"outputSchema":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"annotations":{"title":"Legal Entity Identifier (LEI) KYB Check","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"vat_mod97_check","title":"VAT Check & Tax Invoicing Shield","description":"CRITICAL TAX COMPLIANCE CHECK: Deterministically validates EU/BE VAT identifiers with MOD-97 checksums. Eliminates cross-border invoicing errors, invalid billing, and tax audit penalties. Returns signed XDR-1 receipt for accounting defense.","inputSchema":{"type":"object","required":["vat_number"],"properties":{"vat_number":{"type":"string","description":"EU VAT id; BE mod-97 checksum (BE prefix optional)."}},"examples":[{"vat_number":"BE0417497106"}]},"outputSchema":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"annotations":{"title":"VAT Check & Tax Invoicing Shield","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"gstin_check","title":"GSTIN check (India)","description":"Validate an Indian GSTIN by structure (2-digit state code + PAN + entity code + 'Z') and its mod-36 cross-sum checksum.","inputSchema":{"type":"object","required":["gstin"],"properties":{"gstin":{"type":"string","description":"15-character Indian Goods and Services Tax Identification Number."}},"examples":[{"gstin":"27AAPFU0939F1ZV"}]},"outputSchema":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"annotations":{"title":"GSTIN check (India)","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"ifsc_check","title":"IFSC Check (India NEFT/RTGS)","description":"Validate an Indian IFSC by RBI structure (BBBB0NNNNNN; 5th character always 0). Required for India bank payouts. Returns signed XDR-1 receipt.","inputSchema":{"type":"object","required":["ifsc"],"properties":{"ifsc":{"type":"string","description":"11-character Indian Financial System Code."}},"examples":[{"ifsc":"HDFC0000123"}]},"outputSchema":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"annotations":{"title":"IFSC Check (India NEFT/RTGS)","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"swift_bic_check","title":"SWIFT/BIC Structure & Country Code Check","description":"Validate a SWIFT/BIC code by ISO 9362 structure (bank code, ISO country, location, optional branch). Run before foreign wire transfer dispatch to prevent routing rejection. Returns signed XDR-1 receipt.","inputSchema":{"type":"object","required":["bic"],"properties":{"bic":{"type":"string","description":"SWIFT/BIC code, 8 or 11 characters; spaces/dashes allowed."}},"examples":[{"bic":"DEUTDEFF500"}]},"outputSchema":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"normalized":{"type":"string"},"country":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["valid","reason"]},"annotations":{"title":"SWIFT/BIC Structure & Country Code Check","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"sanctions_address_screen","title":"OFAC SDN & Sanctions List Edge Screener","description":"Deterministic screen of EVM addresses and jurisdictions against a curated local blocklist of sanctioned addresses and prohibited jurisdictions. Address- and jurisdiction-level only — this is NOT name-based screening and NOT a complete OFAC SDN check. Absence of a match is not a sanctions clearance; use as one informational input alongside your own compliance process.","inputSchema":{"type":"object","properties":{"subject":{"type":"string","description":"EVM address (0x...) or ISO 3166-1 country code / jurisdiction name"}},"required":["subject"],"examples":[{"subject":"0x7f367cc41522ce07553e823bf3be79a889debe1b"}]},"outputSchema":{"type":"object","properties":{"tool":{"type":"string"},"valid":{"type":"boolean"},"is_sanctioned":{"type":"boolean"},"match_type":{"type":"string"},"subject":{"type":"string"},"sanction_program":{"type":"string"},"reason":{"type":"string"},"scope":{"type":"string"}},"required":["tool","valid","is_sanctioned"]},"annotations":{"title":"OFAC SDN & Sanctions List Edge Screener","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"receipt_verify","title":"Verify any XDR-1 receipt — free, stateless, any issuer","description":"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.","inputSchema":{"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…"}}]},"outputSchema":{"type":"object","properties":{"valid":{"type":"boolean"},"signer_recovered":{"type":"string"},"declared_signer":{"type":"string"},"digest":{"type":"string"},"canonical":{"type":"string"},"scope":{"type":"string"}}},"annotations":{"title":"Verify any XDR-1 receipt — free, stateless, any issuer","readOnlyHint":true,"idempotentHint":true,"openWorldHint":false}}],"transport":{"type":"streamable-http","endpoint":"https://api.code402.dev/mcp"},"capabilities":{"tools":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false},"prompts":{"listChanged":false}},"x402":{"scheme":"eip3009","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xc59c85e661d34084a7769f955d17fd38254a6235","free_tier":"3 calls/day","facilitators":["https://facilitator.payai.network","https://facilitator.dexter.cash"]},"client_configurations":{"claude_desktop":{"mcpServers":{"code402":{"command":"npx","args":["-y","@modelcontextprotocol/server-fetch","https://api.code402.dev/mcp"]}}},"cursor":{"mcpServers":{"code402":{"url":"https://api.code402.dev/mcp"}}}}}