{
  "markdown": "# MGO — Multi-chain Gas Optimizer\n\nAn x402-native API that compares real-time gas prices across up to 9 EVM chains and recommends the cheapest one. Built for trading agents, DeFi bots, and any AI agent that needs to optimize transaction costs.\n\n## Quick Start\n\n```bash\n# 1. Install dependencies\nnpm install\n\n# 2. Set environment variables\ncp .env.example .env\n# Set WALLET_ADDRESS to your USDC receiving wallet on Base\n\n# 3. Run locally\nnpm run dev\n\n# 4. Test\n# Open in browser: http://localhost:3000/gas/demo\n```\n\n## Tiers\n\n| Feature | Demo (Free) | Basic ($0.001) | Premium ($0.002) |\n|---|---|---|---|\n| Chains | 4 | 4 | 9 |\n| Gas prices | Yes | Yes | Yes |\n| Cheapest chain recommendation | No | Yes | Yes |\n| Savings % calculation | No | Yes | Yes |\n| Cost savings estimate | No | Yes | Yes |\n| BNB, Polygon, Avalanche, zkSync, Hyperliquid | No | No | Yes |\n| Rate limit | 10/hr, 100/day | Unlimited | Unlimited |\n\n## Endpoints\n\n| Endpoint | Payment | Description |\n|---|---|---|\n| `GET /gas/demo` | Free | Raw gas prices only (10/hr rate limit) |\n| `GET /gas/basic` | $0.001 USDC (x402) | 4-chain comparison + recommendation + savings |\n| `GET /gas/premium` | $0.002 USDC (x402) | 9-chain full comparison |\n| `GET /llms.txt` | Free | AI agent discovery file |\n| `GET /health` | Free | Server health check |\n\n## Payment Flow (x402 Protocol)\n\n1. `GET /gas/basic` or `/gas/premium` → 402 response with payment requirements\n2. Client signs EIP-712 USDC authorization (using x402-axios or x402-fetch)\n3. Resend with `X-PAYMENT` header → facilitator verifies → data response → on-chain settlement\n\n```javascript\n// Client example (x402-axios)\nconst { withPayment } = require(\"x402-axios\");\nconst client = withPayment(axios.create(), walletClient);\nconst response = await client.get(\"https://api.mgo.chain-ops.xyz/gas/basic\");\n```\n\n## MCP Server (Claude / Cursor)\n\n```bash\nnpm run mcp\n```\n\nAdd to Claude Desktop config:\n```json\n{\n  \"mcpServers\": {\n    \"mgo-gas\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/x402-gas-api/mcp-server.js\"]\n    }\n  }\n}\n```\n\n## Deploy to Vercel\n\n```bash\nnpm i -g vercel\nvercel --prod\n```\n\n## Platform Registration\n\n1. **BlockRun** — Register MCP server URL\n2. **Dexter** — One-line facilitator config\n3. **x402.org** — Automatic llms.txt crawling\n",
  "bytes": 2282,
  "sha": "2530a25ed2fa23b52caf57aef97ea6e11c50d0fe965d14389139d87cff8485d7",
  "repo_slug": "dlrjsdl200-byte/x402-gas-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_xyz_chain_ops_mgo_0c968266/readme"
}