context-markets-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Context
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+<p align="center">
+  <img src="https://mainnet.contextcdn.com/ced823d63df9dff0390d9ad0a4e1ad3905dd199a6c50758c18a5c92a203adbd7" alt="Context" width="100%" />
+</p>
+
+<h1 align="center">Context MCP Server</h1>
+<p align="center">Browse, trade, and create prediction markets from any AI agent.</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/context-markets-mcp"><img src="https://img.shields.io/npm/v/context-markets-mcp" alt="npm" /></a>
+  <a href="https://github.com/contextwtf/context-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License: MIT" /></a>
+  <a href="https://discord.gg/RVmzZsAyM4"><img src="https://img.shields.io/badge/Discord-Join-7289da" alt="Discord" /></a>
+</p>
+
+## Quick Start
+
+### Claude Code
+
+```bash
+claude mcp add context-markets -- npx context-markets-mcp
+```
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "context-markets": {
+      "command": "npx",
+      "args": ["context-markets-mcp"],
+      "env": {
+        "CONTEXT_API_KEY": "your-api-key",
+        "CONTEXT_PRIVATE_KEY": "your-wallet-private-key"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Read-only (no auth needed)
+
+`context_list_markets` · `context_get_market` · `context_get_quotes` · `context_get_orderbook` · `context_simulate_trade` · `context_price_history` · `context_get_oracle` · `context_global_activity`
+
+### Trading (requires API key + private key)
+
+`context_place_order` · `context_cancel_order` · `context_my_orders` · `context_get_portfolio` · `context_get_balance` · `context_account_setup` · `context_mint_test_usdc` · `context_create_market`
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CONTEXT_API_KEY` | For all tools | API key from context.markets |
+| `CONTEXT_PRIVATE_KEY` | For trading only | Ethereum private key for signing |
+
+Read-only tools work with zero config. Need an API key? Visit [context.markets](https://context.markets).
+
+## Documentation
+
+- **[Tool Catalog](https://docs.context.markets/agents/mcp/tools)** — full list of tools with parameters and examples
+- **[MCP Guide](https://docs.context.markets/agents/mcp)** — setup, configuration, and usage patterns
+
+## Ecosystem
+
+| Package | Description |
+|---------|-------------|
+| **[context-markets](https://github.com/contextwtf/context-sdk)** | TypeScript SDK for trading |
+| **[@contextwtf/react](https://github.com/contextwtf/context-react)** | React hooks for market data and trading |
+| **[context-markets-mcp](https://github.com/contextwtf/context-mcp)** | MCP server for AI agents |
+| **[@contextwtf/cli](https://github.com/contextwtf/context-cli)** | CLI for trading from the terminal |
+| **[context-skills](https://github.com/contextwtf/context-skills)** | AI agent skill files |
+| **[context-plugin](https://github.com/contextwtf/context-plugin)** | Claude Code plugin |
+
+## License
+
+MIT — see [LICENSE](./LICENSE) for details.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import dotenv from "dotenv";
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+import { registerMarketTools } from "./tools/markets.js";
+import { registerOrderTools } from "./tools/orders.js";
+import { registerPortfolioTools } from "./tools/portfolio.js";
+import { registerAccountTools } from "./tools/account.js";
+import { registerQuestionTools } from "./tools/questions.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+dotenv.config({ path: resolve(__dirname, "..", ".env") });
+const server = new McpServer({
+    name: "context-markets",
+    version: "0.1.0",
+});
+registerMarketTools(server);
+registerOrderTools(server);
+registerPortfolioTools(server);
+registerAccountTools(server);
+registerQuestionTools(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Context Markets MCP server running");
+}
+main().catch((error) => {
+    console.error("Fatal:", error);
+    process.exit(1);
+});

package/dist/lib/client.d.ts

@@ -0,0 +1,3 @@
+import { ContextClient } from "context-markets";
+export declare function getReadClient(): ContextClient;
+export declare function getTradingClient(): ContextClient;

package/dist/lib/client.js

@@ -0,0 +1,26 @@
+import { ContextClient } from "context-markets";
+let readClientInstance = null;
+let tradingClientInstance = null;
+export function getReadClient() {
+    if (!readClientInstance) {
+        readClientInstance = new ContextClient({
+            apiKey: process.env.CONTEXT_API_KEY,
+        });
+    }
+    return readClientInstance;
+}
+export function getTradingClient() {
+    if (!tradingClientInstance) {
+        const apiKey = process.env.CONTEXT_API_KEY;
+        const privateKey = process.env.CONTEXT_PRIVATE_KEY;
+        if (!privateKey) {
+            throw new Error("CONTEXT_PRIVATE_KEY is required for trading operations. " +
+                "Set it in your MCP server env config.");
+        }
+        tradingClientInstance = new ContextClient({
+            apiKey,
+            signer: { privateKey: privateKey },
+        });
+    }
+    return tradingClientInstance;
+}

package/dist/lib/utils.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function toolResult(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toolError(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+export type Server = InstanceType<typeof McpServer>;

package/dist/lib/utils.js

@@ -0,0 +1,26 @@
+export function toolResult(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof data === "string" ? data : JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+export function toolError(error) {
+    let message;
+    if (error instanceof Error) {
+        message = error.message;
+        if ("status" in error && typeof error.status === "number") {
+            message = `[${error.status}] ${message}`;
+        }
+    }
+    else {
+        message = String(error);
+    }
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}

package/dist/tools/account.d.ts

@@ -0,0 +1,2 @@
+import { type Server } from "../lib/utils.js";
+export declare function registerAccountTools(server: Server): void;

package/dist/tools/account.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { getTradingClient } from "../lib/client.js";
+import { toolResult, toolError } from "../lib/utils.js";
+export function registerAccountTools(server) {
+    // 1. Set up trading account
+    server.tool("context_account_setup", "Set up your trading account — approves USDC spending and operator permissions. Run this before your first trade. Requires CONTEXT_PRIVATE_KEY.", {}, async () => {
+        try {
+            const client = getTradingClient();
+            const status = await client.account.status();
+            if (!status.needsApprovals) {
+                return toolResult({
+                    message: "Account already set up.",
+                    status,
+                });
+            }
+            const result = await client.account.setup();
+            return toolResult({
+                message: "Account setup complete. You can now place trades.",
+                result,
+            });
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 2. Mint test USDC
+    server.tool("context_mint_test_usdc", "Mint test USDC on Base Sepolia testnet for paper trading. Default 1000 USDC. Requires CONTEXT_PRIVATE_KEY.", {
+        amount: z
+            .number()
+            .describe("Amount of test USDC to mint (default 1000)")
+            .optional(),
+    }, async (params) => {
+        try {
+            const client = getTradingClient();
+            const mintAmount = params.amount ?? 1000;
+            await client.account.mintTestUsdc(mintAmount);
+            return toolResult({
+                message: `Minted ${mintAmount} test USDC successfully.`,
+                amount: mintAmount,
+            });
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+}

package/dist/tools/markets.d.ts

@@ -0,0 +1,2 @@
+import { type Server } from "../lib/utils.js";
+export declare function registerMarketTools(server: Server): void;

package/dist/tools/markets.js

@@ -0,0 +1,138 @@
+import { z } from "zod";
+import { getReadClient } from "../lib/client.js";
+import { toolResult, toolError } from "../lib/utils.js";
+export function registerMarketTools(server) {
+    // 1. List and search prediction markets
+    server.tool("context_list_markets", "List and search prediction markets on Context Markets. Returns market titles, prices, volume, and status.", {
+        query: z.string().describe("Search query to filter markets by title or description").optional(),
+        status: z
+            .enum(["active", "pending", "resolved", "closed"])
+            .describe("Filter by market status")
+            .optional(),
+        category: z.string().describe("Filter by market category").optional(),
+        sortBy: z
+            .enum(["new", "volume", "trending", "ending", "chance"])
+            .describe("Sort order for results")
+            .optional(),
+        limit: z.number().describe("Maximum number of markets to return").optional(),
+    }, async (params) => {
+        try {
+            const client = getReadClient();
+            const result = await client.markets.list({
+                query: params.query,
+                status: params.status,
+                sortBy: params.sortBy,
+                category: params.category,
+                limit: params.limit,
+            });
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 2. Get detailed market information
+    server.tool("context_get_market", "Get detailed information about a specific prediction market including description, resolution criteria, prices, and status.", {
+        marketId: z.string().describe("The unique identifier of the market"),
+    }, async (params) => {
+        try {
+            const client = getReadClient();
+            const result = await client.markets.get(params.marketId);
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 3. Get current quotes (bid/ask/last prices)
+    server.tool("context_get_quotes", "Get current bid/ask/last prices for a market's YES and NO outcomes. Prices are in cents (1-99 = 1%-99% probability).", {
+        marketId: z.string().describe("The unique identifier of the market"),
+    }, async (params) => {
+        try {
+            const client = getReadClient();
+            const result = await client.markets.quotes(params.marketId);
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 4. Get the orderbook
+    server.tool("context_get_orderbook", "Get the orderbook (bid/ask ladder) for a market. Shows available liquidity at each price level.", {
+        marketId: z.string().describe("The unique identifier of the market"),
+        depth: z.number().describe("Number of price levels to return on each side of the book").optional(),
+    }, async (params) => {
+        try {
+            const client = getReadClient();
+            const result = await client.markets.fullOrderbook(params.marketId, {
+                depth: params.depth,
+            });
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 5. Simulate a trade
+    server.tool("context_simulate_trade", "Simulate a trade to see estimated fill price, cost, and slippage before placing a real order. Does not execute.", {
+        marketId: z.string().describe("The unique identifier of the market"),
+        side: z.enum(["yes", "no"]).describe("Which outcome to buy: yes or no"),
+        amount: z.number().describe("Amount in USD to simulate trading"),
+    }, async (params) => {
+        try {
+            const client = getReadClient();
+            const result = await client.markets.simulate(params.marketId, {
+                side: params.side,
+                amount: params.amount,
+                amountType: "usd",
+            });
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 6. Get price history
+    server.tool("context_price_history", "Get historical price data for a market over a specified timeframe.", {
+        marketId: z.string().describe("The unique identifier of the market"),
+        timeframe: z
+            .enum(["1h", "6h", "1d", "1w", "1M", "all"])
+            .describe("Timeframe for the price history data")
+            .optional(),
+    }, async (params) => {
+        try {
+            const client = getReadClient();
+            const result = await client.markets.priceHistory(params.marketId, {
+                timeframe: params.timeframe,
+            });
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 7. Get oracle analysis
+    server.tool("context_get_oracle", "Get the AI oracle's resolution analysis for a market, including confidence level and sources monitored.", {
+        marketId: z.string().describe("The unique identifier of the market"),
+    }, async (params) => {
+        try {
+            const client = getReadClient();
+            const result = await client.markets.oracle(params.marketId);
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 8. Get global activity
+    server.tool("context_global_activity", "Get recent trading activity across all markets on Context Markets.", {}, async () => {
+        try {
+            const client = getReadClient();
+            const result = await client.markets.globalActivity();
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+}

package/dist/tools/orders.d.ts

@@ -0,0 +1,2 @@
+import { type Server } from "../lib/utils.js";
+export declare function registerOrderTools(server: Server): void;

package/dist/tools/orders.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { getTradingClient } from "../lib/client.js";
+import { toolResult, toolError } from "../lib/utils.js";
+export function registerOrderTools(server) {
+    // 1. Place a buy order
+    server.tool("context_place_order", "Place a buy order on a prediction market. Requires CONTEXT_PRIVATE_KEY. Prices in cents (1-99), size in contracts (min 0.01).", {
+        marketId: z.string().describe("The unique identifier of the market"),
+        side: z.enum(["yes", "no"]).describe("Which outcome to buy: yes or no"),
+        size: z.number().describe("Number of contracts to buy (min 0.01)"),
+        price: z
+            .number()
+            .describe("Limit price in cents (1-99). Omit for a market order.")
+            .optional(),
+    }, async (params) => {
+        try {
+            const client = getTradingClient();
+            let result;
+            if (params.price !== undefined) {
+                result = await client.orders.create({
+                    marketId: params.marketId,
+                    outcome: params.side,
+                    side: "buy",
+                    priceCents: params.price,
+                    size: params.size,
+                });
+            }
+            else {
+                result = await client.orders.createMarket({
+                    marketId: params.marketId,
+                    outcome: params.side,
+                    side: "buy",
+                    maxPriceCents: 99,
+                    maxSize: params.size,
+                });
+            }
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 2. Cancel an open order
+    server.tool("context_cancel_order", "Cancel an open order by its nonce. Requires CONTEXT_PRIVATE_KEY.", {
+        nonce: z.string().describe("The nonce of the order to cancel"),
+    }, async (params) => {
+        try {
+            const client = getTradingClient();
+            const result = await client.orders.cancel(params.nonce);
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 3. List open orders
+    server.tool("context_my_orders", "List your open orders, optionally filtered to a specific market. Requires CONTEXT_PRIVATE_KEY.", {
+        marketId: z
+            .string()
+            .describe("Filter orders to a specific market")
+            .optional(),
+    }, async (params) => {
+        try {
+            const client = getTradingClient();
+            const result = await client.orders.allMine(params.marketId);
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+}

package/dist/tools/portfolio.d.ts

@@ -0,0 +1,2 @@
+import { type Server } from "../lib/utils.js";
+export declare function registerPortfolioTools(server: Server): void;

package/dist/tools/portfolio.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { getTradingClient } from "../lib/client.js";
+import { toolResult, toolError } from "../lib/utils.js";
+export function registerPortfolioTools(server) {
+    // 1. Get portfolio positions
+    server.tool("context_get_portfolio", "Get your prediction market positions with P&L. Filter by kind: all, active, won, lost, or claimable. Requires CONTEXT_PRIVATE_KEY.", {
+        kind: z
+            .enum(["all", "active", "won", "lost", "claimable"])
+            .describe("Filter positions by kind")
+            .optional(),
+    }, async (params) => {
+        try {
+            const client = getTradingClient();
+            const result = await client.portfolio.get(undefined, {
+                kind: params.kind ?? "all",
+            });
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 2. Get balance
+    server.tool("context_get_balance", "Get your USDC balance (wallet + settlement) and outcome token holdings. Requires CONTEXT_PRIVATE_KEY.", {}, async () => {
+        try {
+            const client = getTradingClient();
+            const result = await client.portfolio.balance();
+            return toolResult(result);
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+}

package/dist/tools/questions.d.ts

@@ -0,0 +1,2 @@
+import { type Server } from "../lib/utils.js";
+export declare function registerQuestionTools(server: Server): void;

package/dist/tools/questions.js

@@ -0,0 +1,83 @@
+import { z } from "zod";
+import { getTradingClient } from "../lib/client.js";
+import { toolResult, toolError } from "../lib/utils.js";
+export function registerQuestionTools(server) {
+    // 1. Create a new prediction market from a question
+    server.tool("context_create_market", "Create a new prediction market from a natural language question. The AI oracle processes the question and generates a market. This may take 30-90 seconds. Requires CONTEXT_PRIVATE_KEY.", {
+        question: z
+            .string()
+            .describe("A natural language question to create a prediction market for"),
+    }, async (params) => {
+        try {
+            const client = getTradingClient();
+            const submission = await client.questions.submitAndWait(params.question);
+            if (submission.status === "failed") {
+                return toolError("Oracle failed to process the question. Try rephrasing.");
+            }
+            if (!submission.questions?.length) {
+                return toolError("Oracle returned no market questions.");
+            }
+            const generated = submission.questions[0];
+            const market = await client.markets.create(generated.id);
+            return toolResult({
+                message: "Market created successfully!",
+                market,
+                generatedQuestion: generated,
+            });
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+    // 2. Submit a fully-formed market draft directly
+    server.tool("context_agent_submit_market", "Submit a fully-formed market draft with custom resolution criteria, wait for oracle approval, and create the market on-chain. This may take 30-90 seconds. Use this when you want full control over question, criteria, sources, and end time. Requires CONTEXT_PRIVATE_KEY.", {
+        formattedQuestion: z.string().describe("Full question text for the market"),
+        shortQuestion: z.string().describe("Short display title for the market"),
+        marketType: z.enum(["SUBJECTIVE", "OBJECTIVE"]).describe("Whether resolution is subjective (opinion-based) or objective (verifiable fact)"),
+        evidenceMode: z.enum(["social_only", "web_enabled"]).describe("Evidence sources: social_only for social signals, web_enabled for web scraping"),
+        resolutionCriteria: z.string().describe("Clear criteria for how this market should resolve"),
+        endTime: z.string().describe("Market end time as 'YYYY-MM-DD HH:MM:SS'"),
+        timezone: z.string().describe("IANA timezone identifier").default("America/New_York"),
+        sources: z.array(z.string()).describe("URLs to monitor for evidence").optional(),
+        explanation: z.string().max(120).describe("Brief explanation of the market (max 120 chars)").optional(),
+    }, async (params) => {
+        try {
+            const client = getTradingClient();
+            const submission = await client.questions.agentSubmitAndWait({
+                market: {
+                    formattedQuestion: params.formattedQuestion,
+                    shortQuestion: params.shortQuestion,
+                    marketType: params.marketType,
+                    evidenceMode: params.evidenceMode,
+                    resolutionCriteria: params.resolutionCriteria,
+                    endTime: params.endTime,
+                    timezone: params.timezone,
+                    sources: params.sources,
+                    explanation: params.explanation,
+                },
+            });
+            if (submission.status === "failed") {
+                return toolError("Oracle failed to process the market draft. Try adjusting your criteria.");
+            }
+            if (submission.refuseToResolve) {
+                const reasons = submission.rejectionReasons
+                    ?.map((r) => r.message)
+                    .join("; ");
+                return toolError(`Market draft rejected: ${reasons || "Unknown reason"}`);
+            }
+            if (!submission.questions?.length) {
+                return toolError("Oracle returned no market questions.");
+            }
+            const generated = submission.questions[0];
+            const market = await client.markets.create(generated.id);
+            return toolResult({
+                message: "Market created successfully!",
+                market,
+                generatedQuestion: generated,
+            });
+        }
+        catch (error) {
+            return toolError(error);
+        }
+    });
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "context-markets-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Context Markets — browse, trade, and create prediction markets from any AI agent",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "context-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js"
+  },
+  "dependencies": {
+    "context-markets": "^0.4.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "dotenv": "^16.3.1",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "files": ["dist"],
+  "keywords": ["mcp", "context-markets", "prediction-markets", "ai-agent"],
+  "license": "MIT",
+  "homepage": "https://docs.context.markets/agents/mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/contextwtf/context-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/contextwtf/context-mcp/issues"
+  },
+  "author": "Context"
+}