Skip to main content
Glama
enesjakozh

PolyMarket MCP Server

by berlinbra
OverviewInspectSchemaRelated ServersScoreDiscussions
Python
Remote
MIT License
69

Servidor MCP de PolyMarket

insignia de herrería

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a datos de predicción de mercado a través de la API de PolyMarket. Este servidor implementa una interfaz estandarizada para recuperar información de mercado, precios y datos históricos de los mercados de predicción.

Características

  • Datos de mercado de predicción en tiempo real con precios y probabilidades actuales

  • Información detallada del mercado, incluidas categorías, fechas de resolución y descripciones

  • Datos históricos de precios y volumen con marcos de tiempo personalizables (1 día, 7 días, 30 días, todos)

  • Manejo de errores integrado y gestión de límites de velocidad

  • Formato de datos limpio para un fácil consumo

Related MCP server: MercadoLibre MCP Server

Instalación

Instalación mediante herrería

Para instalar PolyMarket Predictions para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install polymarket_mcp --client claude

Escritorio de Claude

  • En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

  • En Windows: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": { "polymarket-mcp": { "command": "uv", "args": [ "--directory", "/Users/{INSERT_USER}/YOUR/PATH/TO/polymarket-mcp", "run", "polymarket-mcp" //or src/polymarket_mcp/server.py ], "env": { "KEY": "<insert poly market api key>", "FUNDER": "<insert polymarket wallet address" } } }

Ejecutando localmente

  1. Clonar el repositorio e instalar las dependencias:

Instalar bibliotecas

uv pip install -e .

Correr

Después de conectar el cliente Claude con la herramienta MCP a través del archivo json e instalar los paquetes, Claude debería ver las herramientas mcp del servidor:

Puede ejecutar el servidor usted mismo a través de: En el repositorio polymarket-mcp:

uv run src/polymarket_mcp/server.py

*Si desea ejecutar el inspector del servidor junto con el servidor:

npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\polymarket-mcp run src/polymarket_mcp/server.py

  1. Cree un archivo .env con su clave API de PolyMarket:

Key=your_api_key_here Funder=poly market wallet address

Después de conectar el cliente Claude con la herramienta MCP a través del archivo json, ejecute el servidor: En el repositorio alpha-vantage-mcp: uv run src/polymarket_mcp/server.py

Herramientas disponibles

El servidor implementa cuatro herramientas:

  • get-market-info : Obtenga información detallada sobre un mercado de predicción específico

  • list-markets : Lista de mercados de predicción disponibles con opciones de filtrado

  • get-market-prices : Obtenga precios actuales e información comercial

  • get-market-history : Obtenga datos históricos de precios y volumen

obtener información del mercado

Esquema de entrada:

{ "market_id": { "type": "string", "description": "Market ID or slug" } }

Ejemplo de respuesta:

Title: Example Market Category: Politics Status: Open Resolution Date: 2024-12-31 Volume: $1,234,567.89 Liquidity: $98,765.43 Description: This is an example prediction market... ---

mercados de listas

Esquema de entrada:

{ "status": { "type": "string", "description": "Filter by market status", "enum": ["open", "closed", "resolved"] }, "limit": { "type": "integer", "description": "Number of markets to return", "default": 10, "minimum": 1, "maximum": 100 }, "offset": { "type": "integer", "description": "Number of markets to skip (for pagination)", "default": 0, "minimum": 0 } }

Ejemplo de respuesta:

Available Markets: ID: market-123 Title: US Presidential Election 2024 Status: Open Volume: $1,234,567.89 --- ID: market-124 Title: Oscar Best Picture 2024 Status: Open Volume: $234,567.89 ---

obtener precios de mercado

Esquema de entrada:

{ "market_id": { "type": "string", "description": "Market ID or slug" } }

Ejemplo de respuesta:

Current Market Prices for US Presidential Election 2024 Outcome: Democratic Price: $0.6500 Probability: 65.0% --- Outcome: Republican Price: $0.3500 Probability: 35.0% ---

obtener el historial del mercado

Esquema de entrada:

{ "market_id": { "type": "string", "description": "Market ID or slug" }, "timeframe": { "type": "string", "description": "Time period for historical data", "enum": ["1d", "7d", "30d", "all"], "default": "7d" } }

Ejemplo de respuesta:

Historical Data for US Presidential Election 2024 Time Period: 7d Time: 2024-01-20T12:00:00Z Price: $0.6500 Volume: $123,456.78 --- Time: 2024-01-19T12:00:00Z Price: $0.6300 Volume: $98,765.43 ---

Manejo de errores

El servidor incluye un manejo integral de errores para diversos escenarios:

  • Limitación de velocidad (errores 429)

  • Claves API no válidas (errores 403)

  • ID de mercado no válidos (errores 404)

  • Problemas de conectividad de red

  • Condiciones de tiempo de espera de la API (tiempo de espera de 30 segundos)

  • Respuestas malformadas

Los mensajes de error se devuelven en un formato claro y legible para humanos.

Prerrequisitos

  • Python 3.9 o superior

  • httpx>=0.24.0

  • núcleo mcp

  • python-dotenv>=1.0.0

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abra una incidencia para comentar qué desea cambiar.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/berlinbra/polymarket-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server