{"_id":"@agentoracle.ai/mcp-server","name":"@agentoracle.ai/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@agentoracle.ai/mcp-server","version":"0.1.0","description":"Model Context Protocol server for AgentOracle — real-time on-chain crypto market data, pay-per-call USDC on Base via x402.","type":"module","bin":{"agentoracle-mcp":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","smoke":"node scripts/smoke.mjs","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","x402","agentoracle","crypto","base","usdc","ai-agents","claude"],"author":{"name":"AgentOracle"},"license":"MIT","homepage":"https://aiagentoracle.ai","repository":{"type":"git","url":"git+https://github.com/agentoracle/mcp-server.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","@x402/fetch":"^2.11.0","@x402/core":"^2.11.0","@x402/evm":"^2.11.0","viem":"^2.21.0"},"devDependencies":{"@types/node":"^22.10.0","tsx":"^4.19.0","typescript":"^5.7.0"},"engines":{"node":">=20"},"gitHead":"71742b35a4f977d4da93c620328a4df6711391fe","_id":"@agentoracle.ai/mcp-server@0.1.0","bugs":{"url":"https://github.com/agentoracle/mcp-server/issues"},"_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-fouJJuSEIR3Ag5gw08E0+UwW+VNEUWjARbTCwNON55N1iKeT8oosRLyIdikvvAxQnbt6wvwFC6vA8H1uNxEHdw==","shasum":"c6f9b207e1209d4053019833c30afdd7f8020cae","tarball":"https://registry.npmjs.org/@agentoracle.ai/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":5,"unpackedSize":20640,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDaN+ewNwB3XbTtdJuCnc0EC5om32XXh417D18ZblBj0wIgH37E0vd3RyUAigVh6aR2QcRr5xNraGSnMwWbr9b8BIo="}]},"_npmUser":{"name":"agentoracleai2345","email":"brian.a.colonna@gmail.com"},"directories":{},"maintainers":[{"name":"agentoracleai2345","email":"brian.a.colonna@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1778374174725_0.6432561645723505"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-10T00:49:34.607Z","0.1.0":"2026-05-10T00:49:34.862Z","modified":"2026-05-10T00:49:35.105Z"},"maintainers":[{"name":"agentoracleai2345","email":"brian.a.colonna@gmail.com"}],"description":"Model Context Protocol server for AgentOracle — real-time on-chain crypto market data, pay-per-call USDC on Base via x402.","homepage":"https://aiagentoracle.ai","keywords":["mcp","model-context-protocol","x402","agentoracle","crypto","base","usdc","ai-agents","claude"],"repository":{"type":"git","url":"git+https://github.com/agentoracle/mcp-server.git"},"author":{"name":"AgentOracle"},"bugs":{"url":"https://github.com/agentoracle/mcp-server/issues"},"license":"MIT","readme":"# @agentoracle.ai/mcp-server\n\nModel Context Protocol (MCP) server for **[AgentOracle](https://aiagentoracle.ai)** — real-time on-chain crypto market data, pay-per-call USDC on Base via x402.\n\nPlug AgentOracle into any MCP-compatible host (Claude Desktop, Cursor, Continue, Cline, Zed, etc.) and your agent can query token prices, volume, liquidity, market cap, top movers, and per-symbol lookups — paying $0.01 USDC per call automatically. No API keys.\n\n## Tools exposed\n\n| Tool | Purpose |\n| --- | --- |\n| `agentoracle_status` | Service heartbeat: token count, last ingestion, uptime, version |\n| `agentoracle_list_tokens` | List tokens with filters (chain, min liquidity, min volume, min market cap, limit, offset) |\n| `agentoracle_top_tokens` | Top N tokens by market cap (limit 1–100, default 20) |\n| `agentoracle_movers` | Top 10 gainers + top 10 losers by 24h price change |\n| `agentoracle_get_token` | Single-token lookup by ticker (case-insensitive: `ETH`, `BTC`, `SOL`, …) |\n\nEvery call costs **$0.01 USDC** on Base mainnet, settled via the official Coinbase CDP Facilitator.\n\n## Install\n\nYou don't need to install anything — `npx` handles it.\n\n## Configure: Claude Desktop\n\nEdit your Claude Desktop config:\n\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAdd the `agentoracle` entry under `mcpServers`:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentoracle\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentoracle.ai/mcp-server\"],\n      \"env\": {\n        \"WALLET_PRIVATE_KEY\": \"0xYOUR_BASE_WALLET_PRIVATE_KEY\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The five tools will appear in the MCP tool palette.\n\n## Configure: Cursor\n\nCursor → Settings → MCP → Add new MCP server:\n\n```json\n{\n  \"name\": \"agentoracle\",\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@agentoracle.ai/mcp-server\"],\n  \"env\": {\n    \"WALLET_PRIVATE_KEY\": \"0xYOUR_BASE_WALLET_PRIVATE_KEY\"\n  }\n}\n```\n\n## Configure: Continue, Cline, Zed, others\n\nAny MCP host that supports stdio transport works — point it at `npx -y @agentoracle.ai/mcp-server` and pass `WALLET_PRIVATE_KEY` in the env block.\n\n## Wallet setup\n\nYou need a Base mainnet wallet with USDC. Cheap options:\n\n1. **Coinbase Wallet** → export private key → fund with $5 of USDC on Base. That's 500 calls.\n2. **MetaMask** → switch to Base network → bridge USDC from Ethereum or Polygon, or buy directly.\n3. **Programmatic** — generate a key with `viem`'s `generatePrivateKey()`, fund via Coinbase Onramp.\n\nThe private key never leaves your machine; the MCP server uses it locally to sign EIP-3009 USDC transfers.\n\n## Environment variables\n\n| Variable | Required | Default | Purpose |\n| --- | --- | --- | --- |\n| `WALLET_PRIVATE_KEY` | Yes (for paid calls) | — | Hex private key of a Base wallet with USDC. Without it, every call returns HTTP 402. |\n| `AGENTORACLE_BASE_URL` | No | `https://aiagentoracle.ai` | Override the API base URL (useful for self-hosted forks). |\n\n## Try it (without payment)\n\nYou can list the tools without any wallet:\n\n```bash\nWALLET_PRIVATE_KEY=\"\" npx -y @agentoracle.ai/mcp-server\n```\n\nThen send `{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}` over stdin — every paid tool call will return HTTP 402 explaining what's needed.\n\n## Build from source\n\n```bash\ngit clone https://github.com/agentoracle/mcp-server.git\ncd mcp-server\nnpm install\nnpm run build\nnode dist/index.js\n```\n\n## Pricing\n\nEvery call is $0.01 USDC on Base. Settled per request — there are no subscriptions, accounts, or invoices. The pay-to address is published in the canonical x402 manifest at <https://aiagentoracle.ai/.well-known/x402>.\n\n## License\n\nMIT\n\n## Links\n\n- AgentOracle: <https://aiagentoracle.ai>\n- x402 manifest: <https://aiagentoracle.ai/.well-known/x402>\n- x402 protocol: <https://x402.org>\n- Model Context Protocol: <https://modelcontextprotocol.io>\n","readmeFilename":"README.md","_rev":"1-ce7835d99489bcb7d4350d3ee6e2fbeb"}