v2.3 — x402 Payment Gateway Live

Connect any AI Agent
to Base Chain DeFi

Check balances, swap tokens, track pools, analyze wallets, monitor prices — all through natural language. The first production-ready MCP server for Base.

⚡ See All 14 Tools 📖 Quick Start GitHub →
14
MCP Tools
3
Revenue Tiers
$0.001
Per Call (x402)
10
Free Calls/Day

⚡ Quick Start

One command. Your AI agent has access to Base Chain.

$ pip install -r requirements.txt && python server.py
# Or via Docker:
$ docker build -t defai-gateway . && docker run --rm defai-gateway

🛠️ All 14 Tools

From basic balance checks to full swap execution. Three pricing tiers.

get_balance FREE
ETH + ERC-20 token balances for any wallet. Auto-detects USDC, AERO, DAI, WETH. USD estimates via CoinGecko.
→ {"ETH": "1.234", "USDC": "5000.00", "AERO": "150.25"}
get_token_info FREE
Name, symbol, decimals, total supply. Links to BaseScan.
→ {"name": "Aerodrome", "symbol": "AERO", "supply": "500M"}
get_gas_price FREE
Live Base gas in gwei. Estimated tx cost included.
→ {"gas_price_gwei": 0.12, "tx_cost_eth": "0.00000252"}
check_allowance FREE
Check token allowance before swapping. See if approval needed.
→ {"allowance": "0.00", "needs_approval": true}
build_approve_transaction FREE
Build unlimited or specific approval tx for Aerodrome Router.
→ {"tx": {"to": "0x...", "data": "0x09..."}, "gas_limit": 50000}
get_pools PREMIUM
Top Aerodrome liquidity pools. Filters by TVL. 3 fallback data sources.
→ {"pools": [{"AERO/WETH": "$48.2M", "APR": "14.8%"}]}
analyze_wallet PREMIUM
Full wallet breakdown: ETH, tokens, tx count, contract detection.
→ {"eth": "5.2", "tokens": ["AERO", "USDC"], "txs": 142}
track_new_tokens PREMIUM
Scan Base for new token contracts. 3-tier: Blockscout → Clanker → on-chain.
→ {"count": 5, "tokens": ["MOON", "STAR", ...]}
get_token_price PREMIUM
Live USD price for any token (ETH, USDC, AERO, BTC, SOL, ...).
→ {"ETH": {"usd": 3200.50}}
get_recent_transactions PREMIUM
Recent wallet activity via Blockscout API. Instant, no API key needed.
→ {"txs": [{"hash": "0x...", "value": "0.5 ETH"}]}
monitor_price PREMIUM
Check price + compare against target. Limit-order style monitoring.
→ {"pair": "USDC/AERO", "rate": 850.5, "alert": true}
get_payment_status PREMIUM
Your tier, remaining calls, upgrade options.
→ {"tier": "free", "calls_left": 7}
get_swap_quote $GATE
Live quote with price impact, route info, gas estimate.
→ {"expected": "850.5 AERO", "route": "direct", "impact": "0.02%"}
build_swap_transaction $GATE
Full EIP-1559 swap tx. Multi-hop routing. Sign with any wallet.
→ {"tx": {"to": "0x...", "data": "0x...", "nonce": 5, "gas": 250000}}

🔄 Complete Swap Flow

From check to signed transaction in 4 MCP calls.

# 1. Check allowance
$ python -c "import server; print(server.check_allowance('USDC', '0xYourWallet'))"

# 2. Build approval tx (if needed)
$ python -c "import server; print(server.build_approve_transaction('USDC', caller_address='0xYourWallet'))"

# 3. Get quote
$ python server.get_swap_quote('USDC', 'AERO', 100, caller_address='0xYourWallet')

# 4. Build swap tx
$ python server.build_swap_transaction('USDC', 'AERO', 100, slippage=0.5, caller_address='0xYourWallet')

# 5. Sign in wallet → Send → Done!

💰 x402 Payment Gateway

AI agents pay per API call in USDC on Base. No subscription needed — just send and use.

Send USDC

Send ≥ $0.01 USDC on Base to the fee wallet. Any amount works.

Verify Deposit

POST /deposit with your tx_hash. Server verifies on-chain and adds credits.

Call Tools

POST /mcp with your tool + args. Each call costs ~$0.001 USDC.

Or Go Free

10 calls/day free. $GATE holders get unlimited access.

# Start the x402 server
$ python x402_server.py --port 4020 --fee-wallet 0xYourWallet

# Check pricing & status
$ curl http://localhost:4020/pricing
$ curl http://localhost:4020/status

# Call a tool (paid)
$ curl -X POST http://localhost:4020/mcp \
  -H "Content-Type: application/json" \
  -H "X-402-Tx-Hash: 0xYourTxHash" \
  -H "X-402-Address: 0xYourWallet" \
  -d '{"tool":"get_balance","args":{"address":"0x..."}}'

🏗️ Architecture

Zero-dependency MCP server. No database. No state. Deploy anywhere.

AI Agent ──┬── MCP (stdio) ──→ DeFAI Gateway ──┬── Base RPC (on-chain) │ ├── Blockscout API │ ├── Aerodrome API │ ├── CoinGecko API │ └── Clanker API │ └── HTTP (x402) ──→ x402 Gateway ──┬── USDC verification ├── Credit ledger ├── /mcp, /deposit ├── /status, /pricing └── /health

💰 Pricing

Pay per call via x402, subscribe for Pro, or hold $GATE for unlimited.

Free
$0/mo
For prototyping and exploration
  • 10 calls/day via x402 free tier
  • Balances, tokens, gas prices
  • Approval tx builder
  • Allowance checker
  • Community support
Get Started →
Pro
$19.99/mo
For active traders and bots
  • 10,000 calls/month
  • All 14 tools
  • Pool analytics & wallet analysis
  • Token price & transaction history
  • Priority support
Subscribe →
$GATE Holder
∞
Unlimited + revenue share
  • Unlimited calls
  • Swap execution (EIP-1559)
  • Multi-hop routing
  • Revenue share from fees
  • Voting on protocol upgrades
Learn About $GATE →

Ready to connect your AI agent to Base?

One pip install. 14 tools. Zero API keys needed for basic usage.

⭐ Star on GitHub 📧 Contact