Servidor MCP de PolyMarket

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

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