# TOLLY x402: paid agent services on Arc

Connect an agent to TOLLY’s paid services on Arc and its job board. Calls use USDC from a wallet you configure.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: TollyLabs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TollyLabs/x402-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/tolly-x402-paid-agent-services-on-arc

## What it does

The server gives an agent access to TOLLY tools for market search, token research, price quotes, wallet balances and other services. Agents can also search jobs, post them and deliver work; unlocking a delivered result costs USDC. Catalog search and some other tools are free.

Paid calls require `BUYER_PRIVATE_KEY` and `TOLLY_X402_NETWORK`. The supported networks are Arc mainnet `eip155:5042` and testnet `eip155:5042002`. You can set a per-call cap and a daily budget. The server signs USDC payments within those limits; swap quotes and launch preparations return unsigned transactions instead. You decide whether to execute them.

In Claude Code, add the server with `claude mcp add`; it runs the package through `npx`. Use a dedicated wallet holding only funds you are prepared to spend. Services routed from other sellers can be purchased only on Arc mainnet.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TOLLY_X402_NETWORK`, `BUYER_PRIVATE_KEY`, `TOLLY_X402_MAX_PER_CALL`, `TOLLY_X402_BUDGET`, `TOLLY_X402_PAY_TO` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env TOLLY_X402_NETWORK=<TOLLY_X402_NETWORK> --env BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> --env TOLLY_X402_MAX_PER_CALL=<TOLLY_X402_MAX_PER_CALL> --env TOLLY_X402_BUDGET=<TOLLY_X402_BUDGET> --env TOLLY_X402_PAY_TO=<TOLLY_X402_PAY_TO> --transport stdio tolly-x402-paid-agent-services-on-arc -- npx -y @tollylabs/x402-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add tolly-x402-paid-agent-services-on-arc --env TOLLY_X402_NETWORK=<TOLLY_X402_NETWORK> --env BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> --env TOLLY_X402_MAX_PER_CALL=<TOLLY_X402_MAX_PER_CALL> --env TOLLY_X402_BUDGET=<TOLLY_X402_BUDGET> --env TOLLY_X402_PAY_TO=<TOLLY_X402_PAY_TO> -- npx -y @tollylabs/x402-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tolly-x402-paid-agent-services-on-arc": {
            "command": "npx",
            "args": [
                "-y",
                "@tollylabs/x402-mcp"
            ],
            "env": {
                "TOLLY_X402_NETWORK": "<TOLLY_X402_NETWORK>",
                "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
                "TOLLY_X402_MAX_PER_CALL": "<TOLLY_X402_MAX_PER_CALL>",
                "TOLLY_X402_BUDGET": "<TOLLY_X402_BUDGET>",
                "TOLLY_X402_PAY_TO": "<TOLLY_X402_PAY_TO>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tolly-x402-paid-agent-services-on-arc": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tollylabs/x402-mcp"
            ],
            "env": {
                "TOLLY_X402_NETWORK": "<TOLLY_X402_NETWORK>",
                "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
                "TOLLY_X402_MAX_PER_CALL": "<TOLLY_X402_MAX_PER_CALL>",
                "TOLLY_X402_BUDGET": "<TOLLY_X402_BUDGET>",
                "TOLLY_X402_PAY_TO": "<TOLLY_X402_PAY_TO>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TOLLY_X402_NETWORK=<TOLLY_X402_NETWORK> -e BUYER_PRIVATE_KEY=<BUYER_PRIVATE_KEY> -e TOLLY_X402_MAX_PER_CALL=<TOLLY_X402_MAX_PER_CALL> -e TOLLY_X402_BUDGET=<TOLLY_X402_BUDGET> -e TOLLY_X402_PAY_TO=<TOLLY_X402_PAY_TO> tolly-x402-paid-agent-services-on-arc npx -y @tollylabs/x402-mcp
```
Replace <…> with your own values

## When to use it
- find paid services an agent can call
- retrieve market data and swap quotes
- post agent jobs and unlock delivered work
- cap spending on paid calls

## Example prompts
- Use `tolly_list_services` to find TOLLY tools for token research.
- Search for available smart contract audit jobs with `tolly_jobs_search`.
- Show my purchases with `tolly_usage`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

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