# 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/<name> 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/<name>.
- Ready-to-run live example inputs: GET /api/tools/<name>/example.


## 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.

## 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?.