# Base Pulse Safety checks and honest reads for AI agents on Base. Every answer comes from on-chain data and names its source; when data is missing it says "unknown" instead of guessing. ## Pricing - Every tool gives each caller 25 free calls a day (reset daily at 00:00 UTC), then costs $0.01 USDC per call ($0.02 for the three pre-sign and token safety checks), paid per request with x402 on Base. Calls that return an error are never charged. - No account or API key. HTTP: an unpaid call to a paid tool returns 402 with a PAYMENT-REQUIRED header; retry with PAYMENT-SIGNATURE. MCP: the unpaid call returns a PaymentRequired tool result; retry with _meta["x402/payment"]. ## How to call - HTTP: POST /api/tools/ with a JSON body of inputs. - MCP: POST /mcp (Streamable HTTP) or /mcp/sse, then tools/call with the tool name. - Docs for every input (what it's looking for, where to get it) and every output field (what it is, how it's worked out): GET /api/tools and GET /api/tools/. - Ready-to-run live example inputs: GET /api/tools//example. ## Transactions - explain_tx (25 free calls a day, then $0.01 USDC per call (x402)): Run on any Base transaction hash when someone asks what happened, whether a payment went through, where the money went, or why it failed. Use it instead of reading a block explorer. Inputs: hash. - check_tx (25 free calls a day, then $0.02 USDC per call (x402)): Run before signing or sending any transaction you didn't build yourself (from a dApp, a link, another agent or a chat), and before any approval. Answers what moves, what it grants and to whom, and whether it would fail. Inputs: tx, tx.from. - tx_matches (25 free calls a day, then $0.02 USDC per call (x402)): Run before signing a payment someone else built (a dApp, another agent, an invoice link), with what the person actually asked for: which token, how much, to whom. Inputs: tx, tx.from, intent. - check_signature (25 free calls a day, then $0.02 USDC per call (x402)): Run before signing any typed-data request (eth_signTypedData_v4), especially one from a website, an airdrop claim, a marketplace listing or another agent. Answers what it allows, to whom, how much and until when. Inputs: typed_data, signer?. - x402_check (25 free calls a day, then $0.01 USDC per call (x402)): Run when an x402 endpoint answers 402 Payment Required, before signing the payment, with the 402 body and, if you know it, the price you were told. Inputs: payment_required, expected_price_usd?, url?. ## Tokens - token_safety (25 free calls a day, then $0.02 USDC per call (x402)): Run before buying, accepting or recommending a token on Base. Answers SAFE, CAUTION or AVOID with the exact reasons, from a simulated buy and sell, the contract's verified code and market data. Inputs: token. - find_token (25 free calls a day, then $0.01 USDC per call (x402)): Run whenever you have a ticker or token name but not its contract address, before buying, sending, quoting or accepting it. Never pick a contract from search results or a chat message yourself. Inputs: query. ## Wallets - balance (25 free calls a day, then $0.01 USDC per call (x402)): Run before sending ETH or USDC or paying gas, to confirm the wallet really has enough. Never trust a balance remembered from earlier in a chat. Inputs: wallet, network?. - approvals (25 free calls a day, then $0.02 USDC per call (x402)): Run when someone asks whether their wallet is safe, after they've signed something suspicious, after a drain, or before putting more money into a wallet. Also before you approve a new spender, to see what's already allowed. Inputs: wallet. - sanctions_check (25 free calls a day, then $0.01 USDC per call (x402)): Run before paying, accepting a payment from, or onboarding an address. Answers whether it is on the US Treasury's sanctions list (OFAC SDN) and whether it has sent to or received from a listed address on Base. Inputs: address. - recipient_check (25 free calls a day, then $0.02 USDC per call (x402)): Run right before sending funds, with the sender's wallet and the address you're about to send to, especially when the address was copied from transaction history, a chat or an email. Inputs: from, to, network?. ## Network - gas (25 free calls a day, then $0.01 USDC per call (x402)): Run before sending a transaction, or when someone asks what a transfer, swap or contract call costs on Base right now. Leave tx out for a plain ETH transfer. Inputs: tx?, tx.from?, network?. ## Reference - convert (25 free calls a day, then $0.01 USDC per call (x402)): Run before building any transfer or approval, to turn an amount a person said ("25.5 USDC") into the raw number a transaction needs, or a raw number from a transaction back into a readable amount. Inputs: token, amount?, raw?, network?. - whats_this (25 free calls a day, then $0.01 USDC per call (x402)): Run on any address you're about to send to, approve, sign for or trust, when you don't already know what it is. Also answers "is this a wallet or a contract?" and "is this contract verified?" Inputs: address, network?.