{"schemaVersion":"1.0.0","protocolVersion":"2024-11-05","name":"unfee-mcp","title":"UnFee — Flat-Rate 1-Credit Base, Ethereum & XRPL JSON-RPC Gateway + True 0% Crypto Checkout","version":"1.3.0","description":"UnFee — Flat-Rate 1-Credit Base, Ethereum & XRPL JSON-RPC Gateway (eth_getLogs = 1 Credit, 250K Free/mo), True 0% Crypto Checkout, Atomic HTTP-200 Proof-of-Delivery x402 API Paywalls, Non-Custodial Escrow & Instant IRS Form 8949 Crypto Tax Engine.","tags":["base-rpc","ethereum-rpc","xrpl-rpc","eth_getLogs","x402","crypto-payments","crypto-tax","escrow","web3","defi"],"x402":true,"x402_supported":true,"serverInfo":{"name":"unfee-mcp","version":"1.3.0","description":"UnFee — Flat-Rate 1-Credit Base, Ethereum & XRPL JSON-RPC Gateway (eth_getLogs = 1 Credit, 250K Free/mo), True 0% Crypto Checkout, Atomic HTTP-200 Proof-of-Delivery x402 API Paywalls, Non-Custodial Escrow & Instant IRS Form 8949 Crypto Tax Engine.","tags":["base-rpc","ethereum-rpc","xrpl-rpc","eth_getLogs","x402","crypto-payments","crypto-tax","escrow","web3","defi"],"x402":true,"x402_supported":true},"author":"UnFee (@unfeexyz) <devrel@unfee.xyz>","homepage":"https://unfee-gateway.unfee.workers.dev/docs","productionOrigin":"https://unfee.xyz","primaryAiOrigin":"https://unfee-gateway.unfee.workers.dev","streamableHttpUrl":"https://unfee.xyz/mcp","streamableHttpMirrorUrl":"https://unfee-gateway.unfee.workers.dev/mcp","rpcAutoFailoverSdkUrl":"https://unfee.xyz/rpc.js","chainlistUrl":"https://unfee.xyz/chainlist.json","remoteMcpConfig":{"mcpServers":{"unfee":{"type":"http","url":"https://unfee.xyz/mcp"}}},"mcpServers":{"unfee":{"command":"npx","args":["-y","unfee-mcp"],"env":{"UNFEE_BASE_URL":"https://unfee-gateway.unfee.workers.dev"}}},"endpoints":{"instantFreeKey":"POST https://unfee-gateway.unfee.workers.dev/api/billing/instant-free-key","freeKeyGet":"GET https://unfee-gateway.unfee.workers.dev/api/keys/free","createCheckoutSession":"POST https://unfee-gateway.unfee.workers.dev/v1/checkout/sessions","x402Settle":"POST https://unfee-gateway.unfee.workers.dev/api/x402/settle","x402DemoSandbox":"GET https://unfee-gateway.unfee.workers.dev/api/x402/demo-resource","xrplVerify":"POST https://unfee-gateway.unfee.workers.dev/api/xrpl/verify","rpcBase":"POST https://api.unfee.xyz/rpc/base","rpcEthereum":"POST https://api.unfee.xyz/rpc/ethereum","rpcEth":"POST https://api.unfee.xyz/rpc/eth","rpcXrpl":"POST https://api.unfee.xyz/rpc/xrpl","rpcAutoFailoverClientJs":"GET https://unfee.xyz/rpc.js","chainlistJson":"GET https://unfee.xyz/chainlist.json","openApi":"https://unfee-gateway.unfee.workers.dev/openapi.json","llmsTxt":"https://unfee-gateway.unfee.workers.dev/llms.txt","llmsFullTxt":"https://unfee-gateway.unfee.workers.dev/llms-full.txt","x402Manifest":"https://unfee-gateway.unfee.workers.dev/.well-known/x402.json","agentCard":"https://unfee-gateway.unfee.workers.dev/.well-known/agent.json","skillMd":"https://unfee-gateway.unfee.workers.dev/skills/low-cost-crypto-transaction/SKILL.md","taxStudio":"https://unfee-gateway.unfee.workers.dev/tax","taxCalculate":"https://unfee-gateway.unfee.workers.dev/api/v1/tax/calculate","x402TaxLotCsv":"https://unfee-gateway.unfee.workers.dev/api/v1/x402/tax-lot-csv"},"toolsCount":14,"tools":["create_payment_link","get_instant_free_rpc_key","compare_payment_fees","get_live_arb_opportunities","verify_transaction","unfee_check_seller_reputation","unfee_pay_with_delivery_proof","unfee_generate_tax_report","base_rpc_request","eth_getLogs_flat_rate","xrpl_rpc_request","ethereum_rpc_request","unfee_trace_x402_wash_filter","unfee_address_guard"],"toolsCatalog":[{"name":"create_payment_link","description":"Create a zero-middleman-fee UnFee payment short link (/to/<wallet>/<amount>/<currency>), hosted checkout URL, dynamic OpenGraph social preview card, scannable SVG QR code, and 1-line HTML embed snippet for Base (USDC, ETH, cbBTC, EURC) or XRPL (XRP, RLUSD).","inputSchema":{"type":"object","properties":{"to":{"type":"string","description":"Recipient wallet address (Base 0x..., XRPL r..., or ENS vitalik.eth)"},"amount":{"type":"string","description":"Payment amount (e.g. '25.00')"},"currency":{"type":"string","enum":["USDC","XRP","RLUSD","ETH","cbBTC","EURC","USDT"],"description":"Settlement currency on Base or XRPL"},"memo":{"type":"string","description":"Optional item label or invoice memo"}},"required":["to"]}},{"name":"get_instant_free_rpc_key","description":"Mint a live UnFee API key with Free Tier credits (flat 1 request = 1 credit across eth_call, eth_getLogs, and XRPL JSON-RPC; 0 compute-unit multipliers).","inputSchema":{"type":"object","properties":{"label":{"type":"string","description":"Optional key label for telemetry"},"tier":{"type":"string","enum":["free","indie_5","pro_15","scale_49"]}}}},{"name":"compare_payment_fees","description":"Compare legacy card processor fees (2.9% + $0.30) against UnFee Starter ($0/mo, 0.005% = 5¢ per $1,000 micro-fee) and UnFee Indie ($5/mo, True 0% protocol fee).","inputSchema":{"type":"object","properties":{"amountUsd":{"type":"number","description":"Average transaction size in USD"},"monthlyTxCount":{"type":"number","description":"Monthly transaction count"},"tier":{"type":"string","enum":["free","indie_5","pro_15","scale_49"]}},"required":["amountUsd"]}},{"name":"get_live_arb_opportunities","description":"Scan all 9 live Base Mainnet 3-hop triangular flash-loan arbitrage loops (cbXRP, AERO, EURC, cbBTC, VIRTUAL, BRETT, DEGEN, MORPHO, WELL) and XRPL CLOB spreads.","inputSchema":{"type":"object","properties":{"simulateSpreadBps":{"type":"number","description":"Optional simulated spread in basis points (e.g. 45)"}}}},{"name":"verify_transaction","description":"Verify an on-chain Base Mainnet or XRPL transaction hash and return settlement confirmation details.","inputSchema":{"type":"object","properties":{"txHash":{"type":"string","description":"0x... Base transaction hash or XRPL tx hash"},"network":{"type":"string","enum":["base","xrpl","ethereum"]},"expectedAmount":{"type":"string"},"expectedCurrency":{"type":"string"},"expectedRecipient":{"type":"string"}},"required":["txHash"]}},{"name":"unfee_check_seller_reputation","description":"Check a seller or x402 API provider on-chain/gateway Proof-of-Delivery reputation (verified HTTP-200 deliveries, dropped failed calls, delivery rate %, and buyer USD saved on failed calls).","inputSchema":{"type":"object","properties":{"seller":{"type":"string","description":"Seller Base (0x...) or XRPL (r...) wallet address"}}}},{"name":"unfee_pay_with_delivery_proof","description":"Execute an atomic HTTP-200 Proof-of-Delivery x402 settlement check: settles payment ONLY if the seller returns HTTP 200..299 with a valid non-empty payload and matching SHA-256 digest; drops authorization with $0.00 buyer charge if upstream fails.","inputSchema":{"type":"object","properties":{"seller":{"type":"string","description":"Seller wallet address"},"buyer":{"type":"string","description":"Buyer wallet address"},"amountUsd":{"type":"string","description":"Payment amount in USD/USDC (e.g. 0.01)"},"currency":{"type":"string","description":"Settlement currency (default USDC)"},"upstreamStatus":{"type":"number","description":"HTTP status code returned by upstream seller API"},"upstreamBody":{"type":"string","description":"Response payload returned by upstream seller API"},"expectedSha256":{"type":"string","description":"Optional expected SHA-256 hex digest of payload"}}}},{"name":"unfee_generate_tax_report","description":"Generate an instant IRS Form 8949, Schedule D summary, FIFO/HIFO/LIFO cost-basis calculation, non-taxable self-transfer reconciliation, and TurboTax / QuickBooks CSV export for any Base (0x...) or XRPL (r...) wallet at $0.01 via x402 (or $0 on $5/mo Indie Tier), undercutting Koinly and CoinTracker by 99.9%.","inputSchema":{"type":"object","properties":{"wallet":{"type":"string","description":"Primary Base (0x...) or XRPL (r...) wallet address"},"wallets":{"type":"array","items":{"type":"string"},"description":"Optional list of connected Base and XRPL wallets for self-transfer matching"},"method":{"type":"string","enum":["FIFO","HIFO","LIFO"],"description":"Cost-basis accounting method (default HIFO)"},"taxYear":{"type":"string","description":"Tax year filter (e.g. 2026, 2025, 2024, or all)"},"format":{"type":"string","enum":["irs8949","turbotax","quickbooks"],"description":"Preferred CSV export format (default irs8949)"}}}},{"name":"base_rpc_request","description":"Execute any Base Mainnet (Chain ID 8453) JSON-RPC method (eth_call, eth_getLogs, eth_getBalance, eth_estimateGas, eth_sendRawTransaction, eth_blockNumber) at a flat 1 Request = 1 Credit (250,000 free calls/month, zero compute-unit multipliers).","inputSchema":{"type":"object","properties":{"method":{"type":"string","default":"eth_blockNumber","description":"Base Mainnet JSON-RPC method name"},"params":{"type":"array","default":[],"items":{},"description":"JSON-RPC method parameters array"},"apiKey":{"type":"string","description":"Optional UnFee API key (auto-provisioned if omitted)"}}}},{"name":"eth_getLogs_flat_rate","description":"Query Base Mainnet (8453) or Ethereum Mainnet (1) eth_getLogs event logs at 1 flat credit per request (saving 75x–500x vs. legacy compute-unit RPC gateways that charge 75–500 CUs per eth_getLogs call).","inputSchema":{"type":"object","properties":{"chain":{"type":"string","enum":["base","ethereum"],"default":"base","description":"Target EVM chain (base or ethereum)"},"address":{"type":"string","description":"Optional contract address filter"},"topics":{"type":"array","items":{},"description":"Optional indexed event topics filter array"},"fromBlock":{"type":"string","default":"latest","description":"Start block tag or hex block number"},"toBlock":{"type":"string","default":"latest","description":"End block tag or hex block number"},"apiKey":{"type":"string","description":"Optional UnFee API key"}}}},{"name":"xrpl_rpc_request","description":"Execute any native XRP Ledger (XRPL Mainnet) JSON-RPC method (account_info, book_offers, server_info, tx, submit, account_lines) at 1 flat credit per request with zero compute-unit markups.","inputSchema":{"type":"object","properties":{"method":{"type":"string","default":"server_info","description":"XRPL Mainnet JSON-RPC method name"},"params":{"type":"array","default":[{}],"items":{},"description":"XRPL JSON-RPC parameters array"},"apiKey":{"type":"string","description":"Optional UnFee API key"}}}},{"name":"ethereum_rpc_request","description":"Execute any Ethereum Mainnet (Chain ID 1) JSON-RPC method (eth_call, eth_getLogs, eth_getBalance, eth_blockNumber, eth_estimateGas) at 1 flat credit per request (250,000 free calls/month).","inputSchema":{"type":"object","properties":{"method":{"type":"string","default":"eth_blockNumber","description":"Ethereum Mainnet JSON-RPC method name"},"params":{"type":"array","default":[],"items":{},"description":"JSON-RPC method parameters array"},"apiKey":{"type":"string","description":"Optional UnFee API key"}}}},{"name":"unfee_trace_x402_wash_filter","description":"Run UnFee Trace (https://unfee.xyz/trace) on any Base (8453), Ethereum (1), or XRPL wallet or x402 facilitator to separate verified organic x402 end-user spend from circular agent-to-agent 24h ping-pong wash traffic, self-loops, and sub-cent dust heartbeats. Also returns an Arkham-style counterparty leaderboard.","annotations":{"title":"UnFee Trace — x402 Wash-Volume Filter & Counterparty Leaderboard","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"address":{"type":"string","default":"0xAF4107196680A0d2Ca7E027D77CcF3Eb2EEBdFd0","description":"Base/ETH (0x...) or XRPL (r...) wallet or x402 facilitator address to trace"},"chain":{"type":"string","enum":["base","eth","xrpl"],"default":"base","description":"Target blockchain network (base, eth, or xrpl)"},"transfers":{"type":"array","items":{"type":"object"},"description":"Optional custom batch of transfers ({ from, to, amountUsd, timestamp, hash }) to classify with the 4 heuristics"}}}},{"name":"unfee_address_guard","description":"Pre-send address-poisoning & vanity prefix/suffix lookalike spoofing guard for Base (8453), Ethereum (1), and XRPL wallets. Detects attackers matching the first 3-6 and last 3-6 hex characters of a trusted counterparty while middle bytes differ.","annotations":{"title":"UnFee Pre-Send Address-Poisoning & Lookalike Spoofing Guard","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"from":{"type":"string","default":"0x1111222233334444555566667777888899990000","description":"Sender wallet address"},"to":{"type":"string","default":"0xAF4107196680A0d2Ca7E027D77CcF3Eb2EEBdFd0","description":"Destination wallet address to verify before signing"},"chain":{"type":"string","enum":["base","eth","xrpl"],"default":"base","description":"Blockchain network"},"recentContacts":{"type":"array","items":{"type":"string"},"description":"Optional list of trusted/recent counterparty addresses to guard against lookalike spoofing"}}}}],"legacyToolAliases":["unfee_rpc_call"]}