AgentPay MCP Server

AgentPay — your agent is only as smart as its data.

AgentPay is an open x402 payment gateway that lets AI agents autonomously access real crypto data tools using USDC on Stellar or Base.

No subscriptions. No API keys. No human in the loop. Agents discover tools, pay per call ($0.001–$0.005), and get real data back — all within a hard budget cap.

→ 12 live tools: token prices, whale activity, gas tracker, DeFi TVL, Fear & Greed, yield scanner, funding rates, token security, Dune queries and more → Budget-aware Session: agents estimate costs, track spend, never exceed budget → x402 protocol: works with any x402-compatible agent → Two payment networks: Stellar (5s, $0.00001 fee) or Base mainnet USDC (2s, $0.0001 fee)

Try it in 60 seconds:

curl https://gateway-production-2cc2.up.railway.app/faucet

Or open the browser faucet: https://gateway-production-2cc2.up.railway.app/faucet/ui

Live gateway: https://gateway-production-2cc2.up.railway.app

Quickstart — 3 steps

Step 1: Get a funded test wallet

One call gives you a ready-to-use Stellar testnet wallet with 5 USDC pre-loaded:

curl https://gateway-production-2cc2.up.railway.app/faucet

Or use the browser faucet — click "Get Test Wallet", copy the snippet, run it.

Step 2: Create a Session with a budget

from agent.wallet import AgentWallet, Session, BudgetExceeded

wallet = AgentWallet(
    secret_key="S...",       # your Stellar secret key
    network="testnet",       # or "mainnet"
)

GATEWAY = "https://gateway-production-2cc2.up.railway.app"

with Session(wallet=wallet, gateway_url=GATEWAY, max_spend="0.05") as session:
    print(f"Balance:  {wallet.get_usdc_balance()} USDC")
    print(f"Budget:   {session.remaining()} remaining")

The Session enforces a hard USDC cap across all calls. It raises BudgetExceeded before any payment goes out if a tool would push you over, and automatically falls back to the next-cheapest tool in the same category when the preferred one is too expensive.

Step 3: Call tools — payment is automatic

with Session(wallet=wallet, gateway_url=GATEWAY, max_spend="0.05") as session:

    # Token price — $0.001
    r = session.call("token_price", {"symbol": "ETH"})
    print(f"ETH: ${r['price_usd']:,.2f}  ({r['change_24h_pct']:+.2f}% 24h)")

    # Fear & Greed Index — $0.001
    r = session.call("fear_greed_index", {"limit": 1})
    print(f"Sentiment: {r['value']}/100 — {r['value_classification']}")

    # DeFi TVL — $0.002
    r = session.call("defi_tvl", {"protocol": "aave"})
    print(f"Aave TVL: ${r['tvl'] / 1e9:.1f}B  ({r['change_1d']:+.1f}% 24h)")

    # Crypto news — $0.003
    r = session.call("crypto_news", {"currencies": "ETH", "filter": "hot"})
    for h in r["headlines"][:3]:
        print(f"  [{h['sentiment']:>7}] {h['title'][:55]}")

    print(f"
Total spent: {session.spent()}")
    print(f"Remaining:   {session.remaining()}")

Each session.call() handles the full x402 flow internally:

1. Checks your remaining budget against the tool's price (pre-flight, no payment yet)
2. POSTs to the gateway, receives a 402 with {payment_id, amount_usdc, pay_to}
3. Sends USDC on Stellar — ~2–3 seconds on testnet
4. Retries the request with X-Payment: tx_hash=<hash>,from=<addr>,id=
5. Returns the data

Available Tools

Discover all tools dynamically:

import httpx
tools = httpx.get(f"{GATEWAY}/tools").json()["tools"]
for t in tools:
    prin