X402 API

DeFi data API for AI agents — pay-per-call via x402/USDC on Base

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": [
        "-y",
        "@x402-api/mcp-server"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

@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.

Code

  ██╗  ██╗██╗  ██╗ ██████╗ ██████╗
   ╚██╗██╔╝██║  ██║██╔═══██╗╚════██╗
    ╚███╔╝ ███████║██║   ██║ █████╔╝
    ██╔██╗ ╚════██║██║   ██║██╔═══╝
   ██╔╝ ██╗     ██║╚██████╔╝███████╗
   ╚═╝  ╚═╝     ╚═╝ ╚═════╝ ╚══════╝

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:

Terminal

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:

Terminal

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)

config.json

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": ["@x402-api/mcp-server"]
    }
  }
}

With auto-pay

config.json

{
  "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.

Code

Cost: 0.001 USDC

`get_gas_prices`

No parameters. Returns gas prices for Ethereum, Base, Polygon, Arbitrum — slow/standard/fast tiers.

Code

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"`)

Code

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"`)

Code

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

Code

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`)

Code

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.

Code

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...`)

Code

Cost: 0.008 USDC

Development

bash

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:

bash

node dist/index.js

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about X402 API

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "x402-api": { "command": "npx", "args": ["-y", "x402-api"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/x402-api?style=directory)](https://allmcps.com/mcp/x402-api)

HTML Embed

<a href="https://allmcps.com/mcp/x402-api"><img src="https://allmcps.com/api/badge/x402-api?style=directory" alt="X402 API on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to X402 API →Install in Claude Desktop Install in Cursor Install in VS Code

X402 API

DeFi data API for AI agents — pay-per-call via x402/USDC on Base

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": [
        "-y",
        "@x402-api/mcp-server"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

@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.

Code

  ██╗  ██╗██╗  ██╗ ██████╗ ██████╗
   ╚██╗██╔╝██║  ██║██╔═══██╗╚════██╗
    ╚███╔╝ ███████║██║   ██║ █████╔╝
    ██╔██╗ ╚════██║██║   ██║██╔═══╝
   ██╔╝ ██╗     ██║╚██████╔╝███████╗
   ╚═╝  ╚═╝     ╚═╝ ╚═════╝ ╚══════╝

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:

Terminal

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:

Terminal

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)

config.json

{
  "mcpServers": {
    "x402-api": {
      "command": "npx",
      "args": ["@x402-api/mcp-server"]
    }
  }
}

With auto-pay

config.json

{
  "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.

Code

Cost: 0.001 USDC

`get_gas_prices`

No parameters. Returns gas prices for Ethereum, Base, Polygon, Arbitrum — slow/standard/fast tiers.

Code

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"`)

Code

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"`)

Code

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

Code

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`)

Code

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.

Code

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...`)

Code

Cost: 0.008 USDC

Development

bash

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:

bash

node dist/index.js

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about X402 API

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "x402-api": { "command": "npx", "args": ["-y", "x402-api"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/x402-api?style=directory)](https://allmcps.com/mcp/x402-api)

HTML Embed

<a href="https://allmcps.com/mcp/x402-api"><img src="https://allmcps.com/api/badge/x402-api?style=directory" alt="X402 API on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

35Quality signal: Fair · 35/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to X402 API →Install in Claude Desktop Install in Cursor Install in VS Code

X402 API

Quick Install

Client Config & Setup

Documentation Overview

@x402-api/mcp-server

Tools

Quick Start

Option A: Inspect mode (no payment needed)

Option B: Auto-pay mode (fully autonomous)

Claude Desktop Integration

Without auto-pay (inspect mode)

With auto-pay

Environment Variables

How x402 Payments Work

Tool Reference

get_crypto_prices

get_gas_prices

get_dex_quotes

scan_token

track_whales

scan_yields

get_funding_rates

profile_wallet

Development

Links

License

Related MCP Servers

Reviews

Frequently Asked Questions about X402 API

AllMCPs Directory Badge

Technical Specs & Signals

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

X402 API

Quick Install

Client Config & Setup

Documentation Overview

@x402-api/mcp-server

Tools

Quick Start

Option A: Inspect mode (no payment needed)

Option B: Auto-pay mode (fully autonomous)

Claude Desktop Integration

Without auto-pay (inspect mode)

With auto-pay

Environment Variables

How x402 Payments Work

Tool Reference

get_crypto_prices

get_gas_prices

get_dex_quotes

scan_token

track_whales

scan_yields

get_funding_rates

profile_wallet

Development

Links

License

Related MCP Servers

Reviews

Frequently Asked Questions about X402 API

AllMCPs Directory Badge

Technical Specs & Signals

Moxie Docs MCP

Own this project?

Share & Embed

Explore more

`get_crypto_prices`

`get_gas_prices`

`get_dex_quotes`

`scan_token`

`track_whales`

`scan_yields`

`get_funding_rates`

`profile_wallet`

`get_crypto_prices`

`get_gas_prices`

`get_dex_quotes`

`scan_token`

`track_whales`

`scan_yields`

`get_funding_rates`

`profile_wallet`