@catalyst-team/poly-sdk 0.1.0

package/dist/mcp/index.js

@@ -0,0 +1,173 @@
+/**
+ * Polymarket MCP Tools
+ *
+ * This module provides MCP (Model Context Protocol) tools for interacting with Polymarket.
+ * It can be used to build an MCP server that exposes Polymarket functionality to AI agents.
+ *
+ * Tool Categories:
+ * - Trader Tools: Analyze traders/wallets (positions, trades, profiles, leaderboard)
+ * - Market Tools: Discover and analyze markets (get, search, trending, trades)
+ * - Order Tools: Analyze orderbooks (depth, best prices, execution estimates)
+ * - Trade Tools: Execute trades (limit orders, market orders) - requires API credentials
+ * - Wallet Tools: Deposits and authorization management
+ *
+ * Usage:
+ * ```typescript
+ * import { PolymarketSDK } from '@prediction-router/poly-sdk';
+ * import { createMcpHandler, allToolDefinitions } from '@prediction-router/poly-sdk/mcp';
+ *
+ * const sdk = new PolymarketSDK();
+ * const handler = createMcpHandler(sdk);
+ *
+ * // Use with MCP server
+ * const result = await handler('get_trader_positions', { address: '0x...' });
+ * ```
+ */
+import { McpToolError, wrapError } from './errors.js';
+import { allToolDefinitions, 
+// Guide handlers
+createGuideHandlers, 
+// Trader handlers
+handleGetTraderPositions, handleGetTraderTrades, handleGetTraderProfile, handleGetLeaderboard, 
+// Market handlers
+handleGetMarket, handleSearchMarkets, handleGetTrendingMarkets, handleGetMarketTrades, 
+// Order handlers
+handleGetOrderbook, handleGetBestPrices, handleEstimateExecution, 
+// Trade handlers
+handlePlaceLimitOrder, handlePlaceMarketOrder, handleCancelOrder, handleGetMyOrders, 
+// Wallet handlers
+handleGetSupportedAssets, handleGetDepositAddresses, handleDepositUsdc, handleCheckAllowances, handleApproveTrading, handleSwap, handleSwapAndDeposit, handleGetTokenBalances, handleGetWalletBalances, handleGetSwapQuote, handleGetAvailablePools, } from './tools/index.js';
+// Re-export types
+export * from './types.js';
+export * from './errors.js';
+export { allToolDefinitions } from './tools/index.js';
+/**
+ * Create an MCP tool handler for the given SDK instance
+ */
+export function createMcpHandler(sdk) {
+    // Create guide handlers (no SDK dependency)
+    const guideHandlers = createGuideHandlers();
+    return async (toolName, args) => {
+        try {
+            switch (toolName) {
+                // Guide Tool - should be called FIRST
+                case 'get_usage_guide':
+                    return await guideHandlers.get_usage_guide(args);
+                // Trader Tools
+                case 'get_trader_positions':
+                    return await handleGetTraderPositions(sdk, args);
+                case 'get_trader_trades':
+                    return await handleGetTraderTrades(sdk, args);
+                case 'get_trader_profile':
+                    return await handleGetTraderProfile(sdk, args);
+                case 'get_leaderboard':
+                    return await handleGetLeaderboard(sdk, args);
+                // Market Tools
+                case 'get_market':
+                    return await handleGetMarket(sdk, args);
+                case 'search_markets':
+                    return await handleSearchMarkets(sdk, args);
+                case 'get_trending_markets':
+                    return await handleGetTrendingMarkets(sdk, args);
+                case 'get_market_trades':
+                    return await handleGetMarketTrades(sdk, args);
+                // Order Tools
+                case 'get_orderbook':
+                    return await handleGetOrderbook(sdk, args);
+                case 'get_best_prices':
+                    return await handleGetBestPrices(sdk, args);
+                case 'estimate_execution':
+                    return await handleEstimateExecution(sdk, args);
+                // Trade Tools
+                case 'place_limit_order':
+                    return await handlePlaceLimitOrder(sdk, args);
+                case 'place_market_order':
+                    return await handlePlaceMarketOrder(sdk, args);
+                case 'cancel_order':
+                    return await handleCancelOrder(sdk, args);
+                case 'get_my_orders':
+                    return await handleGetMyOrders(sdk, args);
+                // Wallet Tools
+                case 'get_supported_deposit_assets':
+                    return await handleGetSupportedAssets(sdk, args);
+                case 'get_deposit_addresses':
+                    return await handleGetDepositAddresses(sdk);
+                case 'deposit_usdc':
+                    return await handleDepositUsdc(sdk, args);
+                case 'check_allowances':
+                    return await handleCheckAllowances(sdk);
+                case 'approve_trading':
+                    return await handleApproveTrading(sdk);
+                case 'swap':
+                    return await handleSwap(sdk, args);
+                case 'swap_and_deposit':
+                    return await handleSwapAndDeposit(sdk, args);
+                case 'get_token_balances':
+                    return await handleGetTokenBalances(sdk);
+                case 'get_wallet_balances':
+                    return await handleGetWalletBalances(sdk, args);
+                case 'get_swap_quote':
+                    return await handleGetSwapQuote(sdk, args);
+                case 'get_available_pools':
+                    return await handleGetAvailablePools(sdk);
+                default:
+                    throw new McpToolError('INVALID_INPUT', `Unknown tool: ${toolName}`);
+            }
+        }
+        catch (err) {
+            if (err instanceof McpToolError) {
+                return err.toResponse();
+            }
+            return wrapError(err).toResponse();
+        }
+    };
+}
+/**
+ * Get all tool definitions for MCP registration
+ */
+export function getToolDefinitions() {
+    return allToolDefinitions;
+}
+/**
+ * MCP Server factory (for use with @modelcontextprotocol/sdk)
+ *
+ * Example usage with MCP SDK:
+ * ```typescript
+ * import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+ * import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+ * import { PolymarketSDK } from '@prediction-router/poly-sdk';
+ * import { registerMcpTools } from '@prediction-router/poly-sdk/mcp';
+ *
+ * const server = new Server(
+ *   { name: 'poly-mcp', version: '1.0.0' },
+ *   { capabilities: { tools: {} } }
+ * );
+ *
+ * const sdk = new PolymarketSDK();
+ * registerMcpTools(server, sdk);
+ *
+ * const transport = new StdioServerTransport();
+ * await server.connect(transport);
+ * ```
+ */
+export function registerMcpTools(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+server, sdk) {
+    const handler = createMcpHandler(sdk);
+    // Register list tools handler
+    server.setRequestHandler({ method: 'tools/list' }, async () => ({ tools: allToolDefinitions }));
+    // Register call tool handler
+    server.setRequestHandler({ method: 'tools/call' }, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        const result = await handler(name, args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * Polymarket MCP Server
+ *
+ * A standalone MCP server that exposes Polymarket functionality to AI agents.
+ *
+ * Usage:
+ *   npx @prediction-router/poly-sdk-mcp
+ *   # or
+ *   node dist/mcp/server.js
+ *
+ * Configuration via environment variables:
+ *   - POLY_PRIVATE_KEY: Wallet private key (required for trading, API credentials are derived automatically)
+ *   - POLY_CHAIN_ID: Chain ID (137 for mainnet, 80002 for testnet, default: 137)
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

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

package/dist/mcp/server.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+/**
+ * Polymarket MCP Server
+ *
+ * A standalone MCP server that exposes Polymarket functionality to AI agents.
+ *
+ * Usage:
+ *   npx @prediction-router/poly-sdk-mcp
+ *   # or
+ *   node dist/mcp/server.js
+ *
+ * Configuration via environment variables:
+ *   - POLY_PRIVATE_KEY: Wallet private key (required for trading, API credentials are derived automatically)
+ *   - POLY_CHAIN_ID: Chain ID (137 for mainnet, 80002 for testnet, default: 137)
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { Wallet } from 'ethers';
+import { PolymarketSDK } from '../index.js';
+import { allToolDefinitions } from './tools/index.js';
+import { createMcpHandler } from './index.js';
+/**
+ * Create a wallet signer from private key if available
+ */
+function createSigner() {
+    const privateKey = process.env.POLY_PRIVATE_KEY;
+    if (!privateKey) {
+        return undefined;
+    }
+    try {
+        // Ensure private key has 0x prefix
+        const formattedKey = privateKey.startsWith('0x') ? privateKey : `0x${privateKey}`;
+        return new Wallet(formattedKey);
+    }
+    catch (error) {
+        console.error('Failed to create wallet from POLY_PRIVATE_KEY:', error);
+        return undefined;
+    }
+}
+// Server metadata
+const SERVER_NAME = 'polymarket-mcp';
+const SERVER_VERSION = '0.1.0';
+/**
+ * Create and configure the MCP server
+ */
+function createServer() {
+    const server = new Server({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Create signer from private key if available
+    const signer = createSigner();
+    // Initialize SDK with environment configuration
+    // API credentials are derived automatically from private key via createOrDeriveApiKey()
+    const sdk = new PolymarketSDK({
+        chainId: process.env.POLY_CHAIN_ID ? parseInt(process.env.POLY_CHAIN_ID) : 137,
+        signer,
+    });
+    // Log trading status
+    if (signer) {
+        console.error(`Trading enabled for wallet: ${signer.address}`);
+    }
+    else {
+        console.error('Trading disabled (set POLY_PRIVATE_KEY to enable)');
+    }
+    // Create the tool handler
+    const handler = createMcpHandler(sdk);
+    // Register list tools handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: allToolDefinitions.map((tool) => ({
+                name: tool.name,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+            })),
+        };
+    });
+    // Register call tool handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        try {
+            const result = await handler(name, args);
+            // Check if result is an error response
+            if (result && typeof result === 'object' && 'error' in result) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: {
+                                code: 'INTERNAL_ERROR',
+                                message: errorMessage,
+                            },
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    // Handle shutdown gracefully
+    process.on('SIGINT', async () => {
+        await server.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await server.close();
+        process.exit(0);
+    });
+    // Connect and run
+    await server.connect(transport);
+    // Log to stderr (stdout is reserved for MCP protocol)
+    console.error(`${SERVER_NAME} v${SERVER_VERSION} started`);
+    console.error(`Available tools: ${allToolDefinitions.length}`);
+}
+// Run the server
+main().catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools/guide.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Usage Guide Tool
+ *
+ * AI agents should call this tool FIRST to understand how to use Polymarket MCP.
+ * Returns common use cases and recommended tool combinations.
+ */
+import type { ToolDefinition } from '../types.js';
+type GuideHandler = (args: Record<string, unknown>) => Promise<unknown>;
+export declare const guideToolDefinitions: ToolDefinition[];
+export declare function createGuideHandlers(): Record<string, GuideHandler>;
+export {};
+//# sourceMappingURL=guide.d.ts.map

package/dist/mcp/tools/guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/guide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAExE,eAAO,MAAM,oBAAoB,EAAE,cAAc,EA2BhD,CAAC;AAkvBF,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CA2BlE"}