io.github.fernsugi/x402-api
DeFi data API for AI agents β pay-per-call via x402/USDC on Base
Ask AI about io.github.fernsugi/x402-api
Powered by Claude Β· Grounded in docs
I know everything about io.github.fernsugi/x402-api. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
@x402-api/mcp-server
MCP server that gives Claude, ChatGPT, and any MCP-compatible AI agent access to pay-per-call crypto/DeFi data via the x402 protocol.
8 tools. No API keys. AI agents pay USDC micropayments on Base, per request.
βββ ββββββ βββ βββββββ βββββββ
βββββββββββ ββββββββββββββββββββ
ββββββ βββββββββββ βββ βββββββ
ββββββ βββββββββββ ββββββββββ
ββββ βββ ββββββββββββββββββββ
βββ βββ βββ βββββββ ββββββββ
Tools
| Tool | API Endpoint | Cost | Description |
|---|---|---|---|
get_crypto_prices | GET /api/price-feed | 0.001 USDC | BTC/ETH/SOL + top 24h movers |
get_gas_prices | GET /api/gas-tracker | 0.001 USDC | Multi-chain gas (ETH, Base, Polygon, Arbitrum) |
get_dex_quotes | GET /api/dex-quotes | 0.002 USDC | Swap quotes: Uniswap, SushiSwap, 1inch |
scan_token | GET /api/token-scanner | 0.003 USDC | Token security scan + rug-pull detection |
track_whales | GET /api/whale-tracker | 0.005 USDC | Holder concentration + whale alerts |
scan_yields | GET /api/yield-scanner | 0.005 USDC | DeFi yields: Aave, Compound, Morpho, Lido, Pendle |
get_funding_rates | GET /api/funding-rates | 0.008 USDC | Perp funding rates across 6 venues |
profile_wallet | GET /api/wallet-profiler | 0.008 USDC | Full wallet portfolio + risk profile |
Quick Start
Option A: Inspect mode (no payment needed)
Just run it β any 402 responses will return human-readable payment instructions:
npx @x402-api/mcp-server
Claude will tell you what's needed when a tool requires payment.
Option B: Auto-pay mode (fully autonomous)
Install optional payment deps and set your wallet key:
npm install -g @x402-api/mcp-server
npm install -g x402-fetch viem
export X402_WALLET_PRIVATE_KEY=0x<your_private_key>
x402-api-mcp
The server will auto-pay 402 responses using USDC on Base. Make sure your wallet has USDC on Base mainnet.
Claude Desktop Integration
Add to your claude_desktop_config.json:
Without auto-pay (inspect mode)
{
"mcpServers": {
"x402-api": {
"command": "npx",
"args": ["@x402-api/mcp-server"]
}
}
}
With auto-pay
{
"mcpServers": {
"x402-api": {
"command": "npx",
"args": ["@x402-api/mcp-server"],
"env": {
"X402_WALLET_PRIVATE_KEY": "0x<your_private_key>"
}
}
}
}
Config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Environment Variables
| Variable | Required | Description |
|---|---|---|
X402_WALLET_PRIVATE_KEY | Optional | Private key for auto-pay (e.g. 0x...). If set, x402-fetch handles payments automatically. |
X402_API_BASE_URL | Optional | Override API URL (default: https://x402-api.fly.dev) |
How x402 Payments Work
This API uses the x402 protocol β HTTP 402 Payment Required:
- Agent calls tool β MCP server makes API request
- Server returns 402 with payment details (amount, USDC address, Base network)
- Auto-pay mode: x402-fetch signs and submits payment, retries request automatically
- Manual mode: MCP returns 402 details so user/agent can arrange payment
Payment details:
- Token: USDC on Base mainnet
- Address:
0x60264c480b67adb557efEd22Cf0e7ceA792DefB7 - Chain: Base (chain ID 8453)
- Amount: 0.001β0.008 USDC per call (< 1 cent USD)
Tool Reference
get_crypto_prices
No parameters. Returns current prices for BTC, ETH, SOL + top 24h movers.
Cost: 0.001 USDC
get_gas_prices
No parameters. Returns gas prices for Ethereum, Base, Polygon, Arbitrum β slow/standard/fast tiers.
Cost: 0.001 USDC
get_dex_quotes
Compare swap quotes across DEXes.
| Parameter | Type | Required | Description |
|---|---|---|---|
from | string | β | Input token (e.g. "ETH", "0x...") |
to | string | β | Output token (e.g. "USDC") |
amount | string | β | Amount to swap (e.g. "1.5") |
Cost: 0.002 USDC
scan_token
Token security scan β detects rug-pull flags, honeypot patterns, mint authority, etc.
| Parameter | Type | Required | Description |
|---|---|---|---|
token | string | β | Contract address or symbol (e.g. "PEPE") |
Cost: 0.003 USDC
track_whales
Whale tracking β holder concentration, Gini coefficient, recent large moves.
| Parameter | Type | Required | Description |
|---|---|---|---|
token | string | β | Contract address or symbol |
Cost: 0.005 USDC
scan_yields
Top DeFi yield opportunities across Aave, Compound, Morpho, Lido, Pendle, etc.
| Parameter | Type | Required | Description |
|---|---|---|---|
chain | string | β | Filter by chain: "ethereum", "base", "arbitrum", "polygon" |
min_tvl | number | β | Minimum TVL in USD (e.g. 1000000) |
Cost: 0.005 USDC
get_funding_rates
Perpetual funding rates across Binance, OKX, Bybit, dYdX, GMX, Hyperliquid.
| Parameter | Type | Required | Description |
|---|---|---|---|
asset | string | β | Asset symbol (e.g. "BTC", "ETH"). All assets if omitted. |
Cost: 0.008 USDC
profile_wallet
Full wallet portfolio analysis β holdings, DeFi positions, activity, PnL, risk score.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | β | Ethereum/Base wallet address (0x...) |
Cost: 0.008 USDC
Development
git clone https://github.com/fernsugi/x402-api-mcp-server
cd x402-api-mcp-server
npm install
npm run build
npm start
To test without a payment wallet, simply run and see the 402 responses:
node dist/index.js
Links
License
MIT
