MCP Server

code402

io.github.89rat/code402
Legal & Compliance Payments & Fintech Public & reachable MCP 2025-11-25

What this MCP does

Provides machine-payable API utilities including currency conversion, pricing checks, IBAN, LEI, VAT, and OFAC validation.

batch_validate
Batch Identifier Checks (up to 50 items)
Run up to 50 supported {tool, value} checks in one request. Each result states its scope. Compare the current batch quote with individual quotes; savings depend on batch size.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'items': [{'tool': 'iban-check', 'value': 'GB82 WEST 1234 5698 7654 32'}, {'tool': 'lei-check', 'value': '529900T8BM49AURSDO55'}, {'tool': 'vat-mod97-check', 'value': 'BE0417497106'}]}], 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['tool', 'value'], 'properties': {'tool': {'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'], 'type': 'string', 'description': 'which validator to run'}, 'value': {'type': 'string', 'description': 'the identifier (or text, for context-distill) to check'}}}, 'maxItems': 50, 'minItems': 1, 'description': 'List of {tool, value} checks (max 50).'}}}
Output schema
{'type': 'object', 'required': ['count', 'results'], 'properties': {'tool': {'type': 'string'}, 'count': {'type': 'number'}, 'scope': {'type': 'string'}, 'results': {'type': 'array'}, 'valid_count': {'type': 'number'}, 'invalid_count': {'type': 'number'}}}
check_price
Zero-cost price index and gasless x402 quote generator
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'tool': 'iban-check', 'amount': 1}], 'required': ['tool'], '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)'}}}
Output schema
{'type': 'object', 'required': ['tool', 'valid', 'price', 'quote_id', 'settlement_url'], 'properties': {'tool': {'type': 'string'}, 'price': {'type': 'number'}, 'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'ttl_ms': {'type': 'number'}, 'currency': {'type': 'string'}, 'quote_id': {'type': 'string'}, 'settlement_url': {'type': 'string'}}}
gstin_check
GSTIN check (India)
Validate an Indian GSTIN by structure (2-digit state code + PAN + entity code + 'Z') and its mod-36 cross-sum checksum.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'gstin': '27AAPFU0939F1ZV'}], 'required': ['gstin'], 'properties': {'gstin': {'type': 'string', 'description': '15-character Indian Goods and Services Tax Identification Number.'}}}
Output schema
{'type': 'object', 'required': ['valid', 'reason'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'country': {'type': 'string'}, 'normalized': {'type': 'string'}}}
iban_check
IBAN Structure and Checksum Check
Validate IBAN structure and MOD-97 checksum. Does not establish account ownership, beneficiary identity or absence of fraud.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'iban': 'GB82 WEST 1234 5698 7654 32'}], 'required': ['iban'], 'properties': {'iban': {'type': 'string', 'description': 'IBAN to validate; spaces allowed.'}}}
Output schema
{'type': 'object', 'required': ['valid', 'reason'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'country': {'type': 'string'}, 'normalized': {'type': 'string'}}}
ifsc_check
IFSC Format Check
Check the 11-character Indian IFSC format, including its fifth-character zero. No bank-branch registry lookup or account verification.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'ifsc': 'HDFC0000123'}], 'required': ['ifsc'], 'properties': {'ifsc': {'type': 'string', 'description': '11-character Indian Financial System Code.'}}}
Output schema
{'type': 'object', 'required': ['valid', 'reason'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'country': {'type': 'string'}, 'normalized': {'type': 'string'}}}
india_supplier_check
India Supplier Verification Pack
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'pan': 'AAACP1234M', 'vpa': 'merchant@okhdfcbank', 'ifsc': 'HDFC0001234', 'gstin': '27AAPFU0939F1ZV'}], 'required': [], 'properties': {'pan': {'type': 'string', 'description': 'PAN (10 chars, optional)'}, 'vpa': {'type': 'string', 'description': 'UPI VPA handle (optional)'}, 'ifsc': {'type': 'string', 'description': 'IFSC bank code (optional)'}, 'gstin': {'type': 'string', 'description': 'GSTIN (15 chars, optional)'}}}
Output schema
{'type': 'object', 'required': ['checked_count', 'all_valid'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'results': {'type': 'array'}, 'verdict': {'type': 'string'}, 'corridor': {'type': 'string'}, 'all_valid': {'type': 'boolean'}, 'next_steps': {'type': 'string'}, 'checked_count': {'type': 'number'}}}
lei_check
LEI Structure and Checksum Check
Validate a 20-character LEI and MOD-97 check digits. No registry lookup, active-registration check or legal-entity identity verification.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'lei': '529900T8BM49AURSDO55'}], 'required': ['lei'], 'properties': {'lei': {'type': 'string', 'description': '20-character Legal Entity Identifier.'}}}
Output schema
{'type': 'object', 'required': ['valid', 'reason'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'country': {'type': 'string'}, 'normalized': {'type': 'string'}}}
pre_disbursement_guard
Counterparty Risk Indicators
Evaluate supplied identifiers, domain-age evidence and mismatch signals. Requires a preceding receipt hash. An advisory result is not verified identity, fraud clearance or authorization to release funds.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'vendor_domain': 'billing@acme-consulting.co.uk', 'company_number': '01234567', 'recipient_iban': 'GB82WEST12345698765432', 'declared_country': 'GB', 'invoice_amount_usd': 4500}], 'required': [], 'properties': {'lei': {'type': 'string', 'description': 'ISO 17442 Legal Entity Identifier (optional).'}, 'vat_number': {'type': 'string', 'description': 'EU VAT number (optional).'}, 'vendor_domain': {'type': 'string', 'description': 'Vendor website domain or invoicing email address (optional).'}, 'company_number': {'type': 'string', 'description': 'Official corporate registration number, e.g. UK Companies House 8 digits/chars (optional).'}, 'recipient_iban': {'type': 'string', 'description': 'Recipient bank IBAN (optional).'}, 'declared_country': {'type': 'string', 'description': "2-letter ISO country code where vendor claims to be registered (optional, e.g. 'GB', 'US', 'DE')."}, 'physical_address': {'type': 'string', 'description': 'Vendor physical office address (optional).'}, 'invoice_amount_usd': {'type': 'number', 'description': 'Disbursement transaction amount in USD (optional).'}}}
Output schema
{'type': 'object', 'required': ['clear_to_disburse', 'risk_level', 'risk_score', 'decision'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'checks': {'type': 'object'}, 'summary': {'type': 'string'}, 'decision': {'type': 'string'}, 'risk_level': {'type': 'string'}, 'risk_score': {'type': 'number'}, 'flags_triggered': {'type': 'array'}, 'recommendations': {'type': 'array'}, 'clear_to_disburse': {'type': 'boolean'}, 'inspected_counterparty': {'type': 'object'}}}
receipt_verify
Verify any XDR-1 receipt — free, stateless, any issuer
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'receipt': {'v': 'XDR-1', 'ts': 0, 'tier': 'free', 'tool': 'iban-check', 'nonce': '0x…', 'payer': '0xc59c85e661d34084a7769f955d17fd38254a6235', 'amount': '0', 'signer': '0xa036e2e3e19c6d02f30b3a9eb0acd057e6d9a5c8', 'recipient': '0xc59c85e661d34084a7769f955d17fd38254a6235', 'signature': '0x…', 'input_hash': '0x…', 'output_hash': '0x…', 'tool_version': '1'}}], 'required': ['receipt'], '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).'}}}
Output schema
{'type': 'object', 'properties': {'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'digest': {'type': 'string'}, 'canonical': {'type': 'string'}, 'declared_signer': {'type': 'string'}, 'signer_recovered': {'type': 'string'}}}
sanctions_address_screen
OFAC SDN & Sanctions List Edge Screener
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.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'subject': '0x7f367cc41522ce07553e823bf3be79a889debe1b'}], 'required': ['subject'], 'properties': {'subject': {'type': 'string', 'description': 'EVM address (0x...) or ISO 3166-1 country code / jurisdiction name'}}}
Output schema
{'type': 'object', 'required': ['tool', 'valid', 'is_sanctioned'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'subject': {'type': 'string'}, 'match_type': {'type': 'string'}, 'is_sanctioned': {'type': 'boolean'}, 'sanction_program': {'type': 'string'}}}
swift_bic_check
SWIFT/BIC Structure Check
Check SWIFT/BIC structure and country code. Does not establish bank existence, active routing or beneficiary identity.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'bic': 'DEUTDEFF500'}], 'required': ['bic'], 'properties': {'bic': {'type': 'string', 'description': 'SWIFT/BIC code, 8 or 11 characters; spaces/dashes allowed.'}}}
Output schema
{'type': 'object', 'required': ['valid', 'reason'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'country': {'type': 'string'}, 'normalized': {'type': 'string'}}}
vat_mod97_check
Belgian VAT MOD-97 Check
Check the supported Belgian VAT format and MOD-97 checksum. BE only; not VIES, other EU VAT formats, registration status or tax compliance.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'vat_number': 'BE0417497106'}], 'required': ['vat_number'], 'properties': {'vat_number': {'type': 'string', 'description': 'Belgian VAT id in the supported BE mod-97 format (BE prefix optional); not a VIES lookup.'}}}
Output schema
{'type': 'object', 'required': ['valid', 'reason'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'valid': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'country': {'type': 'string'}, 'normalized': {'type': 'string'}}}
vendor_onboarding_pack
Vendor Identifier Check Pack
Check supplied IBAN, LEI, Belgian VAT and UK company-number fields in one result. Structural checks only; no ownership, registry or fraud clearance.
Read only Open world Idempotent
Input schema
{'type': 'object', 'examples': [{'lei': '529900T8BM49AURSDO55', 'iban': 'GB82 WEST 1234 5698 7654 32', 'vat_number': 'BE0417497106', 'company_number': '12345678'}], 'required': [], 'properties': {'lei': {'type': 'string', 'description': 'Vendor LEI (optional).'}, 'iban': {'type': 'string', 'description': 'Vendor IBAN (optional).'}, 'vat_number': {'type': 'string', 'description': 'Vendor VAT number, BE mod-97 (optional).'}, 'company_number': {'type': 'string', 'description': 'Vendor UK company number (optional).'}}}
Output schema
{'type': 'object', 'required': ['checked_count', 'all_valid'], 'properties': {'tool': {'type': 'string'}, 'scope': {'type': 'string'}, 'results': {'type': 'array'}, 'verdict': {'type': 'string'}, 'all_valid': {'type': 'boolean'}, 'checked_count': {'type': 'number'}}}
Changed
ifsc_check
Oct. 5, 2026, 2:44 a.m.
Changed
pre_disbursement_guard
Oct. 5, 2026, 2:44 a.m.
Changed
vendor_onboarding_pack
Oct. 5, 2026, 2:44 a.m.
Changed
batch_validate
Oct. 5, 2026, 2:44 a.m.
Changed
swift_bic_check
Oct. 5, 2026, 2:44 a.m.
Changed
vat_mod97_check
Oct. 5, 2026, 2:44 a.m.
Changed
lei_check
Oct. 5, 2026, 2:44 a.m.
Changed
iban_check
Oct. 5, 2026, 2:44 a.m.
Restored
check_price
Oct. 1, 2026, 2:44 a.m.
Changed
receipt_verify
Sept. 29, 2026, 2:51 a.m.
Changed
sanctions_address_screen
Sept. 29, 2026, 2:51 a.m.
Changed
swift_bic_check
Sept. 29, 2026, 2:51 a.m.
Changed
ifsc_check
Sept. 29, 2026, 2:51 a.m.
Changed
gstin_check
Sept. 29, 2026, 2:51 a.m.
Changed
vat_mod97_check
Sept. 29, 2026, 2:51 a.m.
Changed
lei_check
Sept. 29, 2026, 2:51 a.m.
Changed
iban_check
Sept. 29, 2026, 2:51 a.m.
Changed
batch_validate
Sept. 29, 2026, 2:51 a.m.
Changed
pre_disbursement_guard
Sept. 29, 2026, 2:51 a.m.
Changed
india_supplier_check
Sept. 29, 2026, 2:51 a.m.
Changed
vendor_onboarding_pack
Sept. 29, 2026, 2:51 a.m.
Removed
vat_validate
Sept. 27, 2026, 2:43 a.m.
Removed
simulate_economics
Sept. 27, 2026, 2:43 a.m.
Removed
screen_ofac
Sept. 27, 2026, 2:43 a.m.
Removed
lei_lookup
Sept. 27, 2026, 2:43 a.m.
Removed
create_invitation
Sept. 27, 2026, 2:43 a.m.
Removed
check_price
Sept. 27, 2026, 2:43 a.m.
Removed
calculate_fx
Sept. 27, 2026, 2:43 a.m.
Added
receipt_verify
Sept. 27, 2026, 2:43 a.m.
Added
sanctions_address_screen
Sept. 27, 2026, 2:43 a.m.