graph-polymarket-mcp 1.0.0

package/README.md

@@ -0,0 +1,108 @@
+# graph-polymarket-mcp
+
+MCP server for querying [Polymarket](https://polymarket.com/) prediction market data via [The Graph](https://thegraph.com/) subgraphs.
+
+Exposes 9 tools that AI agents (Claude, Cursor, etc.) can use to query market data, trader P&L, positions, activity, and orderbook trades.
+
+## Prerequisites
+
+You need a Graph API key. Get one at: https://thegraph.com/studio/apikeys/
+
+## Installation
+
+```bash
+npm install -g graph-polymarket-mcp
+```
+
+Or use directly with npx:
+
+```bash
+npx graph-polymarket-mcp
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "graph-polymarket": {
+      "command": "npx",
+      "args": ["-y", "graph-polymarket-mcp"],
+      "env": {
+        "GRAPH_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add graph-polymarket -- npx -y graph-polymarket-mcp
+```
+
+Set the environment variable `GRAPH_API_KEY` before running.
+
+### Cursor / Other MCP Clients
+
+Use the stdio transport with `npx graph-polymarket-mcp` as the command, passing `GRAPH_API_KEY` as an environment variable.
+
+## Available Tools
+
+### Core Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_subgraphs` | List all available Polymarket subgraphs with descriptions and key entities |
+| `get_subgraph_schema` | Get the full GraphQL schema for a specific subgraph |
+| `query_subgraph` | Execute a custom GraphQL query against any subgraph |
+
+### Domain-Specific Tools
+
+| Tool | Description | Subgraph |
+|------|-------------|----------|
+| `get_market_data` | Get market/condition data with outcomes and volumes | Main |
+| `get_account_pnl` | Get a trader's P&L and performance metrics | Beefy P&L |
+| `get_user_positions` | Get a user's current positions | Slimmed P&L |
+| `get_recent_activity` | Get recent splits, merges, and redemptions | Activity |
+| `get_orderbook_trades` | Get recent order fills | Orderbook |
+| `get_global_stats` | Get aggregate platform statistics | Main |
+
+## Subgraphs
+
+| Name | IPFS Hash | Description |
+|------|-----------|-------------|
+| Main | `QmdyCguLEisTtQFveEkvMhTH7UzjyhnrF9kpvhYeG4QX8a` | Complete ecosystem data |
+| Beefy P&L | `QmbHwcGkumWdyTK2jYWXV3vX4WyinftEGbuwi7hDkhPWqG` | Comprehensive P&L tracking |
+| Slimmed P&L | `QmZAYiMeZiWC7ZjdWepek7hy1jbcW3ngimBF9ibTiTtwQU` | Minimal position data |
+| Activity | `Qmf3qPUsfQ8et6E3QNBmuXXKqUJi91mo5zbsaTkQrSnMAP` | Position management events |
+| Orderbook | `QmVGA9vvNZtEquVzDpw8wnTFDxVjB6mavTRMTrKuUBhi4t` | Order fill analytics |
+
+## Example Queries
+
+Once connected, an AI agent can:
+
+- "What are the current Polymarket global stats?"
+- "Show me the latest 20 orderbook trades"
+- "What are the positions for address 0x...?"
+- "Get the P&L for trader 0x...?"
+- "Query the main subgraph for all conditions with more than 100 trades"
+
+## Development
+
+```bash
+git clone https://github.com/your-username/graph-polymarket-mcp.git
+cd graph-polymarket-mcp
+npm install
+npm run build
+GRAPH_API_KEY=your-key node build/index.js
+```
+
+## License
+
+MIT

package/build/graphClient.d.ts

@@ -0,0 +1,7 @@
+export declare class GraphClientError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly graphErrors?: unknown[] | undefined;
+    constructor(message: string, statusCode?: number | undefined, graphErrors?: unknown[] | undefined);
+}
+export declare function querySubgraph(ipfsHash: string, query: string, variables?: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=graphClient.d.ts.map

package/build/graphClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphClient.d.ts","sourceRoot":"","sources":["../src/graphClient.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,UAAU,CAAC,EAAE,MAAM;aACnB,WAAW,CAAC,EAAE,OAAO,EAAE;gBAFvC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,WAAW,CAAC,EAAE,OAAO,EAAE,YAAA;CAK1C;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC,CA2ClB"}

package/build/graphClient.js

@@ -0,0 +1,36 @@
+export class GraphClientError extends Error {
+    statusCode;
+    graphErrors;
+    constructor(message, statusCode, graphErrors) {
+        super(message);
+        this.statusCode = statusCode;
+        this.graphErrors = graphErrors;
+        this.name = "GraphClientError";
+    }
+}
+export async function querySubgraph(ipfsHash, query, variables) {
+    const apiKey = process.env.GRAPH_API_KEY;
+    if (!apiKey) {
+        throw new GraphClientError("GRAPH_API_KEY environment variable is required. " +
+            "Get one at https://thegraph.com/studio/apikeys/");
+    }
+    const url = `https://gateway.thegraph.com/api/${apiKey}/subgraphs/id/${ipfsHash}`;
+    const body = { query };
+    if (variables && Object.keys(variables).length > 0) {
+        body.variables = variables;
+    }
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        throw new GraphClientError(`Graph API returned HTTP ${response.status}: ${response.statusText}`, response.status);
+    }
+    const json = (await response.json());
+    if (json.errors && json.errors.length > 0) {
+        throw new GraphClientError(`GraphQL errors: ${JSON.stringify(json.errors)}`, undefined, json.errors);
+    }
+    return json.data;
+}
+//# sourceMappingURL=graphClient.js.map

package/build/graphClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphClient.js","sourceRoot":"","sources":["../src/graphClient.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,UAAmB,EACnB,WAAuB;QAEvC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAS;QACnB,gBAAW,GAAX,WAAW,CAAY;QAGvC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,KAAa,EACb,SAAmC;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,gBAAgB,CACxB,kDAAkD;YAChD,iDAAiD,CACpD,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,oCAAoC,MAAM,iBAAiB,QAAQ,EAAE,CAAC;IAElF,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,CAAC;IAChD,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CACxB,2BAA2B,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EACpE,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAGlC,CAAC;IAEF,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,gBAAgB,CACxB,mBAAmB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAChD,SAAS,EACT,IAAI,CAAC,MAAM,CACZ,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { querySubgraph } from "./graphClient.js";
+import { SUBGRAPHS, SUBGRAPH_NAMES } from "./subgraphs.js";
+const server = new McpServer({
+    name: "graph-polymarket-mcp",
+    version: "1.0.0",
+});
+// Helper to format tool responses
+function textResult(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function errorResult(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tool 1: list_subgraphs
+// ---------------------------------------------------------------------------
+server.tool("list_subgraphs", "List all available Polymarket subgraphs with descriptions and key entities", {}, async () => {
+    const list = Object.entries(SUBGRAPHS).map(([key, cfg]) => ({
+        id: key,
+        name: cfg.name,
+        ipfsHash: cfg.ipfsHash,
+        description: cfg.description,
+        keyEntities: cfg.keyEntities,
+    }));
+    return textResult(list);
+});
+// ---------------------------------------------------------------------------
+// Tool 2: get_subgraph_schema
+// ---------------------------------------------------------------------------
+server.tool("get_subgraph_schema", "Get the full GraphQL schema (introspection) for a Polymarket subgraph", {
+    subgraph: z
+        .enum(SUBGRAPH_NAMES)
+        .describe("Subgraph identifier: main, beefy_pnl, slimmed_pnl, activity, or orderbook"),
+}, async ({ subgraph }) => {
+    try {
+        const cfg = SUBGRAPHS[subgraph];
+        const introspectionQuery = `{
+        __schema {
+          types {
+            name
+            kind
+            fields {
+              name
+              type { name kind ofType { name kind } }
+            }
+          }
+        }
+      }`;
+        const data = await querySubgraph(cfg.ipfsHash, introspectionQuery);
+        return textResult(data);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool 3: query_subgraph
+// ---------------------------------------------------------------------------
+server.tool("query_subgraph", "Execute a custom GraphQL query against a Polymarket subgraph", {
+    subgraph: z
+        .enum(SUBGRAPH_NAMES)
+        .describe("Subgraph identifier: main, beefy_pnl, slimmed_pnl, activity, or orderbook"),
+    query: z.string().describe("GraphQL query string"),
+    variables: z
+        .record(z.unknown())
+        .optional()
+        .describe("Optional GraphQL variables as key-value pairs"),
+}, async ({ subgraph, query, variables }) => {
+    try {
+        const cfg = SUBGRAPHS[subgraph];
+        const data = await querySubgraph(cfg.ipfsHash, query, variables);
+        return textResult(data);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool 4: get_market_data
+// ---------------------------------------------------------------------------
+server.tool("get_market_data", "Get Polymarket market/condition data including outcomes and volumes from the Main subgraph", {
+    first: z.number().min(1).max(100).default(10).describe("Number of markets to return (1-100)"),
+    orderBy: z.string().default("id").describe("Field to order by"),
+    orderDirection: z.enum(["asc", "desc"]).default("desc").describe("Sort direction"),
+}, async ({ first, orderBy, orderDirection }) => {
+    try {
+        const query = `{
+        conditions(first: ${first}, orderBy: ${orderBy}, orderDirection: ${orderDirection}) {
+          id
+          oracle
+          questionId
+          outcomeSlotCount
+          resolutionTimestamp
+          payoutNumerators
+          payoutDenominator
+        }
+      }`;
+        const data = await querySubgraph(SUBGRAPHS.main.ipfsHash, query);
+        return textResult(data);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool 5: get_account_pnl
+// ---------------------------------------------------------------------------
+server.tool("get_account_pnl", "Get a trader's P&L and performance metrics from the Beefy P&L subgraph", {
+    account: z
+        .string()
+        .describe("Ethereum address of the trader (lowercase)"),
+}, async ({ account }) => {
+    try {
+        const query = `{
+        account(id: "${account.toLowerCase()}") {
+          id
+          totalTrades
+          totalBuyAmount
+          totalSellAmount
+          totalFees
+          totalProfit
+          realizedProfit
+          unrealizedProfit
+          winRate
+          profitFactor
+          maxDrawdown
+          positions {
+            id
+            market { id }
+            realizedPnl
+            unrealizedPnl
+            netQuantity
+          }
+        }
+      }`;
+        const data = await querySubgraph(SUBGRAPHS.beefy_pnl.ipfsHash, query);
+        return textResult(data);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool 6: get_user_positions
+// ---------------------------------------------------------------------------
+server.tool("get_user_positions", "Get a user's current positions from the Slimmed P&L subgraph", {
+    account: z
+        .string()
+        .describe("Ethereum address of the user (lowercase)"),
+}, async ({ account }) => {
+    try {
+        const query = `{
+        userPositions(where: { user: "${account.toLowerCase()}" }, first: 100) {
+          id
+          user
+          tokenId
+          buyAmount
+          sellAmount
+          realizedPnl
+          netQuantity
+        }
+      }`;
+        const data = await querySubgraph(SUBGRAPHS.slimmed_pnl.ipfsHash, query);
+        return textResult(data);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool 7: get_recent_activity
+// ---------------------------------------------------------------------------
+server.tool("get_recent_activity", "Get recent splits, merges, and redemptions from the Activity subgraph", {
+    first: z.number().min(1).max(100).default(20).describe("Number of events to return"),
+    account: z
+        .string()
+        .optional()
+        .describe("Optional: filter by Ethereum address"),
+}, async ({ first, account }) => {
+    try {
+        const stakeholderWhere = account
+            ? `, where: { stakeholder: "${account.toLowerCase()}" }`
+            : "";
+        const redeemerWhere = account
+            ? `, where: { redeemer: "${account.toLowerCase()}" }`
+            : "";
+        const query = `{
+        splits(first: ${first}, orderBy: timestamp, orderDirection: desc${stakeholderWhere}) {
+          id
+          stakeholder
+          amount
+          timestamp
+        }
+        merges(first: ${first}, orderBy: timestamp, orderDirection: desc${stakeholderWhere}) {
+          id
+          stakeholder
+          amount
+          timestamp
+        }
+        redemptions(first: ${first}, orderBy: timestamp, orderDirection: desc${redeemerWhere}) {
+          id
+          redeemer
+          amount
+          timestamp
+        }
+      }`;
+        const data = await querySubgraph(SUBGRAPHS.activity.ipfsHash, query);
+        return textResult(data);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool 8: get_orderbook_trades
+// ---------------------------------------------------------------------------
+server.tool("get_orderbook_trades", "Get recent order fills from the Orderbook subgraph", {
+    first: z.number().min(1).max(100).default(20).describe("Number of trades to return"),
+    maker: z.string().optional().describe("Optional: filter by maker address"),
+    taker: z.string().optional().describe("Optional: filter by taker address"),
+}, async ({ first, maker, taker }) => {
+    try {
+        const filters = [];
+        if (maker)
+            filters.push(`maker: "${maker.toLowerCase()}"`);
+        if (taker)
+            filters.push(`taker: "${taker.toLowerCase()}"`);
+        const where = filters.length > 0 ? `, where: { ${filters.join(", ")} }` : "";
+        const query = `{
+        orderFilledEvents(first: ${first}, orderBy: timestamp, orderDirection: desc${where}) {
+          id
+          maker
+          taker
+          makerAssetId
+          takerAssetId
+          makerAmountFilled
+          takerAmountFilled
+          fee
+          price
+          side
+          timestamp
+        }
+      }`;
+        const data = await querySubgraph(SUBGRAPHS.orderbook.ipfsHash, query);
+        return textResult(data);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool 9: get_global_stats
+// ---------------------------------------------------------------------------
+server.tool("get_global_stats", "Get aggregate Polymarket platform statistics from the Main subgraph", {}, async () => {
+    try {
+        const query = `{
+        globals {
+          id
+          numConditions
+          numOpenConditions
+          numClosedConditions
+          numTraders
+          numTrades
+          tradeVolume
+          scaledTradeVolume
+          totalFees
+        }
+      }`;
+        const data = await querySubgraph(SUBGRAPHS.main.ipfsHash, query);
+        return textResult(data);
+    }
+    catch (error) {
+        return errorResult(error);
+    }
+});
+// ---------------------------------------------------------------------------
+// Start server
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Graph Polymarket MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/subgraphs.d.ts

@@ -0,0 +1,9 @@
+export interface SubgraphConfig {
+    name: string;
+    ipfsHash: string;
+    description: string;
+    keyEntities: string[];
+}
+export declare const SUBGRAPHS: Record<string, SubgraphConfig>;
+export declare const SUBGRAPH_NAMES: [string, ...string[]];
+//# sourceMappingURL=subgraphs.d.ts.map

package/build/subgraphs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraphs.d.ts","sourceRoot":"","sources":["../src/subgraphs.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAoEpD,CAAC;AAEF,eAAO,MAAM,cAAc,EAA6B,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC"}

package/build/subgraphs.js

@@ -0,0 +1,66 @@
+export const SUBGRAPHS = {
+    main: {
+        name: "Main",
+        ipfsHash: "QmdyCguLEisTtQFveEkvMhTH7UzjyhnrF9kpvhYeG4QX8a",
+        description: "Complete Polymarket ecosystem data including markets, conditions, FPMMs, trading, and liquidity provision.",
+        keyEntities: [
+            "Global",
+            "Account",
+            "Condition",
+            "FixedProductMarketMaker",
+            "MarketData",
+            "MarketPosition",
+            "Transaction",
+            "OrderFilledEvent",
+        ],
+    },
+    beefy_pnl: {
+        name: "Beefy Profit and Loss",
+        ipfsHash: "QmbHwcGkumWdyTK2jYWXV3vX4WyinftEGbuwi7hDkhPWqG",
+        description: "Comprehensive P&L tracking with performance analytics including win rate, profit factor, max drawdown, and daily stats.",
+        keyEntities: [
+            "Global",
+            "Account",
+            "Condition",
+            "Market",
+            "MarketPosition",
+            "MarketProfit",
+            "Transaction",
+            "DailyStats",
+        ],
+    },
+    slimmed_pnl: {
+        name: "Slimmed P&L",
+        ipfsHash: "QmZAYiMeZiWC7ZjdWepek7hy1jbcW3ngimBF9ibTiTtwQU",
+        description: "Minimal schema focused on essential user position data with buy/sell amounts and realized P&L.",
+        keyEntities: ["UserPosition", "NegRiskEvent", "Condition", "FPMM"],
+    },
+    activity: {
+        name: "Activity",
+        ipfsHash: "Qmf3qPUsfQ8et6E3QNBmuXXKqUJi91mo5zbsaTkQrSnMAP",
+        description: "Lightweight activity and event logging for position management operations (splits, merges, redemptions).",
+        keyEntities: [
+            "Split",
+            "Merge",
+            "Redemption",
+            "NegRiskConversion",
+            "NegRiskEvent",
+            "Condition",
+        ],
+    },
+    orderbook: {
+        name: "Orderbook",
+        ipfsHash: "QmVGA9vvNZtEquVzDpw8wnTFDxVjB6mavTRMTrKuUBhi4t",
+        description: "Orderbook-specific trading data with enhanced analytics, order fills, and per-market/per-account statistics.",
+        keyEntities: [
+            "Global",
+            "Account",
+            "MarketData",
+            "OrderFilledEvent",
+            "OrdersMatchedEvent",
+            "Orderbook",
+        ],
+    },
+};
+export const SUBGRAPH_NAMES = Object.keys(SUBGRAPHS);
+//# sourceMappingURL=subgraphs.js.map

package/build/subgraphs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraphs.js","sourceRoot":"","sources":["../src/subgraphs.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,SAAS,GAAmC;IACvD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,gDAAgD;QAC1D,WAAW,EACT,4GAA4G;QAC9G,WAAW,EAAE;YACX,QAAQ;YACR,SAAS;YACT,WAAW;YACX,yBAAyB;YACzB,YAAY;YACZ,gBAAgB;YAChB,aAAa;YACb,kBAAkB;SACnB;KACF;IACD,SAAS,EAAE;QACT,IAAI,EAAE,uBAAuB;QAC7B,QAAQ,EAAE,gDAAgD;QAC1D,WAAW,EACT,yHAAyH;QAC3H,WAAW,EAAE;YACX,QAAQ;YACR,SAAS;YACT,WAAW;YACX,QAAQ;YACR,gBAAgB;YAChB,cAAc;YACd,aAAa;YACb,YAAY;SACb;KACF;IACD,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,gDAAgD;QAC1D,WAAW,EACT,gGAAgG;QAClG,WAAW,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,CAAC;KACnE;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,gDAAgD;QAC1D,WAAW,EACT,0GAA0G;QAC5G,WAAW,EAAE;YACX,OAAO;YACP,OAAO;YACP,YAAY;YACZ,mBAAmB;YACnB,cAAc;YACd,WAAW;SACZ;KACF;IACD,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,gDAAgD;QAC1D,WAAW,EACT,8GAA8G;QAChH,WAAW,EAAE;YACX,QAAQ;YACR,SAAS;YACT,YAAY;YACZ,kBAAkB;YAClB,oBAAoB;YACpB,WAAW;SACZ;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAA0B,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "graph-polymarket-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for querying Polymarket data via The Graph subgraphs",
+  "type": "module",
+  "bin": {
+    "graph-polymarket-mcp": "build/index.js"
+  },
+  "main": "./build/index.js",
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js",
+    "start": "node build/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "build"
+  ],
+  "keywords": [
+    "mcp",
+    "polymarket",
+    "thegraph",
+    "subgraph",
+    "prediction-market",
+    "ai",
+    "claude"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}