io.github.scrape402/scrape402 MCP Server

This MCP server provides pay-per-call agent tool access via x402, using USDC on Base. It supports chat, prices, funding, and RNG tools, designed for use without accounts or API keys. The included examples target x402.shizu.me, which fronts an OpenAI-compatible LLM gateway and related web and data utilities.

🛠️ Key Features

Pay-per-call agent tools via x402 (USDC on Base)
Chat, prices, funding, and RNG tool support
Operates without signup or API keys
OpenAI-compatible gateway endpoints: /v1/chat/completions, /v1/embeddings, /v1/models
Includes web search, code sandbox, web scraping, and live crypto/market data

🚀 Use Cases

AI agent calls that require priced, per-request usage
High-frequency agent loops using prepaid off-chain metering
Combining LLM requests with web search, scraping, and live market/RNG data

⚡ Developer Benefits

OpenAI-compatible LLM gateway compatibility
Prepaid off-chain metering rail for high-frequency usage (100+ calls/min)
Verifiable randomness and web/data integrations available through example endpoints

⚠️ Limitations

x402-gated HTTP APIs rely on x402.shizu.me live endpoints and pricing

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