x402engine-mcp

Name: x402engine-mcp
Author: agentc22

本地服务

github.com/agentc22开发工具13 周前更新

代码仓库

关于 x402engine-mcp

x402engine-mcp 通过 x402 为 AI Agent 接入按请求付费的 API，提供服务发现以及图像生成、代码执行、加密货币和旅行等工具，并支持在 Base 或 Solana 上自动支付 USDC。

主要功能

01发现服务并检查状态
02调用图像和代码工具
03获取加密货币及钱包数据
04搜索旅行服务
05使用 USDC 自动付款

适用场景

01为 Agent 任务查找可用 API
02生成图像或执行代码
03查询加密货币和钱包信息
04搜索航班、地点或酒店

MCP 相关

MCP 服务提供发现工具和精选 API 工具，并可实时发现更完整的目录。付费调用可通过本地签名的 x402 支付，使用 Base 或 Solana 上的 USDC。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "agentc22-x402engine": {
      "command": "npx",
      "args": [
        "-y",
        "x402engine-mcp"
      ],
      "env": {
        "X402_BASE_URL": "<X402_BASE_URL>",
        "X402_DEV_BYPASS": "<X402_DEV_BYPASS>",
        "X402_PAYMENT_HEADER": "<X402_PAYMENT_HEADER>"
      }
    }
  }
}

启动命令npx -y x402engine-mcp

需要配置的环境变量

X402_BASE_URLGateway URL (default: https://x402engine.app)

X402_DEV_BYPASS密钥Dev bypass secret to skip payments during testing

X402_PAYMENT_HEADER密钥Pre-signed x402 payment header for automatic payment

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmx402engine-mcp1.0.3stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

x402engine-mcp

面向 Agent 的 x402engine MCP 服务。它让 Agent 能够通过 HTTP 402 发现并调用按请求付费的 API，并自动使用 Base 或 Solana 上的 USDC 付款。

在线网关涵盖大模型、图像和视频生成、网络搜索与抓取、代码执行、加密货币和钱包数据、交易模拟、音频、旅行以及 IPFS。此 MCP 提供精选工具集，并支持对完整目录进行实时发现。

快速开始

请使用专用、余额较低的付款钱包。MCP 在本地签署 x402 付款，绝不会将私钥发送给 x402engine。

Base

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

为钱包充值 Base 上的 USDC。x402 促进器支付交易 Gas 费；钱包签署 EIP-3009 USDC 授权。

Solana

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

为钱包充值 Solana 上的 USDC，并准备足够的 SOL 支付交易费用。

无钱包时的发现

服务无需钱包即可启动，discover_services 和 service_health 等免费工具仍可使用。配置钱包之前，付费工具会返回其 x402 付款要求。

claude mcp add x402engine -- npx -y [email protected]

Hermes Agent

安装 x402engine 技能，并将此服务合并到当前 Hermes 配置文件的 config.yaml 中：

mcp_servers:
  x402engine:
    command: npx
    args: ["-y", "[email protected]"]
    env:
      X402_BASE_URL: "https://x402engine.app"
      X402_PAYMENT_NETWORK: "auto"
      X402_MAX_PAYMENT_USD: "0.10"

启动新会话并调用 discover_services 或 service_health；两者均免费。配置钱包之前，请将网络设为 auto。如需进行 Base 付款，请将 X402_EVM_PRIVATE_KEY 存储在配置文件本地的 .env 中，在服务的 env 中添加 X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}"，并将网络改为 base。切勿在聊天中提供钱包密钥。限额适用于每次请求；请为每项任务单独授权总预算。

Hermes 完整设置指南 · 可安装技能

付款控制

变量	默认值	说明
`X402_EVM_PRIVATE_KEY`	未设置	用于 Base USDC 的专用付款密钥
`X402_SOLANA_PRIVATE_KEY`	未设置	用于 Solana USDC 的 Base58 或 JSON 付款密钥
`X402_PAYMENT_NETWORK`	`auto`	`auto`、`base` 或 `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	每次请求的硬性支出限额
`X402_BASE_URL`	生产网关	覆盖网关 URL
`X402_PAYMENT_HEADER`	未设置	旧版预签名 x402 标头
`X402_DEV_BYPASS`	未设置	开发绕过密钥

在 auto 模式下，如果同时配置了两个密钥，则优先使用 Base。自动付款只接受 Base 和 Solana 上的规范 USDC 合约。签署前会拒绝未知资产、不支持的网络以及超过配置限额的金额。

客户端仍可通过提供兼容的付款标头使用 MegaETH。

MCP 工具

类别	工具
发现	`discover_services`、`service_health`
图像和代码	`generate_image`、`execute_code`
音频	`transcribe_audio`
加密货币	`get_crypto_price`、`get_crypto_markets`、`get_crypto_history`、`get_trending_crypto`、`search_crypto`、`get_crypto_categories`
钱包和代币	`get_wallet_balances`、`get_wallet_transactions`、`get_wallet_pnl`、`get_token_prices`、`get_token_metadata`
IPFS	`pin_to_ipfs`、`get_from_ipfs`
旅行	`search_flights`、`search_locations`、`search_hotels`、`search_cheapest_dates`