@pmaxis/mcp-server 1.0.0

package/dist/tools/market.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMarketDetailTools = registerMarketDetailTools;
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+const marketId = zod_1.z.string().describe("Market ID, e.g. '558937'");
+function registerMarketDetailTools(server) {
+    server.tool("get_market", "Get full details for a single prediction market including title, description, current price, volume, and resolution date.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_summary", "Get a comprehensive summary of a prediction market — price, volume, sentiment, and key stats in one call.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/summary`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_stats", "Get detailed statistics for a prediction market — trade count, unique traders, volume breakdown.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/stats`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_liquidity", "Get the current order book liquidity for a market — best bid/ask, spread, and order depth from ClickHouse.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/liquidity`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_sentiment", "Get crowd sentiment for a market — bullish/bearish/neutral breakdown and volume trend direction.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/sentiment`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_signals", "Get trading signals and indicators for a market — momentum, volume signals, price alerts.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/signals`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_orderbook", "Get the full order book for a market — all bids and asks with quantities.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/orderbook`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_price", "Get the current price for a market token.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/price`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_price_history", "Get historical price data for a market. Useful for trend analysis.", {
+        id: marketId,
+        interval: zod_1.z.string().optional().describe("Time interval: '1h', '6h', '1d', '7d' (default '1d')"),
+        limit: zod_1.z.number().optional().describe("Number of data points to return"),
+    }, async ({ id, interval, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/price-history`, { interval, limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_trades", "Get recent trades for a prediction market.", {
+        id: marketId,
+        limit: zod_1.z.number().optional().describe("Max trades to return (default 20)"),
+    }, async ({ id, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/trades`, { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_candles", "Get OHLCV candlestick data for a market. Useful for charting and technical analysis.", {
+        id: marketId,
+        resolution: zod_1.z.string().optional().describe("Candle resolution: '1m', '5m', '1h', '1d' (default '1h')"),
+        limit: zod_1.z.number().optional().describe("Number of candles to return"),
+    }, async ({ id, resolution, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/candles`, { resolution, limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_market_positions", "Get current open positions held in a prediction market — who owns what and how much.", {
+        id: marketId,
+        limit: zod_1.z.number().optional().describe("Max positions to return (default 20)"),
+    }, async ({ id, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/positions`, { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_related_markets", "Get markets related to a given market — similar topics, same event, or correlated outcomes.", { id: marketId }, async ({ id }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/markets/${id}/related`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+}

package/dist/tools/markets.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMarketListTools = registerMarketListTools;
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+function registerMarketListTools(server) {
+    server.tool("search_markets", "Search prediction markets by keyword or topic. Use this to find markets about a specific subject.", {
+        q: zod_1.z.string().describe("Search query, e.g. 'election', 'bitcoin', 'world cup'"),
+        limit: zod_1.z.number().optional().describe("Max results to return (default 20)"),
+        offset: zod_1.z.number().optional().describe("Pagination offset"),
+    }, async ({ q, limit, offset }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/markets/search", { q, limit, offset });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_top_markets", "Get the top prediction markets by trading volume.", {
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+    }, async ({ limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/markets/top", { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_trending_markets", "Get currently trending prediction markets — markets with recent price movement and high activity.", {
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+    }, async ({ limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/markets/trending", { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_new_markets", "Get recently created prediction markets.", {
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+    }, async ({ limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/markets/new", { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_resolving_markets", "Get prediction markets that are close to their resolution date.", {
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+    }, async ({ limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/markets/resolving", { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("compare_markets", "Compare multiple prediction markets side by side. Pass comma-separated market IDs.", {
+        ids: zod_1.z.string().describe("Comma-separated market IDs, e.g. '558937,682705,1654958'"),
+    }, async ({ ids }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/markets/compare", { ids });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("list_markets", "List all prediction markets with optional filters.", {
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+        offset: zod_1.z.number().optional().describe("Pagination offset"),
+        category: zod_1.z.string().optional().describe("Filter by category slug"),
+        active: zod_1.z.boolean().optional().describe("Filter by active status"),
+    }, async ({ limit, offset, category, active }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/markets", { limit, offset, category, active });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+}

package/dist/tools/platform.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPlatformTools = registerPlatformTools;
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+function registerPlatformTools(server) {
+    server.tool("get_platform_stats", "Get overall PMAxis platform statistics — total markets, total volume, active traders, and aggregate metrics.", {}, async () => {
+        const data = await (0, client_js_1.pmaxisGet)("/stats");
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_recent_trades", "Get the most recent trades across all prediction markets on the platform.", {
+        limit: zod_1.z.number().optional().describe("Max trades to return (default 20)"),
+    }, async ({ limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/trades/recent", { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_batch_prices", "Get current prices for multiple market tokens in a single call. Pass comma-separated token IDs.", {
+        ids: zod_1.z.string().describe("Comma-separated token IDs"),
+    }, async ({ ids }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/prices", { ids });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+}

package/dist/tools/taxonomy.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTaxonomyTools = registerTaxonomyTools;
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+function registerTaxonomyTools(server) {
+    server.tool("get_events", "List all prediction market events. Events group related markets together (e.g. '2026 World Cup' groups all team markets).", {
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+        offset: zod_1.z.number().optional().describe("Pagination offset"),
+    }, async ({ limit, offset }) => {
+        const data = await (0, client_js_1.pmaxisGet)("/events", { limit, offset });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_event_markets", "Get all prediction markets belonging to a specific event.", {
+        id: zod_1.z.string().describe("Event ID"),
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+    }, async ({ id, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/events/${id}/markets`, { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_categories", "List all market categories available on PMAxis (e.g. politics, sports, crypto, economics).", {}, async () => {
+        const data = await (0, client_js_1.pmaxisGet)("/categories");
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_category_markets", "Get all prediction markets in a specific category.", {
+        slug: zod_1.z.string().describe("Category slug, e.g. 'politics', 'sports', 'crypto'"),
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+    }, async ({ slug, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/categories/${slug}/markets`, { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_tags", "List all tags used to label prediction markets.", {}, async () => {
+        const data = await (0, client_js_1.pmaxisGet)("/tags");
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_series", "List all recurring market series on PMAxis (e.g. monthly Fed rate decision markets).", {}, async () => {
+        const data = await (0, client_js_1.pmaxisGet)("/series");
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+}

package/dist/tools/wallets.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerWalletTools = registerWalletTools;
+const zod_1 = require("zod");
+const client_js_1 = require("../client.js");
+const address = zod_1.z.string().describe("Wallet address, e.g. '0xabc...def'");
+function registerWalletTools(server) {
+    server.tool("get_wallet_summary", "Get a full summary of a wallet's prediction market activity — total volume, PnL, win rate, and active markets.", { address }, async ({ address }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/wallets/${address}/summary`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_wallet_activity", "Get the recent transaction history for a wallet — all trades, buys, and sells.", {
+        address,
+        limit: zod_1.z.number().optional().describe("Max transactions to return (default 20)"),
+    }, async ({ address, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/wallets/${address}/activity`, { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_wallet_markets", "Get all prediction markets a wallet has traded in.", {
+        address,
+        limit: zod_1.z.number().optional().describe("Max results (default 20)"),
+    }, async ({ address, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/wallets/${address}/markets`, { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_wallet_open_positions", "Get all currently open positions held by a wallet — market, token, size, and estimated value.", {
+        address,
+        limit: zod_1.z.number().optional().describe("Max positions to return (default 20)"),
+    }, async ({ address, limit }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/wallets/${address}/positions/open`, { limit });
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+    server.tool("get_wallet_onchain", "Get on-chain data for a wallet — USDC balance, token holdings, and blockchain activity.", { address }, async ({ address }) => {
+        const data = await (0, client_js_1.pmaxisGet)(`/wallets/${address}/onchain`);
+        return { content: [{ type: "text", text: (0, client_js_1.toText)(data) }] };
+    });
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@pmaxis/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for PMAxis — prediction market data tools for AI assistants",
+  "main": "dist/index.js",
+  "bin": {
+    "pmaxis-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "node node_modules/esbuild/bin/esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --banner:js=\"#!/usr/bin/env node\"",
+    "dev": "node node_modules/esbuild/bin/esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js --watch --banner:js=\"#!/usr/bin/env node\"",
+    "typecheck": "node --max-old-space-size=4096 node_modules/typescript/bin/tsc --noEmit",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "esbuild": "^0.21.5",
+    "typescript": "^5.4.5",
+    "@types/node": "^20.12.12"
+  },
+  "files": [
+    "dist/",
+    "package.json"
+  ],
+  "keywords": ["mcp", "polymarket", "prediction-markets", "pmaxis"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}