guessmarket-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GuessMarket
+
+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,131 @@
+# GuessMarket MCP Server
+
+MCP server for [GuessMarket](https://guessmarket.com) prediction markets. Gives AI agents read access to discover markets, analyze price history, view wallet portfolios, and get smart contract ABIs for on-chain trading.
+
+Live on 5 EVM chains: Ethereum, Base, Polygon, BSC, and PulseChain.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_markets` | List prediction markets with filters for status and chain |
+| `get_market` | Get detailed market info: question, YES/NO odds, volume, liquidity, end time |
+| `get_market_history` | Get timestamped price history for trend analysis |
+| `get_networks` | Get all supported chains with contract addresses |
+| `get_portfolio` | Get a wallet's trading activity across all markets |
+| `get_abi` | Get smart contract ABI for building on-chain transactions |
+
+## Quickstart
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "guessmarket": {
+      "command": "npx",
+      "args": ["-y", "guessmarket-mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to your project with the CLI:
+
+```bash
+claude mcp add guessmarket -- npx -y guessmarket-mcp
+```
+
+Or add to `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "guessmarket": {
+      "command": "npx",
+      "args": ["-y", "guessmarket-mcp"]
+    }
+  }
+}
+```
+
+### VS Code
+
+Add to your VS Code settings or `.vscode/mcp.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "guessmarket": {
+        "command": "npx",
+        "args": ["-y", "guessmarket-mcp"]
+      }
+    }
+  }
+}
+```
+
+## Supported Chains
+
+| Chain | Chain ID |
+|-------|----------|
+| Ethereum | 1 |
+| Base | 8453 |
+| Polygon | 137 |
+| BSC | 56 |
+| PulseChain | 369 |
+
+## Configuration
+
+No API keys required — the server uses the public GuessMarket REST API.
+
+### Custom API URL
+
+By default the server connects to `https://guessmarket.com/wp-json/guessmarket/v1`. Override with an environment variable:
+
+```json
+{
+  "mcpServers": {
+    "guessmarket": {
+      "command": "npx",
+      "args": ["-y", "guessmarket-mcp"],
+      "env": {
+        "GUESSMARKET_API_URL": "https://your-instance.com/wp-json/guessmarket/v1"
+      }
+    }
+  }
+}
+```
+
+## Architecture
+
+This server is read-only. It fetches data from the GuessMarket REST API and returns it to the AI agent. Trading happens on-chain — the agent builds and signs its own transactions using the ABIs and contract addresses provided by this server.
+
+```
+AI Agent  <-->  MCP Server  <-->  GuessMarket REST API
+                                        |
+                                  5 EVM Chains
+                              (Ethereum, Base, Polygon,
+                                 BSC, PulseChain)
+```
+
+## Requirements
+
+- Node.js 18 or later (uses native `fetch`)
+
+## Development
+
+```bash
+npm install
+npm run build
+node build/index.js
+```
+
+## License
+
+MIT

package/build/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * GuessMarket MCP Server
+ *
+ * Gives AI agents read access to GuessMarket prediction markets:
+ * discover markets, analyze prices, view portfolios, and get contract
+ * ABIs needed for on-chain trading.
+ *
+ * All data comes from the GuessMarket WordPress REST API.
+ * Trading happens on-chain — the agent signs its own transactions.
+ */
+export {};

package/build/index.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+/**
+ * GuessMarket MCP Server
+ *
+ * Gives AI agents read access to GuessMarket prediction markets:
+ * discover markets, analyze prices, view portfolios, and get contract
+ * ABIs needed for on-chain trading.
+ *
+ * All data comes from the GuessMarket WordPress REST API.
+ * Trading happens on-chain — the agent signs its own transactions.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+const API_BASE = process.env.GUESSMARKET_API_URL?.replace(/\/+$/, '') ||
+    'https://guessmarket.com/wp-json/guessmarket/v1';
+// ─── Helper ──────────────────────────────────────────────────────
+async function api(path) {
+    const url = `${API_BASE}${path}`;
+    const res = await fetch(url, {
+        headers: { 'Accept': 'application/json', 'User-Agent': 'GuessMarket-MCP/1.0' },
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`API ${res.status}: ${body}`);
+    }
+    return res.json();
+}
+// ─── Server ──────────────────────────────────────────────────────
+const server = new McpServer({
+    name: 'guessmarket',
+    version: '1.0.0',
+});
+// ─── Tool: list_markets ──────────────────────────────────────────
+server.tool('list_markets', 'List prediction markets on GuessMarket. Filter by status (active/resolved/all) ' +
+    'and chain_id. Returns market address, question, odds, volume, and end time.', {
+    status: z.enum(['active', 'resolved', 'all']).default('active').describe('Market status filter'),
+    chain_id: z.number().int().optional().describe('EVM chain ID to filter by (e.g. 8453 for Base)'),
+    page: z.number().int().default(1).describe('Page number for pagination'),
+    per_page: z.number().int().default(20).describe('Results per page (max 100)'),
+}, async ({ status, chain_id, page, per_page }) => {
+    const params = new URLSearchParams();
+    params.set('status', status);
+    params.set('page', String(page));
+    params.set('per_page', String(Math.min(per_page, 100)));
+    if (chain_id)
+        params.set('chain_id', String(chain_id));
+    const data = await api(`/markets?${params}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// ─── Tool: get_market ────────────────────────────────────────────
+server.tool('get_market', 'Get detailed info for a single prediction market by its contract address. ' +
+    'Returns question, current YES/NO odds, volume, liquidity, end time, resolution status, and chain.', {
+    address: z.string().regex(/^0x[a-fA-F0-9]{40}$/).describe('Market contract address'),
+}, async ({ address }) => {
+    const data = await api(`/market/${address.toLowerCase()}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// ─── Tool: get_market_history ────────────────────────────────────
+server.tool('get_market_history', 'Get price history for a market. Returns timestamped YES/NO price data points ' +
+    'for charting and trend analysis. Optionally specify chain_id and limit.', {
+    address: z.string().regex(/^0x[a-fA-F0-9]{40}$/).describe('Market contract address'),
+    chain_id: z.number().int().optional().describe('EVM chain ID (auto-detected if omitted)'),
+    limit: z.number().int().default(500).describe('Max data points to return (max 5000)'),
+}, async ({ address, chain_id, limit }) => {
+    const params = new URLSearchParams();
+    if (chain_id)
+        params.set('chain_id', String(chain_id));
+    params.set('limit', String(Math.min(limit, 5000)));
+    const data = await api(`/markets/${address.toLowerCase()}/history?${params}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// ─── Tool: get_networks ──────────────────────────────────────────
+server.tool('get_networks', 'Get all blockchain networks GuessMarket is deployed on, with contract addresses ' +
+    '(MarketFactory, FeeManager, Oracle, Stablecoin) for each chain. Essential for on-chain trading.', async () => {
+    const data = await api('/networks');
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// ─── Tool: get_portfolio ─────────────────────────────────────────
+server.tool('get_portfolio', "Get a wallet's trading activity across all GuessMarket markets. " +
+    'Returns trades with market address, outcome, shares, cost, and timestamp.', {
+    wallet: z.string().regex(/^0x[a-fA-F0-9]{40}$/).describe('Wallet address'),
+    limit: z.number().int().default(50).describe('Max trades to return (max 100)'),
+    offset: z.number().int().default(0).describe('Offset for pagination'),
+}, async ({ wallet, limit, offset }) => {
+    const params = new URLSearchParams();
+    params.set('limit', String(Math.min(limit, 100)));
+    params.set('offset', String(offset));
+    const data = await api(`/portfolio/${wallet.toLowerCase()}?${params}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// ─── Tool: get_abi ───────────────────────────────────────────────
+server.tool('get_abi', 'Get the ABI (Application Binary Interface) for a GuessMarket smart contract. ' +
+    'Use this to build transactions for on-chain trading. ' +
+    'Valid contracts: PredictionMarket, MarketFactory, ERC20, FeeManager, Oracle, SimpleOracle.', {
+    contract: z
+        .enum(['PredictionMarket', 'MarketFactory', 'ERC20', 'FeeManager', 'Oracle', 'SimpleOracle'])
+        .describe('Contract name'),
+}, async ({ contract }) => {
+    const data = await api(`/abis/${contract}`);
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+});
+// ─── Start ───────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('GuessMarket MCP server running on stdio');
+}
+main().catch((err) => {
+    console.error('Fatal:', err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "guessmarket-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for GuessMarket prediction markets — lets AI agents discover markets, analyze prices, view portfolios, and get contract ABIs for on-chain trading across 5 EVM chains",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "guessmarket-mcp": "build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "prediction-markets",
+    "blockchain",
+    "ai-agent",
+    "defi",
+    "evm",
+    "pulsechain",
+    "base",
+    "polygon",
+    "ethereum",
+    "bsc",
+    "guessmarket",
+    "on-chain-trading"
+  ],
+  "author": "GuessMarket (https://guessmarket.com)",
+  "license": "MIT",
+  "homepage": "https://guessmarket.com",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.4",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "@types/node": "^20.0.0"
+  }
+}