¿Cómo puede un agente de IA de póker usar MCP?
Un agente de IA puede usar el servidor MCP oficial de Pokerai solo para un escenario de entrenamiento controlado o una mano que ya ha terminado. El agente descubre las herramientas expuestas del servidor en tiempo de ejecución, valida los datos devueltos y deja la interpretación y las decisiones de alto impacto a una persona.
Datos rápidos
| Servidor MCP oficial | github.com/pokerai-bet/mcp y el paquete @pokerai/mcp |
|---|---|
| Autenticación | El servidor MCP utiliza una clave de API de Pokerai; manténgala en el entorno del servidor, no en prompts ni en código del navegador. |
| Contrato de herramientas | Descubre los nombres de las herramientas y los esquemas de entrada del servidor oficial en ejecución. Esta guía no presupone un nombre de herramienta no publicado ni una entrada en el registro. |
| Fundamentación | Usa el resultado estructurado respaldado por la API para cartas, equidad, estrategia y otros hechos documentados verificables; el texto del LLM es explicación u orquestación, no una salida del solver. |
| Uso permitido | Formación, coaching, revisión de manos, estudio e investigación. |
| No permitido | La asistencia en tiempo real en mesas con dinero real está prohibida. |
Flujo de llamadas a herramientas
Mantenga el ciclo del agente pequeño e inspeccionable. MCP transporta la solicitud de la herramienta; Pokerai API sigue siendo la fuente del resultado de la herramienta respaldado por la API.
- Conectar — Inicia el servidor MCP oficial utilizando su README y proporciona la clave API mediante la configuración del lado del servidor.
- Descubrir — Solicita al cliente MCP la lista actual de herramientas y los esquemas del servidor. No deduzcas el nombre de una herramienta a partir de esta página, la memoria de un modelo o una entrada de registro no verificada.
- Validar — Confirma que la solicitud procede de un escenario de entrenamiento controlado o de una mano finalizada y que es una tarea permitida de formación, revisión, estudio, coaching o investigación sin conexión; normaliza las entradas de póker proporcionadas conforme al esquema descubierto.
- Llamar — Llame a una herramienta detectada con los argumentos mínimos necesarios y, a continuación, conserve el resultado estructurado sin procesar y los metadatos de la solicitud en el registro de auditoría de la aplicación.
- Revisión — Haga que una persona revise la explicación del agente, la incertidumbre y el uso de frecuencias mixtas antes de presentar resultados educativos o de producto de alto impacto.
Bucle mínimo de agente verificable
Este es pseudocódigo de nivel de protocolo, no un nombre de herramienta declarado. Se puede verificar porque el agente primero lee la lista real de herramientas y el esquema del servidor en ejecución antes de hacer una llamada.
tools = mcp.list_tools()
selected = choose_tool(tools, task="offline preflop study")
assert selected.name in {tool.name for tool in tools}
assert selected.schema validates request
result = mcp.call_tool(
name=selected.name,
arguments=request
)
human_review(result.structured_content)
write_study_note(result.structured_content)
Para una forma concreta de solicitud y respuesta, usa el esquema de la herramienta descubierta junto con la instantánea de OpenAPI oficial. Si el servidor no expone una herramienta adecuada, no sustituyas una llamada HTTP supuesta ni fabriques el resultado de una herramienta.
Revisión humana y límite sin RTA
Límites de datos
- Envíe solo las entradas de póker necesarias para la tarea de estudio seleccionada. Evite incluir claves de API, datos de la cuenta y datos personales no relacionados en las indicaciones o los argumentos de las herramientas.
- Las solicitudes a la API de Pokerai no tienen estado; no conviertas el contenido de las manos en datos de atribución de marketing ni lo conserves durante más tiempo del que requiere el flujo de revisión de la aplicación.
- Mantenga la clave de API y la respuesta sin procesar de la herramienta en sistemas confiables del lado del servidor. Oculte secretos e identificadores de usuario en los rastros del agente, los tickets de soporte y los ejemplos compartidos.
- Use el contrato de API documentado como autoridad para la semántica de las entradas y las respuestas; el texto del agente es una explicación, no un sustituto de los datos de origen.
Enlaces de implementación oficial
- Servidor MCP oficial — instrucciones de instalación y actuales del servidor; aquí no se presupone ninguna entrada de registro
- SDK de Python — código fuente oficial del cliente de Python
- SDK de TypeScript / JavaScript — código fuente del cliente oficial de JavaScript
- Referencia interactiva de la API — esquemas de operaciones y detalles de las respuestas
- Instantánea de OpenAPI — contrato de API en inglés legible por máquinas
- Documentación para desarrolladores — autenticación, cuotas, SDKs y flujos de trabajo de API
- Guía de la API de revisión de manos de póker — la página principal de respuestas para flujos de trabajo de revisión de manos completadas
- llms.txt — contexto conciso de LLM para Pokerai API