PolyMarket

Servidor MCP de PolyMarket

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

Características

• Datos de mercados de predicción en tiempo real con precios y probabilidades actuales
• Información detallada de mercados, incluyendo categorías, fechas de resolución y descripciones
• Datos históricos de precios y volúmenes con marcos de tiempo personalizables (1d, 7d, 30d, all)
• Manejo integrado de errores y gestión de límites de tasa
• Formato de datos limpio para facilitar su consumo

Instalación

Instalación mediante Smithery

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

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

Claude Desktop

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

Configuración de Servidores de Desarrollo/No Publicados

    "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>"
            }
        }
    }

Ejecución Local

1. Clona el repositorio e instala las dependencias:

Instalar Librerías

uv pip install -e .

Ejecución

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

Puedes ejecutar el servidor tú mismo mediante: En el repositorio polymarket-mcp:

uv run src/polymarket_mcp/server.py

*si deseas 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

2. Crea un archivo .env con tu clave de API de PolyMarket:

Key=your_api_key_here
Funder=poly market wallet address

Después de conectar el cliente de Claude con la herramienta MCP mediante el archivo json, ejecuta 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: Obtén información detallada sobre un mercado de predicción específico
• list-markets: Lista los mercados de predicción disponibles con opciones de filtrado
• get-market-prices: Obtén precios actuales e información de negociación
• get-market-history: Obtén datos históricos de precios y volúmenes

get-market-info

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...
---

list-markets

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
---

get-market-prices

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%
---

get-market-history

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:

• Límites de tasa (errores 429)
• Claves de API inválidas (errores 403)
• IDs de mercado invá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.

Requisitos Previos

• Python 3.9 o superior
• httpx>=0.24.0
• mcp-core
• python-dotenv>=1.0.0

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request. Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.