# Herramientas MCP de MYOPL: parámetros, respuestas y ejemplos | Centro de Ayuda de MYOPL Source: https://myopl.net/es/wiki/opl-intelligence/mcp-tool-reference/ Language: es Public reference excerpt. Consult the source page for complete context. Herramientas MCP de MYOPL: parámetros, respuestas y ejemplos Publicado 10 de octubre de 2026 MYOPL ofrece cinco herramientas MCP públicas y cinco para tu cuenta conectada. Esta referencia explica qué preguntar, qué parámetros utiliza cada herramienta y cómo interpretar su respuesta. Para una introducción dirigida a jugadores, lee ¿Qué puedes preguntar a MYOPL desde tu asistente de IA?. Elige tu conexión Conexión Endpoint Acceso Pública Consultas públicas gratuitas sin cuenta de MYOPL ni clave de API. Personal MYOPL Plus o superior, inicio de sesión OAuth, consentimiento y funciones de cuenta habilitadas. Utiliza Conecta tu IA para la configuración y la ayuda de conexión OAuth para conectar o desconectar tu cuenta. Puedes preguntar al asistente con tus propias palabras; los desarrolladores utilizan los nombres exactos de herramientas y parámetros indicados aquí. Los nombres de herramientas, campos JSON y valores enumerados son iguales en todos los idiomas. Conecta directamente desde un asistente de IA En los ajustes de MCP remoto de tu asistente, añade MYOPL con y sin autenticación. Inicia un chat: “Utiliza MYOPL para mostrar el rating publicado de pickleball del usuario g.” Para herramientas personales, añade , elige OAuth, inicia sesión en tu cuenta MYOPL Plus o superior y aprueba los permisos. Pregunta “¿Cuál es mi OPL Rating de pickleball?” o proporciona un enlace de liga y pregunta por tu próxima sesión. Revisa cualquier propuesta de asistencia mediante su enlace de confirmación de MYOPL. En clientes de escritorio y agentes compatibles, también puedes instalar la conexión pública: Conecta tu modelo o endpoint de inferencia Elige un proveedor de modelos, un endpoint de inferencia alojado o un modelo local adecuado para tu aplicación. El modelo genera la conversación; un cliente MCP en tu aplicación consulta los datos de MYOPL. Configúralos como conexiones separadas. Por ejemplo, Hugging Face Inference Endpoints aloja el modelo que elijas. Configura su URL de inferencia y las credenciales del proveedor en los ajustes del modelo de tu aplicación de agentes; después añade MYOPL en sus ajustes de MCP: Ajuste de la aplicación Valor de ejemplo Conexión del modelo La URL de inferencia de Hugging Face que desplegaste y las credenciales de su proveedor Conexión de herramientas públicas , Streamable HTTP, sin autenticación Conexión de herramientas personales , Streamable HTTP, OAuth de MYOPL por usuario La misma separación se aplica al cambiar de proveedor de inferencia. Utiliza un modelo y un entorno de agentes que admitan llamadas a herramientas y sigue este ciclo: Inicializa la conexión MCP y consulta . Proporciona el nombre, la descripción y el de cada herramienta al modelo en el formato que admita su API de inferencia. Cuando el modelo solicite una herramienta de MYOPL, valida sus argumentos y ejecuta mediante el cliente MCP. Devuelve el resultado al modelo con el identificador de llamada correspondiente. Interpreta según el y trata antes de redactar una respuesta de éxito. Incluye la atribución a MYOPL y los enlaces a las fuentes devueltos en la respuesta. Conserva la precisión del rating, las citas de reglas y la distinción entre cero, desconocido y sin rating. El entorno de agentes ejecuta las herramientas; una solicitud de inferencia al modelo por sí sola no las ejecuta. Mantén las credenciales de inferencia con el proveedor del modelo y los tokens de MYOPL con el cliente MYOPL. OAuth personal pertenece a cada usuario; respeta los permisos concedidos, la renovación de tokens y los encabezados de reintento por límites de uso. Consulta la guía de integración, la guía OAuth y la arquitectura de hosts y clientes MCP. Consulta los esquemas de las herramientas Después de , llama a en la conexión elegida. Cada herramienta proporciona un con descripciones de sus parámetros y un para los datos devueltos en . Las herramientas personales se enumeran según los permisos y funciones habilitadas de la cuenta. Llama a con el nombre de la herramienta y sus argumentos. Por ejemplo: Lee para consultar los campos descritos aquí y para el texto que los acompaña. Incluye MYOPL y los enlaces a sus fuentes devueltos en las respuestas. La información de presentación de la tarjeta se proporciona por separado en ; los clientes MCP Apps utilizan el recurso indicado para mostrarla. La guía para desarrolladores y la guía de integración explican las cabeceras HTTP, el descubrimiento y la configuración de clientes. Herramientas públicas 1. get_public_player_rating Consulta los OPL Ratings actuales publicados de individuales y dobles y los totales públicos de rating mediante un nombre de usuario exacto de MYOPL. Ejemplo de pregunta: “Muéstrame el rating y las estadísticas de pickleball del usuario g de MYOPL.” Parámetro Obligatorio Descripción Sí Nombre de usuario público exacto de MYOPL sin . Utiliza entre 1 y 64 letras, números, guiones bajos, puntos o guiones. Ejemplo: . Devuelve: , , , y . Cuando encuentra al jugador, también incluye , , , , , , y . Los campos de rating se explican más abajo. El único del jugador proporciona el enlace de MYOPL para conectar con él. Un único resultado incluye ambas modalidades y la tarjeta pública de rating. 2. prepare_pickleball_browse Busca canchas, clubes u Open Play Leagues públicos en una ciudad, estado o país, u ofrece al usuario una selección de categorías. Ejemplo de pregunta: “Busca canchas de pickleball en Jupiter, Florida.” Parámetro Obligatorio Descripción Sí Ciudad, estado o país, entre 1 y 120 caracteres. Ejemplo: . Pide más detalles cuando el nombre del lugar sea ambiguo. No para etiquetas en inglés o para español. Valor predeterminado: . No , , o . Omítelo para recibir opciones de categoría. y devuelven fichas públicas de ligas. Devuelve: , , , , , , , , y . Cada opción contiene , y . El estado es , o . Con una categoría, registra , , y ; contiene hasta cinco fichas y indica que hay más coincidencias. Precisa el lugar cuando sea true. Cada ficha incluye , , , , y . Según la ficha, también puede contener: Detalles del lugar: , , , , , , y . Totales de canchas: , y . Lugares vinculados: o , con , , , y . Contexto de liga: , y . Abre para continuar en MYOPL. Interpreta la disponibilidad y las clasificaciones mediante los campos devueltos: indica una consulta de directorio y indica que la respuesta no incluye un enlace a clasificaciones. Una ficha es un lugar que puedes explorar; la asistencia se gestiona mediante las sesiones y las respuestas de asistencia de la liga. 3. search_pickleball_rules Consulta información relevante del reglamento oficial USA Pickleball 2026, que MYOPL utiliza mediante un acuerdo oficial de licencia con USA Pickleball. Ejemplo de pregunta: “Explica la regla de la línea de cocina en el saque y cita la regla oficial.” Parámetro Obligatorio Descripción Sí Situación de juego, tema o número de regla oficial, entre 1 y 1.000 caracteres. No Utiliza para consultar el texto oficial del reglamento; valor predeterminado: . Conserva las citas originales al traducir la respuesta para el usuario. Devuelve: , , , , , , , , , y cuando se proporciona. contiene hasta cinco extractos, cada uno con , , , , , , , y . Utiliza y los enlaces devueltos al citar una regla. Formula la pregunta de cuando exista. identifica un extracto parcial; es null si fue necesario ocultar datos de contacto, mientras que contiene el extracto con esos datos ocultos. Consulta la guía de reglas de pickleball de MYOPL para saber más. 4. search_myopl_help Busca instrucciones publicadas del Centro de Ayuda de MYOPL con enlaces a los artículos completos. Ejemplo de pregunta: “Busca instrucciones de MYOPL para cambiar mis preferencias de canchas.” Parámetro Obligatorio Descripción Sí Función o tarea de MYOPL para la que el usuario necesita instrucciones, entre 1 y 1.000 caracteres. No para inglés o para español. Valor predeterminado: . Devuelve: , , , y . Cada uno de los hasta cinco resultados contiene , , , y . Enlaza a para consultar el artículo completo. 5. search_myopl_website Busca información publicada sobre los productos de MYOPL y guías de aprendizaje con enlaces a las fuentes. Ejemplo de pregunta: “Busca la explicación de MYOPL sobre la fiabilidad del rating.” Parámetro Obligatorio Descripción Sí Tema de producto o del sitio web de MYOPL que buscar en páginas publicadas, entre 1 y 1.000 caracteres. No para inglés o para español. Valor predeterminado: . Devuelve: , , , y . Cada uno de los hasta cinco resultados contiene , , , y . Utiliza la de la página como fuente en tu respuesta. Herramientas personales Las herramientas personales utilizan la cuenta identificada mediante OAuth. Los siguientes scopes describen el permiso requerido por cada herramienta. Para el parámetro de liga, utiliza el identificador exacto de su enlace de MYOPL: entre 1 y 150 letras, números, guiones bajos o guiones. La cuenta debe pertenecer a esa liga. 6. get_my_rating Consulta tus OPL Ratings actuales publicados de individuales y dobles y sus totales públicos. Ejemplo de pregunta: “¿Cuál es mi OPL Rating de pickleball?” Permiso: . Parámetros: Ninguno; envía un objeto vacío . OAuth identifica al jugador. Devuelve: Los mismos campos de rating que , incluidos y . Cuando la conexión también concede acceso a estadísticas, esta llamada proporciona la tarjeta completa de MYOPL. Utiliza este único resultado para una pregunta sobre rating en lugar de pedir una segunda tarjeta de estadísticas. 7. get_my_next_session Busca la próxima sesión de una liga de MYOPL a la que perteneces. Ejemplo de pregunta: “¿Cuándo es mi próxima sesión en esta liga de MYOPL?” Comparte el enlace de la liga. Permiso: . Parámetro Obligatorio Descripción Sí Slug exacto de una liga de MYOPL tomado de su enlace, para una liga a la que pertenece la cuenta conectada. Devuelve: , , y . La fecha y la hora son cadenas tal como las muestra MYOPL; conserva su significado al responder. 8. prepare_my_rsvp Prepara tu respuesta de asistencia para la próxima sesión de liga y después revísala y confírmala en MYOPL. Ejemplo de pregunta: “Prepara mi respuesta Voy para la próxima sesión de esta liga.” Permiso: . Parámetro Obligatorio Descripción Sí Slug exacto de una liga de MYOPL tomado de su enlace, para una liga a la que pertenece la cuenta conectada. Sí para asistir, si aún no lo has decidido o para rechazar. El titular de la cuenta confirma en MYOPL. Devuelve: , , , y . es el número de segundos restantes para confirmar. Abre , revisa la propuesta y confirma. Utiliza el identificador de acción devuelto para consultar si se completó. 9. get_my_action_status Comprueba si MYOPL completó la respuesta de asistencia que preparaste y confirmaste. Ejemplo de pregunta: “¿MYOPL confirmó la respuesta de asistencia que acabo de aprobar?” Permiso: . Parámetro Obligatorio Descripción Sí Identificador alfanumérico de 64 caracteres devuelto por en esta misma conexión de cuenta. Utiliza exactamente el valor recibido. Devuelve: y cuando se proporciona. Estado Significado La acción preparada espera confirmación. MYOPL está procesando la acción confirmada. MYOPL completó y sincronizó la respuesta de asistencia. La acción no se completó; sigue las instrucciones devueltas. No se encontró una acción preparada accesible y vigente para esta conexión. Indica que una respuesta de asistencia se completó solo cuando su estado sea . 10. get_my_statistics_card Consulta tu tarjeta de estadísticas de individuales y dobles y su resumen de texto. Ejemplo de pregunta: “Muéstrame mis juegos, puntos e índice de fiabilidad de pickleball.” Permiso: . Parámetros: Ninguno; envía un objeto vacío . OAuth identifica al jugador. Devuelve: , , , , , , , , , , , y . La respuesta proporciona la tarjeta por separado en . Incluye los totales devueltos y un enlace a la fuente de MYOPL en la respuesta de texto. Campos compartidos por las herramientas de rating y estadísticas y contienen los ratings publicados como cadenas decimales o null. Cada objeto y contiene: Campo Tipo y significado Cadena decimal exacta, o null si la modalidad no tiene rating. Conserva la precisión recibida. o . Número de 0 a 100, o null si se desconoce. Entero no negativo o null: juegos disputados en esta modalidad. , Enteros no negativos o null: juegos ganados y perdidos. , Enteros no negativos o null: puntos ganados y perdidos. Un cero registrado es un valor; null significa desconocido. Los juegos son distintos de los encuentros. Si es false, utiliza el texto devuelto en lugar de construir un rating. Solicita datos actuales para cada nueva pregunta sobre rating y conserva la atribución a MYOPL. Gestión de respuestas y documentación relacionada Un error de ejecución tiene y un campo en ; los errores de herramientas públicas también incluyen y . Los errores de transporte y de solicitudes incorrectas utilizan respuestas HTTP o JSON-RPC. Respeta ante HTTP 429. Las integraciones personales renuevan los tokens de acceso caducados mediante su autorización de renovación OAuth. Referencia para desarrolladores de MYOPL Transporte MCP y configuración de clientes Especificación OpenAPI pública Especificación OpenAPI personal Guía de implementación OAuth Conecta tu IA Explora las herramientas de IA de MYOPL Artículos Relacionados Usar la API de AI Discovery Comprende quién puede solicitar acceso a la API de AI Discovery y en qué se diferencia de OPL Intelligence en la aplicación. Chatear con OPL Intelligence Inicia un chat directo con la IA o usa @opl en una conversación cuando el asistente esté disponible para tu cuenta. Administrar la Configuración de OPL Intelligence Activa o desactiva OPL Intelligence y revisa las opciones disponibles para tu cuenta. Conectar un asistente de IA a MYOPL con OAuth Aprende a iniciar sesión, revisar permisos, conectar un asistente de IA autorizado a MYOPL y resolver un enlace de autorización incompleto o caducado.