MCP 服务器

agentsvc-mcp

20 pay-per-call utility tools for AI agents via x402 USDC micropayments on Base. Screenshots, OCR, PDF, web scraping, weather, forex rates, crypto/stock prices, DNS, geocoding, translation, and more. $0.001–$0.008 per call. No API keys, no signup.

README

agentsvc-mcp

agentsvc.io MCP Server — gives AI agents access to 20 pay-per-call utility services via the x402 micropayment protocol. Agents pay automatically in USDC on Base mainnet — no accounts, no API keys, no subscriptions.

What this is

A single MCP server that exposes 20 useful tools to any MCP-compatible AI agent. Each tool call costs $0.001–$0.008 USDC, paid automatically from your agent's wallet.

Available Tools (20)

Tool	Cost	What it does
`ip_lookup`	$0.001	IP address → country, city, ISP, ASN, timezone
`dns_lookup`	$0.001	Domain → DNS records (A, AAAA, MX, TXT, CNAME, NS)
`qr_code`	$0.001	Text/URL → QR code (base64 PNG)
`exchange_rates`	$0.001	Live forex rates from ECB (30+ currencies, hourly)
`email_validate`	$0.001	Email → format + MX + disposable check
`ssl_check`	$0.001	Domain SSL cert → issuer, expiry, days remaining
`phone_validate`	$0.001	Phone number → E.164 format, country, line type
`weather`	$0.002	City/GPS → current weather + 3-day forecast
`translate`	$0.002	Text → translated text (100+ languages)
`whois`	$0.002	Domain → registrar, created/expires, nameservers
`crypto_prices`	$0.002	Crypto IDs → live price, market cap, 24h change
`stock_prices`	$0.002	Ticker symbols → price, P/E ratio, 52w range
`geocode`	$0.002	Address → lat/lon or lat/lon → address
`web_search`	$0.003	Query → factual summary + links (DuckDuckGo + Wikipedia)
`news_search`	$0.003	Query → recent news articles (HackerNews + BBC)
`pdf_extract`	$0.004	PDF (base64) → full text + per-page breakdown
`screenshot`	$0.005	URL → PNG screenshot (base64, full JS rendering)
`webpage_reader`	$0.006	URL → clean readable text + title + links
`html_to_pdf`	$0.008	URL or HTML → PDF (base64)
`ocr`	$0.008	Image (base64) → extracted text (40+ languages)

Installation

Requirements

Node.js 18+
npm install viem x402 (for payment signing)
A wallet private key with USDC on Base mainnet

Claude Desktop

curl -O https://agentsvc.io/mcp-server.mjs
npm install viem x402

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "agentsvc": {
      "command": "node",
      "args": ["/path/to/mcp-server.mjs"],
      "env": {
        "X402_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Any MCP-compatible agent

The MCP server auto-discovers all 20 tools from the live catalog at startup. Tools are dynamically loaded — new services appear automatically without updating the server.

How payments work

Each tool call uses the x402 protocol:

Agent calls a tool
Server probes the service (HTTP 402 response with payment requirements)
MCP server signs USDC payment on Base mainnet using your private key
Service executes and returns result

Payments are atomic per call — you only pay when a call succeeds. The wallet needs USDC on Base mainnet.

Get USDC on Base:

Bridge from Ethereum: bridge.base.org
Buy on Coinbase → withdraw to Base
Swap on Uniswap/Aerodrome (Base)

Cost examples

Usage	Daily cost
100 calls/day (avg $0.003)	$0.30
1,000 calls/day	$3.00
10,000 calls/day	$30.00

REST API

All tools are also available as a direct REST API without MCP:

# Step 1: probe (get payment requirements)
curl -X POST https://agentsvc.io/api/v1/proxy/ip-lookup \
  -H "Content-Type: application/json" \
  -d '{"ip": "8.8.8.8"}'
# → HTTP 402 with accepts[] payment requirements

# Step 2: sign + retry with X-Payment header
# See: https://agentsvc.io/docs

Endpoints: