# Agent402.Tools: pay-per-call web tools

Connects coding agents to an index of 500+ web utilities paid per call in USDC or proof-of-work. Useful when your agent needs on-demand external data, routing, or specialized research reports.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 47
- Author: MikeyPetrillo
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MikeyPetrillo/Agent402
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/agent402tools-pay-per-call-web-tools

## What it does

The server gives an agent access to 500+ web tools and research dossiers maintained by Havok Holdings LLC. It resolves queries through `/api/find` and routes tasks among external x402 sellers with `/api/route`. Free queries function through proof-of-work challenges. The free tier requires no wallet.

Paid tool calls start at $0.001. Payments settle in USDC across 12 chains using x402 and MPP standards, or in USDG on Robinhood Chain. Structured reports cost between $0.60 and $2.00 per generation. The server also exposes `/api/leaderboard` to inspect seller transaction volume on Base.

You can connect through the hosted HTTP endpoint or run `npx -y agent402-mcp` locally. When running paid tools locally, missing configuration in `AGENT_KEY` or `AGENT402_MAX_PER_CALL` will halt requests once free proof-of-work limits run out.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://agent402.tools/mcp`
- Environment variables: `AGENT_KEY`, `AGENT402_BUDGET`, `AGENT402_MAX_PER_CALL`, `AGENT402_CREDITS_KEY`, `SOLANA_AGENT_KEY`, `AGENT402_NETWORKS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http agent402 https://agent402.tools/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env AGENT_KEY=<AGENT_KEY> --env AGENT402_BUDGET=<AGENT402_BUDGET> --env AGENT402_MAX_PER_CALL=<AGENT402_MAX_PER_CALL> --env AGENT402_CREDITS_KEY=<AGENT402_CREDITS_KEY> --env SOLANA_AGENT_KEY=<SOLANA_AGENT_KEY> --transport stdio agent402tools-pay-per-call-web-tools -- npx -y agent402-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add agent402tools-pay-per-call-web-tools --url https://agent402.tools/mcp
```

2. **Platform CLI**
```bash
codex mcp add agent402tools-pay-per-call-web-tools --env AGENT_KEY=<AGENT_KEY> --env AGENT402_BUDGET=<AGENT402_BUDGET> --env AGENT402_MAX_PER_CALL=<AGENT402_MAX_PER_CALL> --env AGENT402_CREDITS_KEY=<AGENT402_CREDITS_KEY> --env SOLANA_AGENT_KEY=<SOLANA_AGENT_KEY> -- npx -y agent402-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent402tools-pay-per-call-web-tools": {
            "url": "https://agent402.tools/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent402tools-pay-per-call-web-tools": {
            "command": "npx",
            "args": [
                "-y",
                "agent402-mcp"
            ],
            "env": {
                "AGENT_KEY": "<AGENT_KEY>",
                "AGENT402_BUDGET": "<AGENT402_BUDGET>",
                "AGENT402_MAX_PER_CALL": "<AGENT402_MAX_PER_CALL>",
                "AGENT402_CREDITS_KEY": "<AGENT402_CREDITS_KEY>",
                "SOLANA_AGENT_KEY": "<SOLANA_AGENT_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent402tools-pay-per-call-web-tools": {
            "type": "http",
            "url": "https://agent402.tools/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent402tools-pay-per-call-web-tools": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "agent402-mcp"
            ],
            "env": {
                "AGENT_KEY": "<AGENT_KEY>",
                "AGENT402_BUDGET": "<AGENT402_BUDGET>",
                "AGENT402_MAX_PER_CALL": "<AGENT402_MAX_PER_CALL>",
                "AGENT402_CREDITS_KEY": "<AGENT402_CREDITS_KEY>",
                "SOLANA_AGENT_KEY": "<SOLANA_AGENT_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http agent402tools-pay-per-call-web-tools https://agent402.tools/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e AGENT_KEY=<AGENT_KEY> -e AGENT402_BUDGET=<AGENT402_BUDGET> -e AGENT402_MAX_PER_CALL=<AGENT402_MAX_PER_CALL> -e AGENT402_CREDITS_KEY=<AGENT402_CREDITS_KEY> -e SOLANA_AGENT_KEY=<SOLANA_AGENT_KEY> agent402tools-pay-per-call-web-tools npx -y agent402-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- discover matching web utilities from a plain task description
- pay for individual API calls in USDC without monthly subscriptions
- pull structured company dossiers and market reports
- check verified seller volume on Base via the on-chain leaderboard

## Example prompts
- Search Agent402 for a web scraping tool and display the cost per call.
- Generate a company dossier report through Agent402 within my call budget.
- Query the x402 leaderboard to find top sellers by transaction volume on Base.

## Similar
- [pay-via-agent-wallet](https://affpapa.org/en/nevibecode/skills/pay-via-agent-wallet.md) — skill · 797 installs
- [mcp-x402](https://affpapa.org/en/nevibecode/mcp/mcp-x402.md) — MCP server · ★ 274
- [fetcher](https://affpapa.org/en/nevibecode/skills/fetcher.md) — skill · 3700 installs
- [pay-with-app](https://affpapa.org/en/nevibecode/skills/pay-with-app.md) — skill · 524 installs
- [teneo-cli](https://affpapa.org/en/nevibecode/skills/teneo-cli.md) — skill · 534 installs
- [agents-pay](https://affpapa.org/en/nevibecode/skills/agents-pay.md) — skill · 809 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
