# mcp-server

Connect an agent to true402 tools for web research, SEO, LLM calls, and token checks. Paid calls settle in USDC on Base.

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

## What it does

This MCP server exposes true402 tools for web extraction, SEO audits, search data, token and address checks, Base transaction analysis, and LLM calls. It discovers available tools from the live catalog at startup. `list_models` is free; other tools may charge per call.

Run it with Node.js 20 or later through `npx`. To pay, provide `WALLET_PRIVATE_KEY` for a Base wallet holding USDC. The server signs the payment authorization, while the facilitator covers gas. Without a wallet, paid tools return their payment requirements instead of running. `MAX_PAYMENT_USDC` caps spending per call, so check the ceiling before using `seo_audit`: its price is calculated per page.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `WALLET_PRIVATE_KEY`, `SERVER_URL`, `MAX_PAYMENT_USDC` — 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 WALLET_PRIVATE_KEY=<WALLET_PRIVATE_KEY> --env SERVER_URL=<SERVER_URL> --env MAX_PAYMENT_USDC=<MAX_PAYMENT_USDC> --transport stdio true402-mcp-server -- npx -y @true402.dev/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add true402-mcp-server --env WALLET_PRIVATE_KEY=<WALLET_PRIVATE_KEY> --env SERVER_URL=<SERVER_URL> --env MAX_PAYMENT_USDC=<MAX_PAYMENT_USDC> -- npx -y @true402.dev/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "true402-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@true402.dev/mcp-server"
            ],
            "env": {
                "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
                "SERVER_URL": "<SERVER_URL>",
                "MAX_PAYMENT_USDC": "<MAX_PAYMENT_USDC>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "true402-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@true402.dev/mcp-server"
            ],
            "env": {
                "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
                "SERVER_URL": "<SERVER_URL>",
                "MAX_PAYMENT_USDC": "<MAX_PAYMENT_USDC>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WALLET_PRIVATE_KEY=<WALLET_PRIVATE_KEY> -e SERVER_URL=<SERVER_URL> -e MAX_PAYMENT_USDC=<MAX_PAYMENT_USDC> true402-mcp-server npx -y @true402.dev/mcp-server
```
Replace <…> with your own values

## When to use it
- check a token and address before a trade
- review Base liquidity changes and large-wallet activity
- inspect a Base transaction before signing
- audit a page for SEO and retrieve search data
- extract web page content or inspect response headers

## Example prompts
- Check this Base token for safety concerns and explain the result.
- Audit this page for SEO and retrieve its search rankings.
- Inspect this Base transaction before I sign it; flag reverts or unlimited approvals.

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

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43902
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 105

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