{"schemaVersion":"1.0.0","name":"verify402","title":"verify402 — Machine-Payable Truth Service for AI Agents","description":"Free fail-closed pre-signing gate plus x402-payable on-chain truth verification: arbitrage reality, token safety, execution book, quote fairness, and trade capacity measured at pinned blocks.","version":"1.1.2","license":"Apache-2.0","canonicalUrl":"https://vex402.online","repository":{"url":"https://github.com/a32116150-ctrl/verify402","type":"git","subfolder":"mcp-bridge"},"documentation":{"homepage":"https://vex402.online/","quickstart":"https://vex402.online/start","docs":"https://vex402.online/docs","mcp":"https://vex402.online/mcp","preflight":"https://vex402.online/preflight","proof":"https://vex402.online/proof","live":"https://vex402.online/live","openapi":"https://vex402.online/openapi.json","llmsTxt":"https://vex402.online/llms.txt","sitemap":"https://vex402.online/sitemap.xml","serviceManifest":"https://vex402.online/.well-known/verify402.json","x402Manifest":"https://vex402.online/.well-known/x402","agentCard":"https://vex402.online/.well-known/agent-card.json"},"integrations":{"mcp":{"type":"model-context-protocol","transport":"stdio","packageIdentifier":"verify402-mcp","npmUrl":"https://www.npmjs.com/package/verify402-mcp","releaseStatus":"published","publishedVersion":"1.1.2","tarballUrl":"https://registry.npmjs.org/verify402-mcp/-/verify402-mcp-1.1.2.tgz","registryName":"io.github.a32116150-ctrl/verify402-mcp","registryUrl":"https://registry.modelcontextprotocol.io/v0.1/servers/io.github.a32116150-ctrl%2Fverify402-mcp/versions","quickInstallCommand":"npx -y verify402-mcp@1.1.2","tools":[{"name":"preflight_gate","type":"free","description":"Advisory pre-signing check for payments and transactions. Evaluates limits, allowances, recipient and freshness. Returns PASS/CAUTION/BLOCK with HMAC receipt."},{"name":"inspect_402","type":"free","description":"Reads an x402 402 challenge before an agent pays it: price, token, network, payee, bound resource, and a PASS/CAUTION/BLOCK verdict with typed reasons. Read-only fetch; never signs."},{"name":"directory_402","type":"free","description":"Lists the watched public x402 endpoints with their price, network, payee, protocol verdict, sign verdict, and recorded changes."},{"name":"verify_arbitrage","type":"paid","priceUsd":0.05,"description":"Cross-venue arbitrage check using Uniswap QuoterV2 and venue routers at one pinned block. Most common verdict: no_edge."},{"name":"check_token_safety","type":"paid","priceUsd":0.1,"description":"Pre-trade token gate: TRUST/CAUTION/AVOID with contract facts, liquidity analysis, and a quote-based sellability check. Does not execute a transfer; transfer restrictions are listed in notChecked."},{"name":"get_best_route","type":"paid","priceUsd":0.03,"description":"Execution book quoting the pair across every configured venue at one pinned block, best first. Aggregators and unconfigured DEXs are excluded."},{"name":"verify_quote_fairness","type":"paid","priceUsd":0.05,"description":"Audit third-party swap quote against live chain truth: fair / overpaying / too_good_to_be_true."},{"name":"get_trade_depth","type":"paid","priceUsd":0.05,"description":"Position sizing: ladder of trade sizes, measuring impact %, round-trip cost %, and capacityUsd."}],"environmentVariables":[{"name":"VERIFY402_URL","description":"verify402 base URL","default":"https://vex402.online","isRequired":false,"isSecret":false},{"name":"EVM_PRIVATE_KEY","description":"Private key for a dedicated hot wallet. Required only for the 5 paid tools; omit for free-only preflight_gate. This release (verify402-mcp@1.1.2) defaults paid calls to Base Sepolia testnet (eip155:84532) for the public demo. Base mainnet (eip155:8453) is an explicit opt-in for a separate deployment and is not enabled by this release. Fund only Base Sepolia testnet USDC for this demo.","isRequired":false,"isSecret":true},{"name":"VERIFY402_NETWORKS","description":"Comma-separated EVM payment networks the bridge may pay. Default is Base Sepolia testnet (eip155:84532); set eip155:8453 explicitly for Base mainnet. The supported network-to-canonical-asset map is constrained to Base Sepolia and Base mainnet.","isRequired":false,"isSecret":false,"default":"eip155:84532","publishedPackageDefault":"eip155:84532","demoValue":"eip155:84532"},{"name":"MAX_PAYMENT_USD","description":"Client-side spend cap per single payment (default: 0.25)","default":"0.25","isRequired":false,"isSecret":false},{"name":"MAX_DAILY_USD","description":"Client-side spend cap per UTC day across restarts","isRequired":false,"isSecret":false}]},"http":{"type":"rest-json","baseUrl":"https://vex402.online","openapiUrl":"https://vex402.online/openapi.json"}},"paymentRequirements":{"mode":"testnet","scheme":"exact","protocol":"x402 v2","facilitators":["Configured testnet facilitator; the live 402 challenge is authoritative"],"supportedNetworks":[{"id":"eip155:84532","name":"Base Sepolia","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","symbol":"USDC","decimals":6,"payTo":"0xAeEF086DD4e436c69d6d0F684b4c9F43392df9cb"},{"id":"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1","name":"Solana devnet","asset":"4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU","symbol":"USDC","decimals":6,"payTo":"BdcsYodhwWUhLTuL5FJ3m8D4u4wVy8KMw7vAvPVucAbJ"}],"recognizedPaymentAssets":[{"network":"eip155:1","name":"ethereum","tokens":["USDC","USDT","DAI","USDG","WETH"]},{"network":"eip155:42161","name":"arbitrum","tokens":["USDC","USDC.e","USDT","DAI","USDG","WETH"]},{"network":"eip155:8453","name":"base","tokens":["USDC","USDT","DAI","WETH"]},{"network":"eip155:84532","name":"base-sepolia","tokens":["USDC"]},{"network":"eip155:11155111","name":"ethereum-sepolia","tokens":["USDC"]},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"solana-mainnet","tokens":["USDC","USDT","USDG"]},{"network":"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1","name":"solana-devnet","tokens":["USDC"]}],"pricing":{"verify":{"route":"/verify","priceUsd":0.05,"atomicAmountUsdc":"50000"},"safety":{"route":"/safety","priceUsd":0.1,"atomicAmountUsdc":"100000"},"route":{"route":"/route","priceUsd":0.03,"atomicAmountUsdc":"30000"},"quotecheck":{"route":"/quotecheck","priceUsd":0.05,"atomicAmountUsdc":"50000"},"depth":{"route":"/depth","priceUsd":0.05,"atomicAmountUsdc":"50000"}},"settlementHeaders":{"paymentRequired":"WWW-Authenticate: x402","paymentProofHeaders":["x-payment","payment-signature"]}},"freeEndpoints":[{"route":"/preflight","method":"POST","summary":"Free pre-signing PASS/CAUTION/BLOCK gate with HMAC receipt"},{"route":"/preflight/verify","method":"POST","summary":"Validate HMAC, expiry, and optional intent/request bindings"},{"route":"/health","method":"GET","summary":"Liveness and network mode check"},{"route":"/ready","method":"GET","summary":"Deep readiness: verify eth_chainId, then read the latest block within 3s"},{"route":"/info","method":"GET","summary":"Machine-readable capabilities and pricing"},{"route":"/findings","method":"GET","summary":"Recent verifiable market observations"},{"route":"/openapi.json","method":"GET","summary":"OpenAPI 3.1 contract"},{"route":"/llms.txt","method":"GET","summary":"Plain-text contract for LLMs"},{"route":"/sitemap.xml","method":"GET","summary":"XML sitemap"},{"route":"/.well-known/verify402.json","method":"GET","summary":"Canonical service manifest"},{"route":"/.well-known/x402","method":"GET","summary":"x402 capability discovery manifest"},{"route":"/.well-known/agent-card.json","method":"GET","summary":"ERC-8004 agent card"}],"operationalPolicies":{"rateLimits":{"preflight":"60 requests/minute per IP, max concurrency 8","paidEndpoints":"Guarded by x402 payment requirements"},"idempotency":{"header":"x-idempotency-key","description":"Replays a settled verdict at zero cost within a 600s window (max 3 replays). The key is the only credential: no payer identity is read from x-payment or payment-signature, and there is no content-hash companion alias. The key is bound to the canonical request body. Use crypto.randomUUID() or at least 32 URL-safe characters with at least 16 distinct characters; weak keys return 400 weak_idempotency_key. The key is a secret: a leaked key allows replay until the TTL/replay cap. Omitting it keeps normal pay-per-call behavior.","conflictStatus":409,"weakKeyStatus":400,"secret":"Treat the key as a bearer credential. A leaked key allows anyone to replay the settled verdict until the 10-minute window closes or the 3-replay cap is reached.","doesNotGuarantee":"Recovery is not a durable ledger and does not survive a restart; recovery and usage state are process-local and lost on restart/deploy, so it does not prove payment, refund a failed call, cross instances, or replay after the TTL/cap, and it cannot help if the caller lost the key."},"endpoints":{"health":{"path":"/health","method":"GET","liveness":true,"fields":["ok","mode","price","preflight","networks","ready","recoveryStore"]},"ready":{"path":"/ready","method":"GET","deep":true,"successFields":["ok","ready","mode","chainId","blockNumber","latencyMs"],"failureFields":["ok","error","message","requestId","ready","chainId","latencyMs"]}},"statePersistence":{"scope":"process-local","lostOnRestart":true,"appliesTo":["recovery","/usage"],"warning":"Recovery records and /usage counters are process-local: they live only in this process and are lost on restart or deploy. A previously settled idempotency key may be charged again, and usage counts reset. State is not shared across instances."},"requestValidation":{"chainId":"Required on every paid route and every transaction preflight. Missing => 400 missing_chain; wrong type => 400 invalid_chain; unsupported => 400 unsupported_chain. No silent default.","honesty":"Every 200 and typed failure on a paid route includes non-empty checked[] and notChecked[]."},"errors":{"publicCodes":["bad_request","weak_idempotency_key","missing_chain","invalid_chain","unsupported_chain","rate_limited","busy","rpc_unavailable","rpc_rate_limited","internal_error"],"requestId":"Every error response carries requestId and x-request-id; the server log uses the same id.","noProviderDetail":"Provider messages, RPC URLs, and API keys are never returned to callers.","settlementOnFailure":"x402 settlement is cancelled for any response >=400, so a 503 is not charged."},"receipts":{"type":"HMAC-SHA256","defaultTtlSeconds":90,"rangeSeconds":"15-300","binding":"Signed intentHash and requestHash. requestHash is additive within verify402/preflight-receipt@1; older receipts stay signature-valid but are unbound. Receipt-only verification returns intentBound:false and requestBound:false."},"cors":{"discovery":"GET, HEAD, and OPTIONS on free read-only discovery paths allow Access-Control-Allow-Origin: *.","paid":"Paid routes and free writes (/preflight) send no Access-Control-Allow-Origin header. Call them from a server-side client."},"securityHeaders":{"xPoweredBy":false,"xContentTypeOptions":"nosniff","referrerPolicy":"strict-origin-when-cross-origin","xFrameOptions":"DENY","contentSecurityPolicy":"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; font-src https://fonts.gstatic.com; img-src 'self' data: https://mcprush.com; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'"},"shutdown":{"signals":["SIGTERM","SIGINT"],"drainTimeoutEnv":"SHUTDOWN_TIMEOUT_MS","defaultDrainTimeoutMs":10000,"forcedExitCode":1}},"securityBoundaries":{"failClosed":true,"signingAuthority":"Client-side only. Verify402 never holds private keys, executes transactions, or initiates token transfers.","disclaimers":{"verdictPass":"PASS indicates only that verified checks passed at the specified pinned block. It is not a counterparty audit or prompt-injection filter. Consult notChecked list.","verdictTrust":"TRUST indicates the contract facts, liquidity thresholds, and quote-based sellability check passed. It is not a transfer test or a safety guarantee; see notChecked.","noEdge":"Negative arbitrage outcome is the expected truthful result on liquid markets.","financialAdvice":"None of the output constitutes financial, trading, or investment advice."}}}