Herramientas MCP de MYOPL: parámetros, respuestas y ejemplos

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	https://api.myopl.net/mcp	Consultas públicas gratuitas sin cuenta de MYOPL ni clave de API.
Personal	https://api.myopl.net/mcp/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

1. En los ajustes de MCP remoto de tu asistente, añade MYOPL con https://api.myopl.net/mcp y sin autenticación.
2. Inicia un chat: “Utiliza MYOPL para mostrar el rating publicado de pickleball del usuario g.”
3. Para herramientas personales, añade https://api.myopl.net/mcp/personal, elige OAuth, inicia sesión en tu cuenta MYOPL Plus o superior y aprueba los permisos.
4. 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:

npx add-mcp 'https://api.myopl.net/mcp'

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	https://api.myopl.net/mcp, Streamable HTTP, sin autenticación
Conexión de herramientas personales	https://api.myopl.net/mcp/personal, 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:

1. Inicializa la conexión MCP y consulta tools/list.
2. Proporciona el nombre, la descripción y el inputSchema de cada herramienta al modelo en el formato que admita su API de inferencia.
3. Cuando el modelo solicite una herramienta de MYOPL, valida sus argumentos y ejecuta tools/call mediante el cliente MCP.
4. Devuelve el resultado al modelo con el identificador de llamada correspondiente. Interpreta structuredContent según el outputSchema y trata isError antes de redactar una respuesta de éxito.
5. 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 initialize, llama a tools/list en la conexión elegida. Cada herramienta proporciona un inputSchema con descripciones de sus parámetros y un outputSchema para los datos devueltos en structuredContent. Las herramientas personales se enumeran según los permisos y funciones habilitadas de la cuenta.

Llama a tools/call con el nombre de la herramienta y sus argumentos. Por ejemplo:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_public_player_rating",
    "arguments": { "username": "g" }
  }
}

Lee structuredContent para consultar los campos descritos aquí y content 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 _meta; 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
username	Sí	Nombre de usuario público exacto de MYOPL sin @. Utiliza entre 1 y 64 letras, números, guiones bajos, puntos o guiones. Ejemplo: g.

Devuelve: found, source, source_url, spoken_reply y retrieved_at. Cuando encuentra al jugador, también incluye username, sport, singles_opl, doubles_opl, singles, doubles, messenger_url y guidance. Los campos de rating se explican más abajo. El messenger_url ú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
location	Sí	Ciudad, estado o país, entre 1 y 120 caracteres. Ejemplo: Jupiter, FL. Pide más detalles cuando el nombre del lugar sea ambiguo.
language	No	en para etiquetas en inglés o es para español. Valor predeterminado: en.
category	No	courts, clubs, sessions o leaderboards. Omítelo para recibir opciones de categoría. sessions y leaderboards devuelven fichas públicas de ligas.

Devuelve: version, location, language, sport, spoken_reply, choices, status, guidance, source y source_url. Cada opción contiene id, label y browse_section. El estado es choice_required, results o no_results.

Con una categoría, selection registra category, browse_section, query y sport; results contiene hasta cinco fichas y has_more indica que hay más coincidencias. Precisa el lugar cuando has_more sea true.

Cada ficha incluye entity_type, sport_type, slug, name, public_url y source. Según la ficha, también puede contener:

• Detalles del lugar: description, city, region, country, access, surface, nets y amenities.
• Totales de canchas: court_count, indoor_courts y outdoor_courts.
• Lugares vinculados: location o locations, con name, city, region, country y public_url.
• Contexto de liga: leaderboard_url, leaderboard_status y session_availability_checked.

Abre public_url para continuar en MYOPL. Interpreta la disponibilidad y las clasificaciones mediante los campos devueltos: session_availability_checked: false indica una consulta de directorio y leaderboard_url: null 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
query	Sí	Situación de juego, tema o número de regla oficial, entre 1 y 1.000 caracteres.
language	No	Utiliza en para consultar el texto oficial del reglamento; valor predeterminado: en. Conserva las citas originales al traducir la respuesta para el usuario.

Devuelve: source, governing_body, edition, language, source_url, myopl_url, evidence, clarification, guidance, spoken_reply y answer cuando se proporciona. evidence contiene hasta cinco extractos, cada uno con rule, rule_number, title, official_text, text, canonical_url, canonical_url_type, truncated y authority.

Utiliza rule_number y los enlaces devueltos al citar una regla. Formula la pregunta de clarification cuando exista. truncated identifica un extracto parcial; official_text es null si fue necesario ocultar datos de contacto, mientras que text 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
query	Sí	Función o tarea de MYOPL para la que el usuario necesita instrucciones, entre 1 y 1.000 caracteres.
language	No	en para inglés o es para español. Valor predeterminado: en.

Devuelve: source, myopl_url, results, clarification y guidance. Cada uno de los hasta cinco resultados contiene url, title, language, excerpt y truncated. Enlaza a url 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
query	Sí	Tema de producto o del sitio web de MYOPL que buscar en páginas publicadas, entre 1 y 1.000 caracteres.
language	No	en para inglés o es para español. Valor predeterminado: en.

Devuelve: source, myopl_url, results, clarification y guidance. Cada uno de los hasta cinco resultados contiene url, title, language, excerpt y truncated. Utiliza la url 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: myopl:rating:read.

Parámetros: Ninguno; envía un objeto vacío {}. OAuth identifica al jugador.

Devuelve: Los mismos campos de rating que get_public_player_rating, incluidos retrieved_at y spoken_reply. 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: myopl:sessions:read.

Parámetro	Obligatorio	Descripción
league	Sí	Slug exacto de una liga de MYOPL tomado de su enlace, para una liga a la que pertenece la cuenta conectada.

Devuelve: league, league_name, date y time. 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: myopl:rsvp:write.

Parámetro	Obligatorio	Descripción
league	Sí	Slug exacto de una liga de MYOPL tomado de su enlace, para una liga a la que pertenece la cuenta conectada.
response	Sí	yes para asistir, maybe si aún no lo has decidido o no para rechazar. El titular de la cuenta confirma en MYOPL.

Devuelve: status: "confirmation_required", action_id, confirmation_url, expires_in y guidance. expires_in es el número de segundos restantes para confirmar. Abre confirmation_url, 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: myopl:rsvp:write.

Parámetro	Obligatorio	Descripción
action_id	Sí	Identificador alfanumérico de 64 caracteres devuelto por prepare_my_rsvp en esta misma conexión de cuenta. Utiliza exactamente el valor recibido.

Devuelve: status y guidance cuando se proporciona.

Estado	Significado
pending	La acción preparada espera confirmación.
processing	MYOPL está procesando la acción confirmada.
completed	MYOPL completó y sincronizó la respuesta de asistencia.
failed	La acción no se completó; sigue las instrucciones devueltas.
unavailable	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 completed.

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: myopl:statistics:read.

Parámetros: Ninguno; envía un objeto vacío {}. OAuth identifica al jugador.

Devuelve: found, source, source_url, username, sport, singles_opl, doubles_opl, singles, doubles, messenger_url, guidance, summary y card_type: "myopl_rating". La respuesta proporciona la tarjeta por separado en _meta. 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

singles_opl y doubles_opl contienen los ratings publicados como cadenas decimales o null. Cada objeto singles y doubles contiene:

Campo	Tipo y significado
rating	Cadena decimal exacta, o null si la modalidad no tiene rating. Conserva la precisión recibida.
status	rated o unrated.
reliability_score	Número de 0 a 100, o null si se desconoce.
games_played	Entero no negativo o null: juegos disputados en esta modalidad.
games_won, games_lost	Enteros no negativos o null: juegos ganados y perdidos.
points_won, points_lost	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 found 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 isError: true y un campo error en structuredContent; los errores de herramientas públicas también incluyen source y myopl_url. Los errores de transporte y de solicitudes incorrectas utilizan respuestas HTTP o JSON-RPC. Respeta Retry-After 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