@pythfeeds/mcp 1.0.0

package/README.md

@@ -0,0 +1,51 @@
+# @pythfeeds/mcp
+
+MCP server for the [PythFeeds API](https://pythfeeds.com/developers) — gives AI agents (Claude Desktop, Claude Code, Cursor, …) live **Pyth oracle prices** and crypto market data as tools.
+
+## Tools
+`get_price` · `get_prices` · `list_feeds` · `get_coins` · `get_coin` · `get_ohlc` · `get_global`
+
+## Setup
+
+Get an API key at [pythfeeds.com/developers](https://pythfeeds.com/developers), then add the server to your MCP client.
+
+**Claude Desktop / Claude Code** (`claude_desktop_config.json` or `.mcp.json`):
+
+> The npm package is not published yet — until it is, point `command` at a
+> local checkout of this folder (works identically):
+
+```json
+{
+  "mcpServers": {
+    "pythfeeds": {
+      "command": "node",
+      "args": ["/path/to/sdks/mcp/index.js"],
+      "env": { "PYTHFEEDS_API_KEY": "pf_live_xxx" }
+    }
+  }
+}
+```
+
+Once published to npm, the zero-install form becomes available:
+
+```json
+{
+  "mcpServers": {
+    "pythfeeds": {
+      "command": "npx",
+      "args": ["-y", "@pythfeeds/mcp"],
+      "env": { "PYTHFEEDS_API_KEY": "pf_live_xxx" }
+    }
+  }
+}
+```
+
+Then ask your agent things like *"What's the live BTC price?"* or *"Compare ETH and SOL prices and 7-day OHLC."*
+
+## Env
+| Var | Default |
+|---|---|
+| `PYTHFEEDS_API_KEY` | — (required) |
+| `PYTHFEEDS_API_URL` | `https://pythfeeds.com/api/v1` |
+
+MIT licensed. Prices are real-time Pyth oracle data served via PythFeeds' Pyth Pro access.

package/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+// PythFeeds MCP server — exposes the PythFeeds API as Model Context Protocol
+// tools so AI agents (Claude, etc.) can pull live Pyth oracle prices + market
+// data. Configure with PYTHFEEDS_API_KEY (get one at pythfeeds.com/developers).
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const API = (process.env.PYTHFEEDS_API_URL || "https://pythfeeds.com/api/v1").replace(/\/$/, "");
+const KEY = process.env.PYTHFEEDS_API_KEY || "";
+
+if (!KEY) {
+  console.error("[pythfeeds-mcp] Warning: PYTHFEEDS_API_KEY is not set — calls will be rejected. Get a key at https://pythfeeds.com/developers");
+}
+
+async function call(path, params) {
+  const url = new URL(API + path);
+  if (params) for (const [k, v] of Object.entries(params)) if (v != null) url.searchParams.set(k, String(v));
+  const res = await fetch(url.toString(), { headers: { "x-api-key": KEY, accept: "application/json" } });
+  let body = {};
+  try { body = await res.json(); } catch { /* non-JSON */ }
+  if (!res.ok) throw new Error(body.error || `HTTP ${res.status}`);
+  return body;
+}
+const ok = (data) => ({ content: [{ type: "text", text: JSON.stringify(data, null, 2) }] });
+
+const server = new McpServer({ name: "pythfeeds", version: "1.0.0" });
+
+server.tool("get_price", "Live Pyth oracle price for one symbol (e.g. BTC, ETH, SOL). Returns price, confidence, exponent and publish time.",
+  { symbol: z.string().describe("Asset symbol, e.g. BTC") },
+  async ({ symbol }) => ok(await call(`/price/${encodeURIComponent(symbol)}`)));
+
+server.tool("get_prices", "Live Pyth oracle prices for multiple symbols in one call.",
+  { symbols: z.array(z.string()).describe("Symbols, e.g. ['BTC','ETH','SOL']") },
+  async ({ symbols }) => ok(await call("/prices", { symbols: symbols.join(",") })));
+
+server.tool("list_feeds", "Search the Pyth feed catalog (feed IDs + asset types).",
+  { query: z.string().optional().describe("Filter, e.g. 'btc'") },
+  async ({ query }) => ok(await call("/feeds", query ? { query } : undefined)));
+
+server.tool("get_coins", "Top cryptocurrencies by market cap with 24h/7d change.",
+  { page: z.number().optional(), per_page: z.number().optional() },
+  async ({ page, per_page }) => ok(await call("/coins", { page: page ?? 1, per_page: per_page ?? 50 })));
+
+server.tool("get_coin", "Full market detail for one coin by id (e.g. 'bitcoin').",
+  { id: z.string().describe("Coin id, e.g. bitcoin") },
+  async ({ id }) => ok(await call(`/coins/${encodeURIComponent(id)}`)));
+
+server.tool("get_ohlc", "OHLC candles for a coin. days in {1,7,14,30,90,180,365} (paid plans: also 730, 1825).",
+  { id: z.string(), days: z.number().optional() },
+  async ({ id, days }) => ok(await call(`/coins/${encodeURIComponent(id)}/ohlc`, { days: days ?? 7 })));
+
+server.tool("get_global", "Global market cap, 24h volume and BTC dominance.", {}, async () => ok(await call("/global")));
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("[pythfeeds-mcp] ready");

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@pythfeeds/mcp",
+  "version": "1.0.0",
+  "description": "MCP server for the PythFeeds API — give AI agents live Pyth oracle prices & market data.",
+  "type": "module",
+  "bin": { "pythfeeds-mcp": "index.js" },
+  "files": ["index.js", "README.md"],
+  "keywords": ["mcp", "model-context-protocol", "pyth", "pythfeeds", "crypto", "prices", "ai", "agent"],
+  "homepage": "https://pythfeeds.com/developers",
+  "license": "MIT",
+  "engines": { "node": ">=18" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  }
+}