polymarket-mcp documentation

polymarket-mcp exposes an AI-agent ready FastMCP surface over Polymarket discovery, wallet reads, and public CLOB market data.

At a glance

• Normalize volatile upstream JSON into stable typed models.

• Present Polymarket as clear MCP tools and resources.

• Keep discovery, wallet, and order book concerns separated but composable.

• Make tool descriptions useful for LLM routing, not just humans.

Included surfaces

Namespace	Focus	Typical follow-up
gamma	find markets and events	inspect one market or event
data	inspect wallet state and history	summarize positions or trades
clob	read live books, quotes, and history	compare pricing and liquidity

Package identities

• Distribution: polymarket-mcp-server

• Import package: polymarket_mcp

• CLI entrypoint: polymarket-mcp

Guides

• Getting started
  • Install
  • Configure an MCP client
  • Inspect the server
  • Run the server
  • Namespaces
  • Validate the project
  • Domain-specific servers
• Architecture
  • 1. Models
  • 2. Services
  • 3. MCP servers
  • Namespace boundaries
  • Request flow
• Development
  • Local workflow
  • Testing strategy
  • Documentation workflow
  • Release workflow
• Release and publishing
  • Published package
  • Release flow
  • Trusted publishing
• API reference
  • Package and composition
  • Gamma discovery
  • Data API
  • Public CLOB