← Docs

Getting started in five minutes

Three steps. Install the MCP wrapper, fund a Base wallet with $1 of USDC, make your first paid call. No signup, no API key.

1 · Install the MCP wrapper

@melis-ai/x402-tools-mcp is the single command that gives any MCP-aware agent access to all 22 melis services as tool calls. Runs in Claude Desktop, Cursor, Cline, Continue, Claude Code, or any other MCP client. 

npx @melis-ai/x402-tools-mcp

On first run, the wrapper prints its tool catalogue. Configure your client to point at the binary — see the full install guide for Claude Desktop, Cursor, and the others.

2 · Fund a Base wallet with USDC

x402 settlement happens in USDC on Base (Coinbase L2). Two routes:

  • Coinbase Wallet — buy USDC, switch to Base network, send to your agent's wallet address. wallet.coinbase.com
  • Bridge from Ethereum mainnet — if you have USDC on L1, bridge via bridge.base.org. Settlement: ~10 minutes.

$1.00 of USDC covers 100 ScrapePay calls, 200 PromptGuard calls, or one full RAG pipeline page-ingestion run. No minimum balance, no subscription.

3 · Make your first paid call

Raw curl from a terminal — no agent framework needed for the proof of life:

# 1. Hit ScrapePay with no payment header → returns 402 with a signed payment quote
curl -i -X POST https://scrapepay.melis.ai/scrape \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","format":"markdown"}'

# Response: HTTP/2 402
# {"x402Version":1,"accepts":[{"scheme":"exact","network":"base",
#   "maxAmountRequired":"10000","payTo":"0x1C68...B3bC", ... }]}

# 2. Your wallet client signs an EIP-3009 USDC transferAuth header
#    and retries. The MCP wrapper does this automatically — for raw curl,
#    use the @coinbase/x402-axios SDK or x402-fetch from the x402 GitHub org.

# 3. On success: HTTP 200 with the scraped content + a payment_hash receipt.

From an agent: just call the scrapepay tool through MCP. The wrapper handles the 402 → sign → retry loop transparently. Your agent code is one tool call, not three.

What to build next

Need help?

Email sean@melis.ai — Sean reads every message personally and replies within a working day. For high-volume access, ask about an internal key that bypasses the per-call x402 flow.