mgo

MGO — 多链 Gas 优化器

基于 x402 的 API，可比较最多 9 条 EVM 链的实时 Gas 价格，并推荐成本最低的链。适用于交易 Agent、DeFi 机器人，以及任何需要优化交易成本的 AI Agent。

快速开始

# 1. Install dependencies
npm install

# 2. Set environment variables
cp .env.example .env
# Set WALLET_ADDRESS (USDC receiving wallet on Base) and CDP_API_KEY_ID/SECRET (facilitator auth)

# 3. Run locally (same entry point as production)
npm start

# 4. Test
# Open in browser: http://localhost:3000/gas/demo

套餐

功能	Demo（免费）	Basic（$0.001）	Premium（$0.002）
链数量	4	4	9
Gas 价格	是	是	是
最低成本链推荐	否	是	是
节省比例计算	否	是	是
成本节省估算	否	是	是
BNB、Polygon、Avalanche、zkSync、Hyperliquid	否	否	是
速率限制	10 次/小时，100 次/天	不限	不限

端点

端点	付款	描述
GET /gas/demo	免费	仅返回原始 Gas 价格（速率限制为 10 次/小时）
GET /gas/basic	$0.001 USDC（x402）	4 链比较 + 推荐 + 节省金额
GET /gas/premium	$0.002 USDC（x402）	9 链完整比较
GET /prices	免费	原生代币的 USD 价格（ETH、BNB、POL、AVAX、HYPE），缓存 60 秒
POST /mcp	免费 / x402	MCP Streamable HTTP 端点（工具：get_gas_demo、get_cheapest_chain、get_gas_basic、get_gas_premium）
GET /openapi.json	免费	OpenAPI 3.1 规范
GET /llms.txt、/skill.md	免费	AI Agent 发现文件
GET /.well-known/x402、/.well-known/x402.json、/.well-known/mcp.json、/.well-known/agent-card.json	免费	发现元数据
GET /health	免费	服务健康检查

付款流程（x402 v2）

1. 请求 GET /gas/basic 或 GET /gas/premium → 返回 402，要求信息位于 PAYMENT-REQUIRED 标头中（base64 JSON）。响应正文中还会提供一个 v1 格式的副本，供旧版客户端使用。
2. 客户端在 Base（eip155:8453）上签署 EIP-3009 USDC 授权
3. 使用 PAYMENT-SIGNATURE 标头重新发送请求 → facilitator（Coinbase CDP）验证 → 返回包含 PAYMENT-RESPONSE 收据的数据响应 → 在链上结算 USDC

如果上游 RPC / 价格源不可用，API 会返回 503，且不会结算任何付款。

// Client example (@x402/fetch, x402 v2)
const { wrapFetchWithPayment } = require("@x402/fetch");
const { x402Client } = require("@x402/core/client");
const { ExactEvmScheme } = require("@x402/evm/exact/client");
const { privateKeyToAccount } = require("viem/accounts");

const client = new x402Client().register("eip155:*", new ExactEvmScheme(privateKeyToAccount(process.env.EVM_PRIVATE_KEY)));
const paidFetch = wrapFetchWithPayment(fetch, client);
const res = await paidFetch("https://api.mgo.chain-ops.xyz/gas/basic");

MCP（Claude / Cursor / 任意 MCP 客户端）

远程 Streamable HTTP 服务，无需安装：

{
  "mcpServers": {
    "mgo-gas": { "url": "https://api.mgo.chain-ops.xyz/mcp" }
  }
}

也已作为 npm 包 chain-ops-mgo 发布，并收录于官方 MCP Registry（xyz.chain-ops/mgo）。付费工具会返回解码后的 x402 付款要求；请使用 x402 客户端向 resource URL 付款。

运维

• 访问日志 + /stats（Upstash Redis，密钥通过 STATS_KEY 设置；在 x-stats-key 标头中传入）
• Demo 速率限制和 CoinGecko 价格缓存共用同一个 Redis
• 本仓库中不会存放任何密钥：请参阅 .env.example

部署到 Vercel

npm i -g vercel
vercel --prod

平台注册

1. BlockRun — 注册 MCP 服务 URL
2. Dexter — 单行 facilitator 配置
3. x402.org — 自动抓取 llms.txt