Add MCP (Model Context Protocol) server support

.env.example

@@ -12,4 +12,4 @@ LIMITLESS_PRIVATE_KEY=0x1234567890abcdef...
 
 # TODO: OpenRouter API (for LLM-based market matching)
 OPENROUTER_API_KEY=sk-or-...
-OPENROUTER_MODEL=xiaomi/mimo-v2-flash:free
+OPENROUTER_MODEL=xiaomi/mimo-v2-flash:free

.gitignore

@@ -54,6 +54,9 @@ Thumbs.db
 *.log
 .cache/
 
+# Development/Testing files (not for commit)
+.dev/
+
 .references/
 
 .claude/

README.md

@@ -59,6 +59,7 @@ dr_manhattan/
 - Order tracking and event logging
 - Standardized error handling
 - Exchange-agnostic code
+- **MCP server for Claude Desktop integration**
 
 ## Installation
 
@@ -150,6 +151,60 @@ print(list_exchanges())  # ['polymarket', 'limitless', 'opinion']
 exchange = create_exchange('polymarket', {'timeout': 30})
 ```
 
+### MCP Server
+
+Trade prediction markets directly from Claude using the Model Context Protocol (MCP).
+
+```bash
+# Install with MCP dependencies
+uv sync --extra mcp
+
+# Configure credentials
+cp .env.example .env
+# Edit .env with your POLYMARKET_PRIVATE_KEY and POLYMARKET_FUNDER
+```
+
+#### Claude Code
+
+Add to `~/.claude/settings.json` or project `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "dr-manhattan": {
+      "command": "/path/to/dr-manhattan/.venv/bin/python",
+      "args": ["-m", "dr_manhattan.mcp.server"],
+      "cwd": "/path/to/dr-manhattan"
+    }
+  }
+}
+```
+
+Restart Claude Code and verify with `/mcp`.
+
+#### Claude Desktop
+
+Add to Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "dr-manhattan": {
+      "command": "/path/to/dr-manhattan/.venv/bin/python",
+      "args": ["-m", "dr_manhattan.mcp.server"],
+      "cwd": "/path/to/dr-manhattan"
+    }
+  }
+}
+```
+
+After restarting, you can:
+- "Show my Polymarket balance"
+- "Find active prediction markets"
+- "Buy 10 USDC of Yes on market X at 0.55"
+
+See [examples/mcp_usage_example.md](examples/mcp_usage_example.md) for the complete setup guide.
+
 ## Adding New Exchanges
 
 To add a new exchange, create a class that inherits from `Exchange`:
@@ -222,6 +277,7 @@ All errors inherit from `DrManhattanError`:
 
 Check out the [examples/](examples/) directory for working examples:
 
+- **mcp_usage_example.md** - Complete MCP server setup and usage guide for Claude Desktop
 - **list_all_markets.py** - List markets from any exchange
 - **spread_strategy.py** - Exchange-agnostic BBO market making strategy
 

dr_manhattan/mcp/__init__.py

@@ -0,0 +1,8 @@
+"""
+Dr. Manhattan MCP Server
+
+MCP (Model Context Protocol) server for prediction market trading.
+Provides AI agents with access to all Dr. Manhattan functionality.
+"""
+
+__version__ = "0.0.2"