artvandelay

Polymarket Agents — Development skill for Claude Code

Development community

Polymarket research MCP server with 10 tools (odds, orderbook, spread, history) + autonomous trading bot framework.

How to install Polymarket Agents

This entry records only its repository, not the path inside it, so there is no exact command to give. Open artvandelay/polymarket-agents and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Polymarket Agents does

Polymarket research MCP server with 10 tools (odds, orderbook, spread, history) + autonomous trading bot framework. Claude Sonnet decision-making, pluggable strategies, SQLite persistence

Alternatives in Development

Contributors — Thank you to everyone who has contributed to making planning-with-files better 16.8k ★
Monetization Strategy — Brainstorm 3-5 monetization strategies with validation experiments 7.8k ★
Skill Decision Support — Present options with trade-offs for informed decision-making — use when choosing between approaches 2.8k ★

README

Polymarket Live

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/artvandelay/polymarket-agents)

An AI-powered trading bot and MCP server for analyzing cricket betting markets on Polymarket.

Overview

This project provides two complementary tools:

MCP Server - Read-only research tools for Cursor/AI agents to analyze Polymarket markets
Trading Bot - Autonomous paper trading bot using Claude Sonnet for decision-making

Both share the same underlying API clients and work with real-time Polymarket data.

Features

AI-powered strategy using Claude Sonnet via OpenRouter
Real-time market data from Polymarket's Gamma and CLOB APIs
Portfolio management with P&L tracking
Pluggable strategy system for easy extensibility
SQLite persistence for trades and portfolio state
Configurable via YAML
Paper trading only (no real money)

Architecture

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