feat(mcp): add SSE server for remote MCP deployment

.claude/settings.local.json

@@ -5,7 +5,18 @@
       "Bash(uv add:*)",
       "Bash(uv sync:*)",
       "Bash(find:*)",
-      "WebFetch(domain:docs.kalshi.com)"
+      "WebFetch(domain:docs.kalshi.com)",
+      "Bash(git rebase:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr diff:*)",
+      "WebFetch(domain:docs.polymarket.com)",
+      "WebSearch",
+      "Bash(python:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(bun add:*)",
+      "Bash(ln:*)",
+      "Bash(grep:*)",
+      "Bash(bun run build:*)"
     ],
     "deny": [],
     "ask": []

.dockerignore

@@ -0,0 +1,28 @@
+# Environment and secrets
+.env
+.env.*
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+
+# IDE
+.vscode/
+.idea/
+
+# Git
+.git/
+
+# Testing
+.pytest_cache/
+tests/
+
+# Documentation (not needed in container)
+examples/
+wiki/
+
+# Development files
+.dev/
+.claude/

.env.example

@@ -2,6 +2,12 @@
 POLYMARKET_PRIVATE_KEY=0x1234567890abcdef...
 POLYMARKET_FUNDER=0xYourFunderAddressHere
 
+# Polymarket Builder API (for CTF operations: split/merge/redeem)
+# Get these from Polymarket's Builder API
+BUILDER_API_KEY=your-builder-api-key
+BUILDER_SECRET=your-builder-secret-base64
+BUILDER_PASS_PHRASE=your-builder-passphrase
+
 # Opinion Trading Configuration
 OPINION_API_KEY=your_api_key_here
 OPINION_PRIVATE_KEY=0x1234567890abcdef...

Dockerfile

@@ -0,0 +1,33 @@
+# Dr. Manhattan MCP Server - SSE Transport
+# For Railway deployment
+
+FROM python:3.13-slim
+
+WORKDIR /app
+
+# Install uv for fast dependency management (per CLAUDE.md rule 3)
+RUN pip install --no-cache-dir uv
+
+# Copy dependency files first (layer caching optimization)
+COPY pyproject.toml README.md ./
+
+# Install dependencies before copying code (changes to code won't invalidate this layer)
+RUN uv pip install --system ".[mcp]"
+
+# Copy source code (this layer changes frequently)
+COPY dr_manhattan/ ./dr_manhattan/
+
+# Expose port (Railway will set PORT env var)
+EXPOSE 8080
+
+# Environment defaults
+ENV PORT=8080
+ENV LOG_LEVEL=INFO
+ENV HOST=0.0.0.0
+
+# Health check using Python (curl not available in python:slim)
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8080/health')" || exit 1
+
+# Run SSE server
+CMD ["python", "-m", "dr_manhattan.mcp.server_sse"]

README.md

@@ -29,12 +29,23 @@ dr_manhattan/
 │   ├── websocket.py    # WebSocket base class
 │   └── errors.py       # Exception hierarchy
 ├── exchanges/          # Exchange implementations
-│   ├── polymarket.py
-│   ├── polymarket_ws.py
+│   ├── polymarket/     # Polymarket (mixin-based package) → [detailed docs](dr_manhattan/exchanges/polymarket/README.md)
+│   │   ├── __init__.py         # Unified Polymarket class
+│   │   ├── polymarket_core.py  # Constants, init, request helpers
+│   │   ├── polymarket_clob.py  # CLOB API (orders, positions)
+│   │   ├── polymarket_gamma.py # Gamma API (markets, events, search)
+│   │   ├── polymarket_data.py  # Data API (trades, analytics)
+│   │   ├── polymarket_ctf.py   # CTF (split/merge/redeem)
+│   │   ├── polymarket_ws.py    # Market/User WebSocket
+│   │   ├── polymarket_ws_ext.py # Sports/RTDS WebSocket
+│   │   ├── polymarket_builder.py  # Builder API
+│   │   └── polymarket_operator.py # Operator API
+│   ├── kalshi.py
 │   ├── opinion.py
 │   ├── limitless.py
 │   ├── limitless_ws.py
-│   └── predictfun.py
+│   ├── predictfun.py
+│   └── predictfun_ws.py
 ├── models/             # Data models
 │   ├── market.py
 │   ├── order.py
@@ -210,6 +221,28 @@ Add to Claude Desktop config (`~/Library/Application Support/Claude/claude_deskt
 }
 ```
 
+#### Remote Server (No Installation Required)
+
+Connect to the hosted MCP server via SSE. No private keys needed - uses Polymarket Builder profile:
+
+```json
+{
+  "mcpServers": {
+    "dr-manhattan": {
+      "type": "sse",
+      "url": "https://dr-manhattan-mcp-production.up.railway.app/sse",
+      "headers": {
+        "X-Polymarket-Api-Key": "your_api_key",
+        "X-Polymarket-Api-Secret": "your_api_secret",
+        "X-Polymarket-Passphrase": "your_passphrase"
+      }
+    }
+  }
+}
+```
+
+**Note:** Remote server supports Polymarket trading only. Other exchanges are read-only for security. See [wiki/mcp/remote-server.md](wiki/mcp/remote-server.md) for details.
+
 After restarting, you can:
 - "Show my Polymarket balance"
 - "Find active prediction markets"

dr_manhattan/exchanges/__init__.py

@@ -2,10 +2,14 @@
 from .limitless import Limitless
 from .opinion import Opinion
 from .polymarket import Polymarket
+from .polymarket.polymarket_builder import PolymarketBuilder
+from .polymarket.polymarket_operator import PolymarketOperator
 from .predictfun import PredictFun
 
 __all__ = [
     "Polymarket",
+    "PolymarketBuilder",
+    "PolymarketOperator",
     "Limitless",
     "Opinion",
     "PredictFun",