Documentación de API

Búsqueda Esports expone endpoints públicos de solo lectura. Todo lo demás requiere una sesión de Clerk; ver /auth.md para autenticación de agentes.

Endpoints

• GET /api/search?q=…

  Autocompletado público de personas y organizaciones (máx. 5).

• GET /api/health

  Health check del servicio.

• POST /api/mcp

  Servidor MCP mínimo (JSON-RPC): initialize, tools/list, tools/call.

Descubrimiento para agentes

• /.well-known/api-catalog

  Catálogo de APIs (RFC 9727, application/linkset+json).

• /api/openapi.json

  Especificación OpenAPI 3.1 de los endpoints públicos.

• /.well-known/oauth-authorization-server

  Metadata OAuth 2.0 (RFC 8414, emisor Clerk).

• /.well-known/oauth-protected-resource

  Metadata de recurso protegido (RFC 9728).

• /.well-known/mcp/server-card.json

  Tarjeta del servidor MCP (SEP-1649).

• /.well-known/agent-skills/index.json

  Índice de skills para agentes.

• /.well-known/ai-catalog.json

  Manifiesto ARD de capacidades del sitio.

• /auth.md

  Instrucciones de registro y autenticación para agentes.