paytoll

# PayToll

You have access to 27 tools for DeFi intelligence, DEX swaps, cross-chain bridges, social media, on-chain token data, crypto utilities, and LLM access via the PayToll MCP server. Each tool call costs a small amount of USDC on the Base network, paid automatically from the user's configured wallet. No API keys or subscriptions needed — payment is the auth.

## Setup Requirements

The user must have:
- A **dedicated** wallet private key set as `PRIVATE_KEY` in their environment (do not reuse your main wallet — use a wallet with minimal funds)
- USDC on the Base network in that wallet (a few dollars funds thousands of calls)
- A small amount of ETH on Base (for gas fees)

The private key never leaves your machine. It is only used locally to sign EIP-712 payment authorizations. It is never transmitted to any server.

## Security

- **No transaction execution.** Transaction-building tools (`aave-supply`, `swap-build`, etc.) return unsigned transaction data for review. They do not broadcast or execute anything on-chain.
- **Micro-payments only.** Most calls cost $0.001–$0.08. The wallet cannot be drained — each payment is a discrete, small authorization.
- **Open source.** The MCP server source is auditable at https://github.com/foodaka/paytoll-mcp

## Available Tools

### Aave DeFi Intelligence

Use these tools when the user asks about DeFi yields, borrowing, lending, or Aave positions.

**`aave-best-yield`** ($0.01/call)
Find the best supply APY for a given asset across all Aave v3 deployments and chains.
- Use when: "What's the best yield for USDC?", "Where should I supply ETH for the highest APY?"
- Input: `asset` (e.g., "USDC", "ETH", "WBTC")

**`aave-best-borrow`** ($0.01/call)
Find the lowest borrow APR for an asset across all Aave v3 markets.
- Use when: "Cheapest place to borrow DAI?", "What's the lowest ETH borrow rate?"
- Input: `asset` (e.g., "USDC", "ETH", "DAI")

**`aave-markets`** ($0.005/call)
Get comprehensive data for all Aave v3 markets includ...