@pmxt/mcp 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Entry point for the PMXT MCP server.
+ *
+ * Usage:
+ *   npx @pmxt/mcp                          # hosted mode (needs PMXT_API_KEY)
+ *   PMXT_API_KEY=pmxt_live_... npx @pmxt/mcp
+ *   PMXT_API_URL=http://localhost:3847 npx @pmxt/mcp  # sidecar mode
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Entry point for the PMXT MCP server.
+ *
+ * Usage:
+ *   npx @pmxt/mcp                          # hosted mode (needs PMXT_API_KEY)
+ *   PMXT_API_KEY=pmxt_live_... npx @pmxt/mcp
+ *   PMXT_API_URL=http://localhost:3847 npx @pmxt/mcp  # sidecar mode
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { createServer } from "./server.js";
+const config = loadConfig();
+const server = createServer(config);
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+/**
+ * MCP server for PMXT.
+ *
+ * Registers one tool per PMXT REST API endpoint. Each tool call is
+ * translated into an HTTP POST to the PMXT API (hosted or sidecar).
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { Config } from "./config.js";
+export declare function createServer(config: Config): Server;

package/dist/server.js

@@ -0,0 +1,93 @@
+/**
+ * MCP server for PMXT.
+ *
+ * Registers one tool per PMXT REST API endpoint. Each tool call is
+ * translated into an HTTP POST to the PMXT API (hosted or sidecar).
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { TOOLS } from "./generated/tools.js";
+import { callPmxtApi } from "./client.js";
+import { reconstructArgs } from "./args.js";
+const INSTRUCTIONS = `PMXT is a unified API for prediction markets (Polymarket, Kalshi, Limitless, and more). \
+Same methods, same response shape, regardless of venue.
+
+SETUP: Get an API key at pmxt.dev/dashboard. Set PMXT_API_KEY in your environment.
+
+IMPORTANT RULES:
+- NEVER place orders (createOrder, submitOrder) without explicit user confirmation. \
+These spend real money. Always show the user the order details (venue, market, side, price, amount) and wait for approval.
+- cancelOrder also requires user confirmation.
+- Read-only tools (fetchMarkets, fetchOrderBook, etc.) are safe to call freely.
+- Venue credentials (privateKey, apiKey) are sensitive. Never log or display them.
+
+WORKFLOW:
+1. Use fetchMarkets or fetchEvents to discover markets (use the "query" param for search).
+2. Use fetchOrderBook to check liquidity and prices.
+3. Use getExecutionPrice to quote a trade before placing it.
+4. Use buildOrder to preview, then submitOrder to execute (with user approval).
+
+The "exchange" param is required on every call. Options: polymarket, kalshi, limitless, probable, etc.`;
+export function createServer(config) {
+    const server = new Server({ name: "@pmxt/mcp", version: "0.1.0" }, {
+        capabilities: { tools: {} },
+        instructions: INSTRUCTIONS,
+    });
+    const toolMap = new Map();
+    for (const tool of TOOLS) {
+        toolMap.set(tool.name, tool);
+    }
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: TOOLS.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+            annotations: t.annotations,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: rawArgs } = request.params;
+        const def = toolMap.get(name);
+        if (!def) {
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        const input = (rawArgs ?? {});
+        const exchange = input.exchange;
+        if (!exchange) {
+            return {
+                content: [
+                    { type: "text", text: "Missing required parameter: exchange" },
+                ],
+                isError: true,
+            };
+        }
+        // Separate credentials from the rest of the input
+        const credentials = input.credentials;
+        const { exchange: _ex, credentials: _cred, ...rest } = input;
+        const args = reconstructArgs(rest, def.args);
+        try {
+            const result = await callPmxtApi(config, {
+                exchange,
+                method: def.method,
+                args,
+                credentials,
+            });
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `PMXT API error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@pmxt/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for PMXT - the unified prediction market API",
+  "type": "module",
+  "bin": {
+    "pmxt-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "generate": "node scripts/generate-tools.cjs",
+    "prebuild": "npm run clean",
+    "build": "tsc",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "prediction-markets",
+    "polymarket",
+    "kalshi",
+    "trading",
+    "ai-agent",
+    "llm",
+    "model-context-protocol"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "js-yaml": "^4.1.0",
+    "typescript": "^5.0.0"
+  }
+}