{
  "markdown": "# Retired source — recovery reference\n\nActive maintenance moved to the sole maintained private repository [Marysbrain/aye-today](https://github.com/Marysbrain/aye-today), in `packages/mcp/`.\n\n**Do not install or deploy from this retired repository.** The historical instructions below are retained for recovery and reference, not current operations.\n\nExisting public deployments continue unchanged. Repository retirement does not delete or shut down services. Original source and Git history remain preserved; retired repository workflows are disabled.\n\nRetirement notice: 2026-09-03.\n\n---\n\n# x402-gateway-mcp\n\n**The live x402 market feed for agents.** The `x402_market_pulse` tool is\nFREE — no wallet, no payment, no signup: the x402 ecosystem in one snapshot,\nrefreshed ~3x/day — service listings by category with week-over-week deltas,\nnewly listed services, npm download trends for the core x402 packages,\nprotocol release tags, and per-source reliability grades. Every metric\ncarries a freshness stamp; a stale source says so instead of pretending.\n\nBehind the feed, [Aye Scout](https://pulse.aye.today) exposes two paid\npre-payment diligence tools: x402 category coverage and a resource preflight\nthat checks reachability, terms, catalog presence, and observed age before an\nagent spends. The tool list is fetched from the signed public manifest at\nstartup; compatibility-only routes are deliberately absent\n([verify](https://pulse.aye.today/llms.txt)).\n\nThe manifest is verified over its exact response bytes before any paid tools\nare registered. Both the treasury address and gateway signing-key ID are\npinned; an unsigned manifest or an unexpected key rotation stops startup.\n\n> ⚠️ **Funded-wallet warning:** `WALLET_PRIVATE_KEY` signs real payments. Use a\n> dedicated wallet holding only small balances (a few dollars of USDC). Never\n> your main wallet. The key is read from env, never logged, and payment headers\n> are never echoed into agent-visible output.\n\n## 5-minute setup (Claude Desktop / Claude Code)\n\n1. Create a fresh wallet and fund it with a small amount of USDC on Base\n   (or Base Sepolia test USDC from <https://faucet.circle.com> while testing).\n2. `npm install -g x402-gateway-mcp` (or use `npx`).\n3. Add to your MCP config (Claude Desktop `claude_desktop_config.json`, or\n   `claude mcp add` for Claude Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"x402-gateway\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"x402-gateway-mcp\"],\n      \"env\": {\n        \"GATEWAY_URL\": \"https://<your-gateway-host>\",\n        \"WALLET_PRIVATE_KEY\": \"0x<small-balance-wallet-key>\",\n        \"MAX_PER_CALL_USD\": \"0.25\",\n        \"MAX_SESSION_USD\": \"2.00\"\n      }\n    }\n  }\n}\n```\n\n4. Restart the client. The free `x402_market_pulse` tool works immediately\n   (no wallet needed); every paid tool description states its price, e.g.\n   `[costs $0.01 USDC per call] Score an x402 resource before paying it…`\n\n## Spend guardrails\n\n- `MAX_PER_CALL_USD` (default **0.25**): tools priced above this are refused.\n- `MAX_SESSION_USD` (default **2.00**): cumulative settled spend per server\n  session; calls that would exceed it are refused with a clear message the\n  agent can relay. Restart the server to reset.\n\nRefusals happen **before** any payment is signed.\n\n## Env reference\n\n| Var | Default | Purpose |\n|---|---|---|\n| `GATEWAY_URL` | `https://pulse.aye.today` | Gateway base URL (override for local/testnet) |\n| `WALLET_PRIVATE_KEY` | — | Buyer key (small balance!). Without it, tools list but calls fail with a clear error |\n| `MAX_PER_CALL_USD` | `0.25` | Per-call cap |\n| `MAX_SESSION_USD` | `2.00` | Per-session cap |\n| `EXPECTED_PAY_TO` | Aye treasury address | Pinned payment destination; override only for a controlled test deployment |\n| `EXPECTED_SIGNING_KID` | Aye production key ID | Pinned manifest signing key; rotate only with an audited gateway release |\n\nIf a transport or body-read error occurs after payment authorization, the MCP\nreserves the full advertised amount as possibly spent. It will not silently\nrestore that session capacity; reconcile the wallet before retrying.\n",
  "bytes": 4094,
  "sha": "44e452582bc24781094ea2f9377564f09fd07f6587332141d37e7845b0674f71",
  "repo_slug": "marysbrain/x402-gateway-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_marysbrain_x402_gateway_mcp_23ee036f/readme"
}