ReloadPiReloadPi
Live on Base Mainnet

Connect Your AI to Reloadpi

Give your AI agent access to eSIMs, mobile top-ups, and gift vouchers across 190+ countries — paid in USDC on Base. Two ways to connect: MCP for Claude & Cursor, or x402 for any autonomous agent.

🔌

Claude & Cursor (MCP)

Recommended

Add Reloadpi as a tool server in any MCP-compatible AI client.

Browse only — no wallet needed

1

Add the hosted MCP URL to your client

MCP Server URL
https://mcp.reloadpi.com/mcp

In Claude.ai: Settings → Integrations → Add MCP Server. In Cursor: .cursor/mcp.json

2

Browse offers, check prices, poll orders

All browse and order-polling tools are free — no wallet required. Ask your AI to search for eSIMs, vouchers, or top-up plans.

Purchases — with your wallet

Purchase tools require a funded Base wallet. Your AI pays directly from your wallet via x402. No account needed, no API key.

⚡ npx — easiest setup

Recommended

No cloning needed. Just paste this into your MCP config — npx downloads and starts the server automatically. Requires Node.js 18+.

claude_desktop_config.json / .cursor/mcp.json
{
  "mcpServers": {
    "reloadpi": {
      "command": "npx",
      "args": ["-y", "reloadpi-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}
▶Advanced — self-host via git clone
1

Clone and run the MCP server locally

terminal
git clone https://github.com/cross555/reloadpi-mcp
cd reloadpi-mcp
npm install
cp .env.example .env   # add your EVM_PRIVATE_KEY
npm start
github.com/cross555/reloadpi-mcp
2

Add your wallet key to .env

.env
EVM_PRIVATE_KEY=0x...   # funded Base wallet
PORT=3100              # optional, default 3100

You need USDC on Base mainnet (chain ID 8453). Get it at Coinbase or bridge from another chain.

3

Point your client to localhost

.cursor/mcp.json
{
  "mcpServers": {
    "reloadpi": {
      "url": "http://localhost:3100/mcp"
    }
  }
}

In Claude.ai: Settings → Integrations → Add MCP Server → http://localhost:3100/mcp

⚡ Let Claude set it up for you

Already using Claude Code or Cursor? Paste this prompt and your AI will clone the repo, create the .env, and start the server automatically:

Clone https://github.com/cross555/reloadpi-mcp, create a .env with my EVM_PRIVATE_KEY set to [your key], run npm install && npm start, then add it to my MCP config pointing to http://localhost:3100/mcp

Takes under a minute. No account needed.

Quick reference — config snippets

Browse only (hosted URL)
{
  "mcpServers": {
    "reloadpi": {
      "url": "https://mcp.reloadpi.com/mcp"
    }
  }
}
Purchases via npx (recommended)
{
  "mcpServers": {
    "reloadpi": {
      "command": "npx",
      "args": ["-y", "reloadpi-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}
Purchases via localhost (git clone)
{
  "mcpServers": {
    "reloadpi": {
      "url": "http://localhost:3100/mcp"
    }
  }
}

Available tools

Vouchers

browse_voucher_offers

Search gift cards from 5000+ brands across 150+ countries. Filter by brand, country, or category.

get_voucher_offer

Get full details for a specific voucher — price, denomination, priceType, and required recipient fields.

get_voucher_filters

Get all valid filter values (brands, countries, categories) before calling browse.

purchase_voucher

Buy a voucher. Returns PIN, serial code, or redemption URL when available — email delivery for some brands.

Mobile Top-ups

browse_topup_offers

Find airtime and data top-up offers across 500+ operators in 150+ countries.

get_topup_offer

Get full details for a specific top-up offer — price, operator, country, required fields.

purchase_topup

Top up a mobile number (E.164 format). Airtime credited directly to recipient's SIM.

eSIMs

browse_esim_offers

Browse eSIM plans across 190+ countries — unlimited, regional, and global roaming plans.

get_esim_offer

Get full details for a specific eSIM plan — price, data, duration, coverage.

purchase_esim

Buy an eSIM. Returns ICCID and QR code. Poll get_order if QR is not immediately available.

Orders & Refunds

get_order

Poll fulfillment state and retrieve delivery payload (ICCID, QR, PIN, redeem URL). Free — no payment.

recover_order_by_txhash

Recover a lost order using the on-chain txHash — if the purchase response was dropped mid-flight.

claim_refund

Manual refund trigger for failed/expired eSIM orders. Failed orders refund automatically within ~5 min — use this only as a fallback.

Refund policy

Failed eSIM and carrier-rejected top-up orders are refunded automatically in USDC to the agent wallet within ~5 minutes — no action needed. Vouchers are non-refundable once a code is issued.

⚡

Autonomous Agents (x402)

Zero-config access for any agent that speaks the x402 payment protocol.

Reloadpi is a first-implementer of the x402-signals spec. Any agent with a Base wallet can discover, browse, and purchase without API keys or pre-registration — the payment is the authentication.

Discovery

Manifesthttps://api.reloadpi.com/.well-known/x402
Bazaaragentic.market/reloadpi
NetworkBase mainnet · Chain ID 8453 · USDC

Browse

~$0.001–0.004

Purchase

Product price + 15%

Polling

Free

🔑

Partner API

Traditional API key access — no crypto wallet required.

Building a platform or integration that needs server-to-server access? Apply for a partner key and use the same catalog endpoints without x402 payments.

View Partner SDK docs →

Reloadpi · Base mainnet · USDC payments · x402 manifest · Trust & Security · GitHub