ParlayAPI

parlayapi-mcp

mcp-name: io.github.JacobiusMakes/parlayapi

Servidor MCP para ParlayAPI. Expone probabilidades deportivas, datos de mercados de predicción, vistas previas de paneles en vivo, prueba de calidad de fuentes y registro de agentes sin fricción como herramientas nativas para cualquier cliente compatible con MCP (Claude Desktop, Cursor, OpenClaw, asistentes personalizados).

Por qué usarlo

Sin MCP, un agente que quiera usar ParlayAPI tiene que:

• Decirle al usuario que se registre a través de un navegador
• Esperar a que copie y pegue la clave
• Construir solicitudes HTTP manualmente

Con este servidor MCP, el agente puede primero llamar a herramientas de descubrimiento sin clave como parlayapi_live_command_center() y parlayapi_book_coverage() para demostrar que ParlayAPI está activo. Si el usuario quiere el feed completo, el agente llama a parlayapi_signup(email) y recibe una clave de API funcional, una URL de reclamación para el panel y una URL de actualización de Stripe que el usuario puede hacer clic. Luego llama a parlayapi_get_odds(), parlayapi_get_props(), etc. directamente.

Instalar en Claude Desktop

Abre el último lanzamiento de escritorio y descarga su archivo que termina en -directory.mcpb. Las notas de la versión identifican la versión del paquete y la validación realizada. Abre el archivo descargado (doble clic, o arrástralo sobre Claude Desktop). Claude Desktop descomprime el paquete y ejecuta el servidor con su runtime uv administrado, por lo que no se necesita configuración de terminal ni de Python.

El paquete fuente de Python 0.3.8 reenvía una clave de cuenta disponible para la validación de propiedad del checkout y distingue una URL de checkout de un acuse de recibo del flujo de correo electrónico. Un acuse de recibo no confirma la entrega del correo. El paquete de escritorio 0.3.6 fijado por separado no incluye esta corrección de checkout. Consulta la página de lanzamientos anterior para paquetes de escritorio más nuevos.

El campo de clave de API en el diálogo de instalación es opcional. Déjalo en blanco para comenzar sin clave: las herramientas de registro, precios, vistas previas en vivo, calidad de fuentes y cobertura funcionan de inmediato, y la herramienta parlayapi_signup puede crear una clave gratuita (1,000 créditos/mes, sin tarjeta) sin salir del chat. Agrega la clave más tarde en cualquier momento en Configuración, Extensiones, ParlayAPI.

El código fuente del paquete vive en mcpb/. Reconstruyelo con npx @anthropic-ai/mcpb pack mcpb/.

Instalar (manual, cualquier cliente MCP)

# Start the stdio server (normally launched by your MCP client):
uvx --from parlayapi-mcp==0.3.8 parlayapi-mcp

# Or install globally with pip:
pip install parlayapi-mcp==0.3.8

Configura tu cliente MCP

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json en macOS (%APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "parlayapi": {
      "command": "uvx",
      "args": ["parlayapi-mcp"],
      "env": {
        "PARLAYAPI_KEY": "your_key_here"
      }
    }
  }
}

Si aún no tienes una clave, omite env por completo. La herramienta de registro funcionará sin clave, y también las herramientas públicas de vista previa en vivo, precios, calidad de fuentes y cobertura. Las herramientas de datos pagados devolverán un error indicándote que configures una clave. Después del registro, pega tu nueva clave en env y reinicia Claude Desktop. PARLAY_API_KEY también se acepta para clientes que usan el estilo de guion bajo.

Cursor

Para la integración empaquetada, consulta Configuración del plugin de Cursor.

Agrega a .cursor/mcp.json:

{
  "mcpServers": {
    "parlayapi": {
      "command": "uvx",
      "args": ["parlayapi-mcp"],
      "env": { "PARLAYAPI_KEY": "your_key_here" }
    }
  }
}

OpenClaw

OpenClaw puede guardar definiciones de servidores MCP stdio con openclaw mcp set. Esta configuración sin clave permite que el asistente use herramientas de registro, precios, vista previa en vivo, calidad de fuentes y prueba de cobertura de inmediato:

openclaw mcp set parlayapi '{"command":"uvx","args":["parlayapi-mcp"]}'

Después de que el usuario se registre, agrega la clave de API para las herramientas de datos pagados:

openclaw mcp set parlayapi '{"command":"uvx","args":["parlayapi-mcp"],"env":{"PARLAYAPI_KEY":"your_key_here"}}'

Ejecutar localmente con Docker

Construye el contenedor stdio desde este repositorio:

docker build -t parlayapi-mcp:local .
docker run --rm -i --read-only --cap-drop=ALL --security-opt=no-new-privileges parlayapi-mcp:local

El proceso espera mensajes MCP en stdin. No abre un servidor web ni hace una llamada a la API solo al iniciarse. Conéctalo a través de un cliente MCP; no uses -t, que asignaría una terminal en lugar del transporte stdio de MCP.

Para herramientas de cuenta, configura tu propio PARLAYAPI_KEY en la configuración secreta de tu cliente MCP y pasa esa variable de entorno al contenedor:

docker run --rm -i --read-only --cap-drop=ALL --security-opt=no-new-privileges -e PARLAYAPI_KEY parlayapi-mcp:local

No se incluye ninguna clave en la imagen. Cada usuario debe configurar su propia clave y mantener las respuestas de cuenta dentro de su propio cliente. Este contenedor no es un feed comunitario compartido. La licencia de software MIT no otorga derechos de distribución de datos; los Términos aplicables y cualquier acuerdo escrito rigen el uso de datos de la API. Estos valores predeterminados del contenedor no modifican acuerdos existentes.

Las herramientas de descubrimiento público no necesitan clave. Las herramientas de cuenta usan tu asignación; consulta planes y límites actuales. El conjunto de herramientas existente también incluye creación de cuentas, creación de enlaces de checkout, correo de enlace de inicio de sesión y preferencias de libros guardados. Aprueba esas acciones explícitamente en tu cliente MCP. El listado de herramientas en sí no crea una cuenta, no envía correos ni inicia un checkout.

Para informes de seguridad privados, envía un correo a support@parlay-api.com. No pongas claves de API ni respuestas de cuenta en problemas públicos.

Herramientas expuestas

Herramienta	Autenticación	Propósito
parlayapi_signup	ninguna	Crear una cuenta de nivel gratuito, devolver clave de API + URL de reclamación + URL de actualización
parlayapi_checkout_link	ninguna	URL de actualización de Stripe para cualquier nivel
parlayapi_magic_link	ninguna	Enviar por correo un enlace de inicio de sesión sin contraseña
parlayapi_get_pricing	ninguna	Precios públicos actuales y niveles de crédito
parlayapi_live_sports	ninguna	Deportes en vivo activos, conteos de eventos y conteos de libros
parlayapi_live_search	ninguna	Buscar equipos, jugadores y claves de deportes en vivo
parlayapi_live_command_center	ninguna	Vista previa pública de mejor línea desde /live
parlayapi_source_quality	ninguna	Metadatos públicos de frescura y calidad de fuentes
parlayapi_book_coverage	ninguna	Prueba pública de cobertura de cinco puertas por libro
parlayapi_list_sports	clave	Todas las claves de deportes disponibles
parlayapi_get_odds	clave	Probabilidades a nivel de juego (h2h, spreads, totales) para un deporte
parlayapi_get_props	clave	Probabilidades de props de jugadores para un deporte
parlayapi_best_line	clave	Mejor precio por resultado entre casas de apuestas
parlayapi_verdict	clave	Llamada de una sola consulta "¿debería apostar esto?": precio justo vs mercado, mejor libro donde puedes apostar, llamada APUESTA/PASA en lenguaje sencillo
parlayapi_set_bettable_books	clave	Recordar la región/libros del usuario para que los veredictos omitan libros que no puede usar
parlayapi_parlay_verdict	clave	Calificar una parlay de múltiples patas: precio justo combinado, mejor libro para colocarla, EV, pata más débil, advertencias de correlación, pago
parlayapi_best_bets	clave	Jugadas +EV clasificadas para un deporte, limitadas a los libros donde puedes apostar, más alertas de margen
parlayapi_account_info	clave	Nivel, créditos restantes, período de facturación
parlayapi_find_arbitrage	clave	Candidatos de arbitraje entre libros, mercados de 3 vías (local/empate/visitante) incluidos
parlayapi_find_ev	clave	Apuestas de EV positivo frente a la línea justa sin vig de un libro agudo
parlayapi_consensus	clave	Probabilidades de consenso (promedio) entre todas las casas de apuestas por mercado
parlayapi_find_middles	clave	Oportunidades de middle entre libros

Recursos

parlayapi://docs/quickstart - Ejemplos de código en Python y JS.

Desarrollo local

git clone https://github.com/JacobiusMakes/parlay-api-mcp
cd parlay-api-mcp
pip install -e .

# Run against the local API instead of production:
PARLAYAPI_BASE_URL=http://127.0.0.1:8080 \
PARLAYAPI_KEY=your_local_test_key \
parlayapi-mcp

Política de privacidad

Esta extensión se conecta a ParlayAPI. Consulta la Política de privacidad de ParlayAPI.

Licencia

MIT

---

Parte del ecosistema ParlayAPI: una API de probabilidades deportivas en tiempo real con un nivel gratuito de 1,000 créditos por mes, sin tarjeta requerida. Explora todas las herramientas en github.com/JacobiusMakes.