MCP Server

SafeRoute

io.github.crystalsignal/saferoute
Crypto & Web3 Payments & Fintech Security Public & reachable MCP 2025-11-25

What this MCP does

Provides safety checks, simulation, routing, and intent verification for noncustodial USDC payments and swaps on Base.

check_base_swap
Wallet-free approved-token Base swap safety preflight. Costs $0.001 USDC.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'from': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'amount': {'type': 'string'}, 'intentId': {'type': 'string'}, 'referralCode': {'type': 'string'}, 'sourceAgentId': {'type': 'string'}}}
check_token_risk
Approved Base token risk and liquidity check. Costs $0.03 USDC.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'intentId': {'type': 'string', 'maxLength': 128, 'minLength': 16}, 'referralCode': {'type': 'string', 'maxLength': 64, 'minLength': 3}, 'sourceAgentId': {'type': 'string', 'maxLength': 128, 'minLength': 1}}}
check_wallet_risk
Read-only Base wallet account-posture check. Costs $0.01 USDC.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['wallet'], 'properties': {'wallet': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'intentId': {'type': 'string', 'maxLength': 128, 'minLength': 16}, 'referralCode': {'type': 'string', 'maxLength': 64, 'minLength': 3}, 'sourceAgentId': {'type': 'string', 'maxLength': 128, 'minLength': 1}}}
get_safe_swap_quote
Safety-checked noncustodial Base swap quote. Costs $0.01 USDC; the buyer signs and broadcasts.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to', 'amount', 'wallet'], 'properties': {'to': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'from': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'amount': {'type': 'string'}, 'wallet': {'type': 'string'}, 'intentId': {'type': 'string'}, 'referralCode': {'type': 'string'}, 'executionMode': {'enum': ['standard', 'gasless'], 'type': 'string'}, 'sourceAgentId': {'type': 'string'}}}
guard_base_trade
Complete pre-sign trade guard with route and simulation evidence. Costs $0.12 USDC.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['from', 'to', 'amount', 'wallet'], 'properties': {'to': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'from': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'amount': {'type': 'string', 'pattern': '^\\d+(?:\\.\\d+)?$'}, 'wallet': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'intentId': {'type': 'string', 'maxLength': 128, 'minLength': 16}, 'referralCode': {'type': 'string', 'maxLength': 64, 'minLength': 3}, 'executionMode': {'type': 'string', 'const': 'standard'}, 'sourceAgentId': {'type': 'string', 'maxLength': 128, 'minLength': 1}}}
list_supported_assets
List SafeRoute's seven approved Base assets, limits, fees, and execution modes. Free.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
preflight_transaction
Decode and simulate approved Base ERC-20 calldata or SafeRoute's exact official ERC-8004 registration. Costs $0.05 USDC.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['transaction'], 'properties': {'intentId': {'type': 'string', 'maxLength': 128, 'minLength': 16}, 'transaction': {'type': 'object', 'required': ['from', 'to', 'data'], 'properties': {'to': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'data': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]+$'}, 'from': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'value': {'type': 'string', 'pattern': '^\\d+$'}}}, 'referralCode': {'type': 'string', 'maxLength': 64, 'minLength': 3}, 'sourceAgentId': {'type': 'string', 'maxLength': 128, 'minLength': 1}}}
prepare_token_transfer
Prepare a bounded, simulated unsigned Base token transfer. Costs $0.10 USDC.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token', 'amount', 'sender', 'recipient'], 'properties': {'token': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'amount': {'type': 'string', 'pattern': '^\\d+(?:\\.\\d+)?$'}, 'sender': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'intentId': {'type': 'string', 'maxLength': 128, 'minLength': 16}, 'recipient': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'referralCode': {'type': 'string', 'maxLength': 64, 'minLength': 3}, 'sourceAgentId': {'type': 'string', 'maxLength': 128, 'minLength': 1}}}
protect_payment
One automatic x402 payment-safety front door: pre-payment ALLOW/BLOCK, duplicate-safe ID binding, policy risk reasons, and optional mined-settlement verification. Free and rate-limited; the buyer signs and pays.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['idempotencyKey', 'payment'], 'properties': {'payment': {'type': 'object', 'required': ['payer', 'paymentRequired'], 'properties': {'payer': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'policy': {'type': 'object', 'properties': {'allowedHosts': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 100}, 'allowedPayees': {'type': 'array', 'items': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'maxItems': 100}, 'blockedPayees': {'type': 'array', 'items': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'maxItems': 100}, 'maxAmountAtomic': {'type': 'string', 'pattern': '^\\d+$'}, 'reviewAboveAmountAtomic': {'type': 'string', 'pattern': '^\\d+$'}}, 'additionalProperties': False}, 'referralCode': {'type': 'string', 'maxLength': 64, 'minLength': 3}, 'sourceAgentId': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'paymentRequired': {'type': 'object', 'required': ['x402Version', 'resource', 'accepts'], 'properties': {'accepts': {'type': 'array', 'items': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'payTo': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'amount': {'type': 'string', 'pattern': '^\\d+$'}, 'scheme': {'type': 'string', 'maxLength': 32, 'minLength': 1}, 'network': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'maxTimeoutSeconds': {'type': 'integer', 'maximum': 3600, 'minimum': 1}}, 'additionalProperties': {}}, 'maxItems': 20, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': {}}, 'x402Version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'additionalProperties': False}, 'settlement': {'type': 'object', 'properties': {'transactionHash': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{64}$'}, 'paymentResponseHeader': {'type': 'string', 'maxLength': 8192, 'minLength': 1}}, 'additionalProperties': False}, 'idempotencyKey': {'type': 'string', 'pattern': '^[a-zA-Z0-9._:-]+$', 'maxLength': 128, 'minLength': 16}}}
prove_safe_action
Create a signed pre-sign ALLOW, BLOCK, or REVIEW receipt. Costs $0.05 USDC.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action'], 'properties': {'to': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'from': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'token': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'action': {'enum': ['trade', 'transaction', 'token'], 'type': 'string'}, 'amount': {'type': 'string', 'pattern': '^\\d+(?:\\.\\d+)?$'}, 'wallet': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'intentId': {'type': 'string', 'maxLength': 128, 'minLength': 16}, 'transaction': {'type': 'object', 'required': ['from', 'to', 'data'], 'properties': {'to': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'data': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]+$'}, 'from': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'value': {'type': 'string', 'pattern': '^\\d+$'}}}, 'referralCode': {'type': 'string', 'maxLength': 64, 'minLength': 3}, 'executionMode': {'type': 'string', 'const': 'standard'}, 'sourceAgentId': {'type': 'string', 'maxLength': 128, 'minLength': 1}}}
route_agent_payment
Prepare a bounded, simulated exact-buy route to a payer-owned Base USDC target covering the x402 payment and optional buffer. Costs $0.05 USDC; buyer confirms funding, then retries standard x402 once.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['request'], 'properties': {'request': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
verify_swap_execution
Verify a standard-mode SafeRoute Base execution against its signed receipt. Free; referral payouts remain disabled.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['transactionHash', 'receipt', 'receiptSignature'], 'properties': {'receipt': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'transactionHash': {'type': 'string'}, 'receiptSignature': {'type': 'string'}}}
verify_transaction_intent
Compare a mined Base transaction with buyer intent. Costs $0.05 USDC.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['transactionHash', 'intent'], 'properties': {'intent': {'type': 'object', 'required': ['sender', 'recipient', 'sellToken', 'buyToken', 'sellAmount', 'minimumBuyAmount'], 'properties': {'sender': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'buyToken': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'recipient': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'sellToken': {'enum': ['USDC', 'WETH', 'EURC', 'CBETH', 'CBBTC', 'VIRTUAL', 'AERO'], 'type': 'string'}, 'sellAmount': {'type': 'string', 'pattern': '^\\d+(?:\\.\\d+)?$'}, 'expectedTarget': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'minimumBuyAmount': {'type': 'string', 'pattern': '^\\d+(?:\\.\\d+)?$'}, 'expectedBuyAmount': {'type': 'string', 'pattern': '^\\d+(?:\\.\\d+)?$'}, 'expectedCalldataHash': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{64}$'}}}, 'intentId': {'type': 'string', 'maxLength': 128, 'minLength': 16}, 'referralCode': {'type': 'string', 'maxLength': 64, 'minLength': 3}, 'sourceAgentId': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'transactionHash': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{64}$'}}}
Added
list_supported_assets
Sept. 17, 2026, 12:41 p.m.
Added
route_agent_payment
Sept. 17, 2026, 12:41 p.m.
Added
verify_swap_execution
Sept. 17, 2026, 12:41 p.m.
Added
verify_transaction_intent
Sept. 17, 2026, 12:41 p.m.
Added
guard_base_trade
Sept. 17, 2026, 12:41 p.m.
Added
prepare_token_transfer
Sept. 17, 2026, 12:41 p.m.
Added
preflight_transaction
Sept. 17, 2026, 12:41 p.m.
Added
check_token_risk
Sept. 17, 2026, 12:41 p.m.
Added
check_wallet_risk
Sept. 17, 2026, 12:41 p.m.
Added
prove_safe_action
Sept. 17, 2026, 12:41 p.m.
Added
get_safe_swap_quote
Sept. 17, 2026, 12:41 p.m.
Added
check_base_swap
Sept. 17, 2026, 12:41 p.m.
Added
protect_payment
Sept. 17, 2026, 12:41 p.m.