X402engine MCP

Pay-per-call AI APIs for agents via HTTP 402 crypto micropayments (USDC/USDm)

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": {
    "x402engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402engine-mcp@1.1.0"
      ]
    }
  }
}

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

Documentation Overview

x402engine-mcp

Agent-friendly MCP server for x402engine. It lets agents discover and call pay-per-request APIs through HTTP 402, with automatic USDC payment on Base or Solana.

The live gateway covers LLMs, image and video generation, web search and scraping, code execution, crypto and wallet data, transaction simulation, audio, travel, and IPFS. This MCP exposes a curated tool set and live discovery for the full catalog.

Quick Start

Use a dedicated, low-balance payer wallet. The MCP signs x402 payments locally and never sends the private key to x402engine.

Base

config.json

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.0"],
      "env": {
        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
        "X402_PAYMENT_NETWORK": "base",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Fund the wallet with USDC on Base. The x402 facilitator pays transaction gas; the wallet signs an EIP-3009 USDC authorization.

Solana

config.json

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.0"],
      "env": {
        "X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
        "X402_PAYMENT_NETWORK": "solana",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Fund the wallet with USDC on Solana and enough SOL for transaction fees.

Discovery Without a Wallet

The server starts without a wallet, and free tools such as discover_services and service_health still work. Paid tools return their x402 payment requirements until a wallet is configured.

Terminal

claude mcp add x402engine -- npx -y x402engine-mcp@1.1.0

Payment Controls

Variable	Default	Description
`X402_EVM_PRIVATE_KEY`	unset	Dedicated payer key for Base USDC
`X402_SOLANA_PRIVATE_KEY`	unset	Base58 or JSON payer key for Solana USDC
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base`, or `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	Hard per-request spending limit
`X402_BASE_URL`	production gateway	Override the gateway URL
`X402_PAYMENT_HEADER`	unset	Legacy pre-signed x402 header
`X402_DEV_BYPASS`	unset	Development bypass secret

In auto mode, Base is preferred when both keys are configured. Automatic payment only accepts the canonical USDC contracts on Base and Solana. It rejects unknown assets, unsupported networks, and amounts above the configured cap before signing.

MegaETH remains available to clients that supply their own compatible payment header.

MCP Tools

Category	Tools
Discovery	`discover_services`, `service_health`
Image and code	`generate_image`, `execute_code`
Audio	`transcribe_audio`
Crypto	`get_crypto_price`, `get_crypto_markets`, `get_crypto_history`, `get_trending_crypto`, `search_crypto`, `get_crypto_categories`
Wallet and token	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Travel	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Prices are included in each tool description and in live discovery. The gateway catalog can change independently of this package.

Discovery

Gateway discovery: /.well-known/x402.json
Agent card: /.well-known/agent.json
Endpoint manifest: /.well-known/agent-manifest.v1.json
Services API: /api/services
Package metadata: server.json

Development

Terminal

npm install
npm test
npm run build

Links

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

2mo ago

Most recent push to the default branch.

Reviews

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

Frequently Asked Questions about X402engine MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "x402engine-mcp": { "command": "npx", "args": ["-y","x402engine-mcp@1.1.0"] } }

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/x402engine-mcp?style=directory)](https://allmcps.com/mcp/x402engine-mcp)

HTML Embed

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

Technical Specs & Signals

CategoryFinance & Fintech

5/8 checks healthy over the last 45d

37Quality signal: Fair · 37/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 & activity3/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.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · x402engine-mcp@1.1.0 (npm)

★ 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 X402engine MCP →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

X402engine MCP

Pay-per-call AI APIs for agents via HTTP 402 crypto micropayments (USDC/USDm)

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": {
    "x402engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "x402engine-mcp@1.1.0"
      ]
    }
  }
}

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

Documentation Overview

x402engine-mcp

Agent-friendly MCP server for x402engine. It lets agents discover and call pay-per-request APIs through HTTP 402, with automatic USDC payment on Base or Solana.

Quick Start

Use a dedicated, low-balance payer wallet. The MCP signs x402 payments locally and never sends the private key to x402engine.

Base

config.json

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.0"],
      "env": {
        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
        "X402_PAYMENT_NETWORK": "base",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Fund the wallet with USDC on Base. The x402 facilitator pays transaction gas; the wallet signs an EIP-3009 USDC authorization.

Solana

config.json

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.0"],
      "env": {
        "X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
        "X402_PAYMENT_NETWORK": "solana",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Fund the wallet with USDC on Solana and enough SOL for transaction fees.

Discovery Without a Wallet

The server starts without a wallet, and free tools such as discover_services and service_health still work. Paid tools return their x402 payment requirements until a wallet is configured.

Terminal

claude mcp add x402engine -- npx -y x402engine-mcp@1.1.0

Payment Controls

Variable	Default	Description
`X402_EVM_PRIVATE_KEY`	unset	Dedicated payer key for Base USDC
`X402_SOLANA_PRIVATE_KEY`	unset	Base58 or JSON payer key for Solana USDC
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base`, or `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	Hard per-request spending limit
`X402_BASE_URL`	production gateway	Override the gateway URL
`X402_PAYMENT_HEADER`	unset	Legacy pre-signed x402 header
`X402_DEV_BYPASS`	unset	Development bypass secret

MegaETH remains available to clients that supply their own compatible payment header.

MCP Tools

Category	Tools
Discovery	`discover_services`, `service_health`
Image and code	`generate_image`, `execute_code`
Audio	`transcribe_audio`
Crypto	`get_crypto_price`, `get_crypto_markets`, `get_crypto_history`, `get_trending_crypto`, `search_crypto`, `get_crypto_categories`
Wallet and token	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Travel	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Prices are included in each tool description and in live discovery. The gateway catalog can change independently of this package.

Discovery

Gateway discovery: /.well-known/x402.json
Agent card: /.well-known/agent.json
Endpoint manifest: /.well-known/agent-manifest.v1.json
Services API: /api/services
Package metadata: server.json

Development

Terminal

npm install
npm test
npm run build

Links

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

2mo ago

Most recent push to the default branch.

Reviews

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

Frequently Asked Questions about X402engine MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "x402engine-mcp": { "command": "npx", "args": ["-y","x402engine-mcp@1.1.0"] } }

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/x402engine-mcp?style=directory)](https://allmcps.com/mcp/x402engine-mcp)

HTML Embed

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

Technical Specs & Signals

CategoryFinance & Fintech

5/8 checks healthy over the last 45d

37Quality signal: Fair · 37/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 & activity3/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · x402engine-mcp@1.1.0 (npm)

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