@agentoracle.ai/mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentOracle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# @agentoracle.ai/mcp-server
+
+Model Context Protocol (MCP) server for **[AgentOracle](https://aiagentoracle.ai)** — real-time on-chain crypto market data, pay-per-call USDC on Base via x402.
+
+Plug 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.
+
+## Tools exposed
+
+| Tool | Purpose |
+| --- | --- |
+| `agentoracle_status` | Service heartbeat: token count, last ingestion, uptime, version |
+| `agentoracle_list_tokens` | List tokens with filters (chain, min liquidity, min volume, min market cap, limit, offset) |
+| `agentoracle_top_tokens` | Top N tokens by market cap (limit 1–100, default 20) |
+| `agentoracle_movers` | Top 10 gainers + top 10 losers by 24h price change |
+| `agentoracle_get_token` | Single-token lookup by ticker (case-insensitive: `ETH`, `BTC`, `SOL`, …) |
+
+Every call costs **$0.01 USDC** on Base mainnet, settled via the official Coinbase CDP Facilitator.
+
+## Install
+
+You don't need to install anything — `npx` handles it.
+
+## Configure: Claude Desktop
+
+Edit your Claude Desktop config:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add the `agentoracle` entry under `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "agentoracle": {
+      "command": "npx",
+      "args": ["-y", "@agentoracle.ai/mcp-server"],
+      "env": {
+        "WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The five tools will appear in the MCP tool palette.
+
+## Configure: Cursor
+
+Cursor → Settings → MCP → Add new MCP server:
+
+```json
+{
+  "name": "agentoracle",
+  "command": "npx",
+  "args": ["-y", "@agentoracle.ai/mcp-server"],
+  "env": {
+    "WALLET_PRIVATE_KEY": "0xYOUR_BASE_WALLET_PRIVATE_KEY"
+  }
+}
+```
+
+## Configure: Continue, Cline, Zed, others
+
+Any 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.
+
+## Wallet setup
+
+You need a Base mainnet wallet with USDC. Cheap options:
+
+1. **Coinbase Wallet** → export private key → fund with $5 of USDC on Base. That's 500 calls.
+2. **MetaMask** → switch to Base network → bridge USDC from Ethereum or Polygon, or buy directly.
+3. **Programmatic** — generate a key with `viem`'s `generatePrivateKey()`, fund via Coinbase Onramp.
+
+The private key never leaves your machine; the MCP server uses it locally to sign EIP-3009 USDC transfers.
+
+## Environment variables
+
+| Variable | Required | Default | Purpose |
+| --- | --- | --- | --- |
+| `WALLET_PRIVATE_KEY` | Yes (for paid calls) | — | Hex private key of a Base wallet with USDC. Without it, every call returns HTTP 402. |
+| `AGENTORACLE_BASE_URL` | No | `https://aiagentoracle.ai` | Override the API base URL (useful for self-hosted forks). |
+
+## Try it (without payment)
+
+You can list the tools without any wallet:
+
+```bash
+WALLET_PRIVATE_KEY="" npx -y @agentoracle.ai/mcp-server
+```
+
+Then send `{"jsonrpc":"2.0","id":1,"method":"tools/list"}` over stdin — every paid tool call will return HTTP 402 explaining what's needed.
+
+## Build from source
+
+```bash
+git clone https://github.com/agentoracle/mcp-server.git
+cd mcp-server
+npm install
+npm run build
+node dist/index.js
+```
+
+## Pricing
+
+Every 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>.
+
+## License
+
+MIT
+
+## Links
+
+- AgentOracle: <https://aiagentoracle.ai>
+- x402 manifest: <https://aiagentoracle.ai/.well-known/x402>
+- x402 protocol: <https://x402.org>
+- Model Context Protocol: <https://modelcontextprotocol.io>

package/dist/index.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { createPublicClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base } from "viem/chains";
+import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
+import { ExactEvmScheme, toClientEvmSigner } from "@x402/evm";
+const BASE_URL = process.env.AGENTORACLE_BASE_URL ?? "https://aiagentoracle.ai";
+const PRIVATE_KEY = process.env.WALLET_PRIVATE_KEY;
+function buildFetch() {
+    if (!PRIVATE_KEY)
+        return fetch;
+    const pk = PRIVATE_KEY.startsWith("0x") ? PRIVATE_KEY : `0x${PRIVATE_KEY}`;
+    const account = privateKeyToAccount(pk);
+    const publicClient = createPublicClient({ chain: base, transport: http() });
+    // toClientEvmSigner composes the viem account (signTypedData) with a
+    // publicClient (readContract) into the ClientEvmSigner shape ExactEvmScheme
+    // expects. ExactEvmScheme handles EIP-3009 (USDC), the scheme AgentOracle accepts.
+    const signer = toClientEvmSigner(account, publicClient);
+    const client = new x402Client().register("eip155:8453", new ExactEvmScheme(signer));
+    return wrapFetchWithPayment(fetch, client);
+}
+const paidFetch = buildFetch();
+function buildUrl(path, query) {
+    const url = new URL(path, BASE_URL);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v === undefined || v === null || v === "")
+                continue;
+            url.searchParams.set(k, String(v));
+        }
+    }
+    return url.toString();
+}
+async function callEndpoint(path, query) {
+    const url = buildUrl(path, query);
+    let res;
+    try {
+        res = await paidFetch(url, { method: "GET" });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new McpError(ErrorCode.InternalError, `AgentOracle request failed: ${msg}. ` +
+            (PRIVATE_KEY
+                ? ""
+                : "No WALLET_PRIVATE_KEY env var set — paid endpoints will return HTTP 402."));
+    }
+    const text = await res.text();
+    let payload;
+    try {
+        payload = text ? JSON.parse(text) : null;
+    }
+    catch {
+        payload = text;
+    }
+    if (!res.ok) {
+        if (res.status === 402) {
+            throw new McpError(ErrorCode.InternalError, "HTTP 402 Payment Required from AgentOracle. " +
+                "Set WALLET_PRIVATE_KEY env var (a Base wallet with USDC) so the MCP server can settle x402 payments. " +
+                "Each call costs $0.01 USDC on Base.");
+        }
+        if (res.status === 404) {
+            throw new McpError(ErrorCode.InvalidParams, `Not found: ${url}`);
+        }
+        if (res.status === 429) {
+            throw new McpError(ErrorCode.InternalError, "Rate limited by AgentOracle (60 req/min per wallet). Back off and retry.");
+        }
+        throw new McpError(ErrorCode.InternalError, `AgentOracle returned HTTP ${res.status}: ${typeof payload === "string" ? payload : JSON.stringify(payload)}`);
+    }
+    return payload;
+}
+const TOOLS = [
+    {
+        name: "agentoracle_status",
+        description: "Get AgentOracle service heartbeat: tracked-token count, last ingestion timestamp, ingestion error counter, process uptime, and API version. Use as a cheap probe before larger queries. Costs $0.01 USDC on Base.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentoracle_list_tokens",
+        description: "List on-chain crypto tokens sorted by market cap, with optional filters and pagination. Returns price, 24h volume, market cap, liquidity, 24h price change, confidence score, and last-updated timestamp for each token. Costs $0.01 USDC on Base.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    description: "Filter by chain (e.g. 'ethereum', 'base', 'solana', 'bsc').",
+                },
+                min_liquidity: { type: "number", description: "Minimum liquidity in USD." },
+                min_volume_24h: { type: "number", description: "Minimum 24h volume in USD." },
+                min_market_cap: { type: "number", description: "Minimum market cap in USD." },
+                limit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 500,
+                    description: "Max results to return (default 100, max 500).",
+                },
+                offset: {
+                    type: "integer",
+                    minimum: 0,
+                    description: "Pagination offset.",
+                },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentoracle_top_tokens",
+        description: "Get the top N on-chain crypto tokens by market cap. Same per-token shape as list_tokens. Costs $0.01 USDC on Base.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    minimum: 1,
+                    maximum: 100,
+                    description: "Number of top tokens to return (default 20, max 100).",
+                },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentoracle_movers",
+        description: "Get the top 10 gainers and top 10 losers by 24h price change percentage across all tracked on-chain tokens. Returns { gainers, losers, asOf }. Costs $0.01 USDC on Base.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentoracle_get_token",
+        description: "Look up a single on-chain crypto token by its ticker symbol (case-insensitive, e.g. 'ETH', 'BTC', 'SOL', 'USDC'). Returns the full token snapshot, or HTTP 404 if the symbol is unknown. Costs $0.01 USDC on Base. 404s do NOT consume payment.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                symbol: {
+                    type: "string",
+                    minLength: 1,
+                    maxLength: 16,
+                    description: "Token ticker symbol (case-insensitive).",
+                },
+            },
+            required: ["symbol"],
+            additionalProperties: false,
+        },
+    },
+];
+const server = new Server({ name: "agentoracle-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args = {} } = req.params;
+    const a = args;
+    let result;
+    switch (name) {
+        case "agentoracle_status":
+            result = await callEndpoint("/api/v1/status");
+            break;
+        case "agentoracle_list_tokens":
+            result = await callEndpoint("/api/v1/tokens", a);
+            break;
+        case "agentoracle_top_tokens":
+            result = await callEndpoint("/api/v1/tokens/top", a);
+            break;
+        case "agentoracle_movers":
+            result = await callEndpoint("/api/v1/tokens/movers");
+            break;
+        case "agentoracle_get_token": {
+            const symbol = String(a.symbol ?? "").trim();
+            if (!symbol) {
+                throw new McpError(ErrorCode.InvalidParams, "symbol is required");
+            }
+            result = await callEndpoint(`/api/v1/token/${encodeURIComponent(symbol)}`);
+            break;
+        }
+        default:
+            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write(`[agentoracle-mcp] connected. base=${BASE_URL} payments=${PRIVATE_KEY ? "enabled" : "DISABLED (set WALLET_PRIVATE_KEY)"}\n`);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "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",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "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": "AgentOracle",
+  "license": "MIT",
+  "homepage": "https://aiagentoracle.ai",
+  "repository": {
+    "type": "git",
+    "url": "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"
+  }
+}