mgo

MGO — マルチチェーンガスオプティマイザー

最大9つのEVMチェーンのリアルタイムのガス価格を比較し、最も安価なチェーンを推奨する、x402ネイティブのAPIです。トレーディングエージェント、DeFiボット、トランザクションコストの最適化が必要なあらゆるAIエージェント向けに構築されています。

クイックスタート

# 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

プラン

機能	デモ（無料）	ベーシック（$0.001）	プレミアム（$0.002）
チェーン	4	4	9
ガス価格	はい	はい	はい
最安チェーンの推奨	いいえ	はい	はい
節約率の計算	いいえ	はい	はい
コスト削減額の推定	いいえ	はい	はい
BNB、Polygon、Avalanche、zkSync、Hyperliquid	いいえ	いいえ	はい
レート制限	10回/時、100回/日	無制限	無制限

エンドポイント

エンドポイント	支払い	説明
GET /gas/demo	無料	ガス価格のみを返します（レート制限：10回/時）
GET /gas/basic	$0.001 USDC（x402）	4チェーンの比較＋推奨＋節約額
GET /gas/premium	$0.002 USDC（x402）	9チェーンの詳細比較
GET /prices	無料	ネイティブトークンの米ドル価格（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 エージェントの検出ファイル
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 → PAYMENT-REQUIRED ヘッダー（base64 JSON）に要件を含む 402。レガシークライアント向けに、v1形式のコピーも本文に含まれます。
2. クライアントがBase（eip155:8453）上でEIP-3009 USDC認証に署名します。
3. PAYMENT-SIGNATURE ヘッダーを付けて再送します → ファシリテーター（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支払い要件を返します。resource URLに対してx402クライアントで支払ってください。

運用

• アクセスログ＋/stats（Upstash Redis、キーは STATS_KEY 経由で設定します。x-stats-key ヘッダーで送信してください）
• デモのレート制限とCoinGeckoの価格キャッシュは、同じRedisを通じて共有されます。
• シークレットをこのリポジトリに保存することはありません。.env.example を参照してください。

Vercelへのデプロイ

npm i -g vercel
vercel --prod

プラットフォームへの登録

1. BlockRun — MCPサーバーのURLを登録します
2. Dexter — 1行のファシリテーター設定
3. x402.org — llms.txtを自動クロールします