Back to Browse
Free
Server data from the Official MCP Registry
DeFi data API for AI agents — pay-per-call via x402/USDC on Base
About
DeFi data API for AI agents — pay-per-call via x402/USDC on Base
Security Report
9.0
Low Risk9.0Low RiskValid MCP server (3 strong, 7 medium validity signals). 2 code issues detected. No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 3 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
x402 API base URL (default: https://x402-api.fly.dev)
Environment variable: X402_API_BASE_URL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-fernsugi-x402-api": {
"env": {
"X402_API_BASE_URL": "your-x402-api-base-url-here"
},
"args": [
"-y",
"@x402-api/mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
@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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
4
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
409
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
116.1K
Stars
15
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
-
Stars
13
Installs
10.0
Security
No ratings yet
Local