Discover. Inspect. Keep the evidence.

What is this

From a new pool to a dated research trail

Start with discovery, inspect a token, then save the evidence for your next visit. Agents use the same pay-per-call API through HTTP or MCP. Every purchase has its own quote; a listing is not a safety assessment.

Try it

No wallet needed to look

The 402 response is the product: a price quote any agent can read and pay programmatically. Run this and you'll see one.

Watch a full run that was already paid for → A pool eight seconds old, a verdict on its token, and both settlement transactions linked so you can check them.

# free — status, catalog, and a sample of every shape
curl https://agenttoll.app/api/health
curl https://agenttoll.app/api/catalog
curl https://agenttoll.app/api/demo

# a paid endpoint, unpaid: you get the quote
curl -i https://agenttoll.app/api/base/fresh
HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <base64>
  price   $0.004 USDC
  network eip155:8453 (Base)
  + the request and response schema,
    so no second fetch is needed

// In the cloned repository: npm install && npm run build
import { createPaymentClient }
  from "./dist/payment-policy.js";

const client = createPaymentClient("base", undefined,
  { totalBudgetUsdc: "0" });

console.log(await client.getPaymentQuote(
  "/api/base/fresh"));
// Validates price, network, asset and recipient.
// No wallet and no payment. Use the MCP setup below
// when you want to enable bounded paid calls.

Catalog

Twenty-one endpoints, priced per call

Base onchain data first — gas, any token by contract address, wallet portfolios, address analytics, DEX pools and a spam-filtered new-token radar — plus market and Turkish-lira feeds.

Selected responses are cached; lifetimes vary by source. Handler failures before settlement are not billed. If a signed request times out or its response is lost, inspect the receipt and wallet before retrying: settlement may already have happened.

Watch endpoints

Ask only for what changed

A snapshot is useful once. Agents that run on a schedule want the diff. Address and radar watches return a cursor; send it back as ?since=. Drain address pages while hasMore is true and deduplicate transaction hashes. Radar coverage is partial; the price watch checks a threshold and has no cursor.

# inspect the quote — no wallet or payment
curl -i "https://agenttoll.app/api/watch/radar"
HTTP/1.1 402 Payment Required

# after payment via the bounded client or MCP tool,
# pass the returned cursor unchanged to the next call:
# /api/watch/radar?since=<returned-cursor>
# Each paid poll costs $0.003, including an empty result.
# Results cover the current ranked listing, not every pool.

How it works

One request, one micropayment, one response

MCP

Plug it straight into Claude

AgentToll ships an MCP server. Add it to Claude Desktop or Claude Code and use 21 data tools plus two free quote and budget tools. Start without a wallet; add a dedicated wallet and a finite session budget when you want to pay.

{
  "mcpServers": {
    "agenttoll": {
      "command": "npx",
      "args": ["-y", "agenttoll-mcp@0.14.0"]
    }
  }
}

Transparency

Numbers we can't fake, data we can't leak