Polymarket Live
An AI-powered trading bot and MCP server for analyzing cricket betting markets on Polymarket.
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
An AI-powered trading bot and MCP server for analyzing cricket betting markets on Polymarket.
Polymarket research MCP server with 10 tools (odds, orderbook, spread, history) + autonomous trading bot framework. Claude Sonnet decision-making, pluggable strategies, SQLite persistence
This project provides two complementary tools:
Both share the same underlying API clients and work with real-time Polymarket data.
The project follows a layered architecture with clear separation of concerns:
src/
├── polymarket/ # Pure API clients (domain-agnostic)
│ ├── gamma.py # Gamma API (events/markets discovery)
│ ├── clob.py # CLOB API (pricing/orderbook)
│ ├── models.py # Pydantic models
│ └── utils.py # Shared utilities
│
├── mcp/ # MCP servers for Cursor integration
│ ├── base.py # Base server with generic tools
│ └── cricket.py # Cricket-specific server
│
├── bot/ # Trading bot framework (domain-agnostic)
│ ├── base.py # Base bot with main loop
│ ├── config.py # Configuration loader
│ ├── database.py # SQLite persistence
│ └── portfolio.py # Portfolio/position management
│
├── domains/ # Domain-specific implementations
│ └── cricket/
│ ├── bot.py # Cricket bot runner
│ ├── scanner.py # Market scanner
│ └── prompts.py # LLM prompts
│
└── strategies/ # Pluggable trading strategies
├── base.py # Base strategy interface
└── llm.py # LLM-powered strategy
asyncio.gather() for parallel data fetching# Clone the repository
git clone https://github.com/artvandelay/polymarket-agents.git
cd polymarket-agents
# Create and activate virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install mcp httpx pydantic websockets python-dotenv pyyaml aiosqlite
.env.example to .env and add your OpenRouter API key:cp .env.example .env
# Edit .env and set OPENROUTER_API_KEY
config.yaml to adjust trading parameters:trading:
starting_capital: 1000
interval_minutes: 5
duration_hours: 2
max_position_size_pct: 30
strategies:
ai:
model: anthropic/claude-3.5-sonnet
temperature: 0.7
min_confidence: 0.6
Quick test (3 minutes):
python -m src.domains.cricket.bot --duration 0.05 --interval 1
Standard session (2 hours):
python -m src.domains.cricket.bot
In tmux (recommended):
tmux new-session -s trading-bot
python -m src.domains.cricket.bot
# Detach: Ctrl+B, then D
# Reattach: tmux attach -t trading-bot
The MCP server provides 10 tools for market research:
# Start the server (typically called by Cursor)
polymarket-cricket
See AGENTS.md for full documentation of available tools and workflows.
For each market, Claude analyzes:
Decisions include confidence level, reasoning, and position size recommendation.
============================================================
Trading Cycle #1 @ 15:56:56
============================================================
Portfolio: $1,000.00 | Cash: $1,000.00 | Open: 0 positions | P&L: +0.00%
[SCAN] Found 2 active matches
[ANALYZE] T20 World Cup: England vs Nepal (Game 1)
Volume: $202,000 | Liquidity: $79,000
[DECISION] PASS
Reasoning: England at 95.6¢ appears efficient. Potential
return (4.4%) doesn't justify the risk. Preserving capital
for markets with clearer edges.
[ANALYZE] T20 World Cup: Afghanistan vs New Zealand (Game 1)
Volume: $437,000 | Liquidity: $73,000
[DECISION] PASS
Confidence: 90%
Reasoning: 99.9¢ offers no realistic edge. Afghanistan at
0.1¢ is too risky. Best to avoid this market.
============================================================
End of Cycle #1
Portfolio Value: $1,000.00
Cash: $1,000.00
Open Positions: 0
Total P&L: +0.00%
Next scan at 15:57:56
The bot stores all state in SQLite (data/trading.db):
timestamp INTEGER PRIMARY KEY
cash REAL
total_value REAL
pnl REAL
num_open_positions INTEGER
id INTEGER PRIMARY KEY
token_id TEXT -- Polymarket token ID
match_slug TEXT -- Match identifier
outcome TEXT -- Team/outcome name
side TEXT -- YES or NO
entry_price REAL -- Entry price (0-1)
shares REAL -- Number of shares
cost_basis REAL -- Total cost
entry_time INTEGER -- Unix timestamp
exit_price REAL -- Exit price (if closed)
exit_time INTEGER -- Exit timestamp
pnl REAL -- Profit/loss
reasoning TEXT -- AI reasoning
status TEXT -- OPEN or CLOSED
id INTEGER PRIMARY KEY
timestamp INTEGER
cycle INTEGER -- Cycle number
match_slug TEXT
action TEXT -- BUY/SELL/HOLD/PASS
reasoning TEXT -- AI reasoning
confidence REAL -- 0-1
edge REAL -- Estimated edge %
market_data TEXT -- JSON snapshot
The bot uses a pluggable strategy system. Create a new strategy by:
BaseStrategy in src/strategies/name property and analyze() methodsrc/domains/cricket/bot.pyconfig.yamlExample:
from src.strategies.base import BaseStrategy, TradeDecision
class MomentumStrategy(BaseStrategy):
@property
def name(self) -> str:
return "Momentum Strategy"
async def analyze(self, snapshot, portfolio, existing_position):
momentum = self._calculate_momentum(snapshot)
if momentum > self.config["threshold"]:
return TradeDecision(
action="BUY",
outcome="Team with momentum",
position_size=100,
confidence=0.7,
reasoning=f"Strong momentum: +{momentum}% in last hour"
)
return TradeDecision(action="PASS", reasoning="No momentum")
The cricket MCP server provides 10 tools:
Discovery:
list_cricket_leagues - Get all available cricket serieslist_cricket_matches - List active/upcoming matchesget_match - Get full details for a specific matchsearch_events - Text search across eventsget_market_types - List valid market typesPricing:
get_odds - Current buy/sell/midpoint pricesget_orderbook - Full bid/ask depthget_spread - Bid-ask spreadget_price_history - Historical price movementAnalysis:
analyze_odds - Expected value calculator with Kelly criterionSee AGENTS.md for detailed documentation and example workflows.
Version: 0.1.0
This is an early release focused on paper trading and research. The core functionality is implemented:
Not yet implemented:
v0.2 - Real Data:
v0.3 - Advanced Strategies:
v0.4 - Risk Management:
v1.0 - Production:
Real money trading support is not planned. This tool is designed for research and learning.
This bot does not execute real trades. It simulates trades to track performance without risking money. Use cases:
OpenRouter charges per token for Claude API calls:
"OPENROUTER_API_KEY not found"
.env file exists in project rootOPENROUTER_API_KEY=sk-or-v1-..."HTTP 401 Unauthorized"
"Database locked"
pkill -f "python.*cricket.bot"Bot produces no output
python -u -m src.domains.cricket.botpython -m src.domains.cricket.bot > bot.log 2>&1MIT License - Free to use, modify, and distribute.
v0.1.0 - Built for research, designed for extensibility.
For detailed MCP tool documentation, see AGENTS.md.
For quick start examples, see docs/QUICKSTART.md.
Polymarket research MCP server with 10 tools (odds, orderbook, spread, history) + autonomous trading bot framework. Claude Sonnet decision-making, pluggable strategies, SQLite persistence
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Polymarket Agents stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। Polymarket research MCP server with 10 tools (odds, orderbook, spread, history) + autonomous trading bot framework. Claude Sonnet decision-making, pluggable strategies, SQLite persistence