io.github.scrape402/scrape402 MCP Server

This MCP server provides pay-per-call agent tools via x402 on Base. The available tools cover chat plus supporting functions for prices, funding, and RNG, using USDC on Base. It is designed to work without requiring a user account or API keys.

🛠️ Key Features

Pay-per-call agent tools via x402
USDC on Base for tool calls
Tool set includes chat, prices, funding, and RNG
No account or keys required

🚀 Use Cases

LLM gateway workflows that need usage-based billing
Agentic systems that require dynamic pricing and funding checks
Randomness (RNG) needs for agent behavior
Web-search-related integration patterns via Base

⚡ Developer Benefits

OpenAI-compatible approach for integrating agent tools
Micropayments-friendly tool invocation model
MCP integration for tool discovery and calling
Base deployment context

⚠️ Limitations

Tool scope is limited to chat, prices, funding, and RNG as described.

{ "type": "object", "properties": { "bytes": { "type": "integer", "description": "1-256, default 16" }, "min": { "type": "integer" }, "max": { "type": "integer" } } }

{ "type": "object", "properties": { "messages": { "type": "array", "items": { "type": "object" }, "description": "OpenAI-style chat messages" }, "max_tokens": { "type": "integer" }, "temperature": { "type": "number" } }, "required": [ "messages" ] }

x402 examples — pay-per-call APIs for AI agents

Working examples for calling x402-gated HTTP APIs: your agent pays USDC per request on Base — no signup, no API keys, no subscription.

All examples run against x402.shizu.me (77 live endpoints, prices from $0.001/call): an OpenAI-compatible LLM gateway (/v1/chat/completions, /v1/embeddings, /v1/models), web search, a code sandbox, web scraping, live crypto/market data, verifiable randomness, and a prepaid off-chain metering rail for high-frequency loops (100+ calls/min, no per-call gas).

How x402 works

Call any endpoint → the HTTP 402 response carries signed USDC payment requirements (price, asset, recipient).

Pay — your x402 client signs the payment locally and retries automatically.

Served — settlement is on-chain; you are only charged when the call succeeds. Errors and 4xx never settle.

Fund a wallet with a few dollars of USDC on Base, export its private key, and every example here just works.

Examples

File

What it shows

js/chat.mjs

OpenAI-compatible chat completion, paid per call

js/search.mjs

Live web search without a search-API account

python/chat.py

Chat completion via the Python x402 client

python/embeddings.py

OpenAI-shape embeddings for RAG loops

python/metered_loop.py

Prepay once, then 100+ calls/min off-chain

Install

Tools (5)

randomcrypto_pricefunding_rateschatcatalog

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://x402.shizu.me/mcp/rpc

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "scrape402": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://x402.shizu.me/mcp/rpc"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.scrape402/scrape402