El catálogo de HostedMCP está abierto a los desarrolladores de tres formas: una API REST, un MCP server que tu cliente de IA puede llamar y un dataset que puedes descargar. Las tres son gratuitas, de solo lectura y no requieren clave.
REST API
URL base: https://api.hostedmcp.org/v1. Todas las respuestas son JSON. Las solicitudes están limitadas a 300 por minuto por dirección IP; por encima de eso recibes HTTP 429 con Retry-After: 60. Las respuestas pueden almacenarse en caché durante cinco minutos, y CORS está abierto, así que puedes llamar a la API desde un navegador.
| Método y ruta | Qué devuelve |
|---|---|
GET /servers |
MCP servers, los mejores primero. Consulta: q, category, transport (stdio o remote), official, verified, sort (quality, stars, downloads, new), limit (hasta 50), cursor |
GET /servers/{owner}/{name} |
Un servidor: paquetes, variables de entorno, herramientas, licencia, comprobaciones automatizadas y preguntas frecuentes |
GET /servers/{owner}/{name}/install?client=cursor |
El fragmento de configuración para un cliente, el archivo donde va, los pasos de configuración del cliente, un enlace de instalación para Cursor y el comando code --add-mcp de VS Code |
GET /skills |
Agent skills. Consulta: q, category, sort (quality, stars, new), limit, cursor |
GET /skills/{owner}/{name} |
Una skill: repositorio, carpeta, licencia, herramientas preaprobadas, archivos y comprobaciones |
GET /search?q=postgres |
Servidores y skills que coinciden con una consulta. type opcional (all, server, skill) y limit (hasta 20) |
GET /badge/{server or skill}/{owner}/{name}.svg |
La insignia para el README con la puntuación de las comprobaciones |
Las listas devuelven items, total y nextCursor; pasa nextCursor de vuelta como cursor para obtener la página siguiente, hasta que sea null. La configuración de instalación funciona para estos clientes: claude-code, cursor, vscode, claude-desktop, codex, gemini-cli, windsurf, devin, antigravity, chatgpt, zed, cline, continue, goose y jetbrains.
curl "https://api.hostedmcp.org/v1/servers?q=postgres&transport=remote&limit=3"
curl "https://api.hostedmcp.org/v1/servers/github/github-mcp-server/install?client=cursor"
Los errores llegan como {"error": {"code", "message", "requestId"}} con HTTP 400 para un parámetro incorrecto, 404 para un listado desconocido y 422 cuando un servidor no tiene nada que el cliente elegido pueda ejecutar. Los README y los archivos SKILL.md no forman parte de la API: pertenecen a sus autores, así que sigue el enlace repo. Los marcadores de posición como <YOUR_API_KEY> sustituyen a los secretos en todas las configuraciones.
MCP server
El mismo catálogo es un MCP server en https://api.hostedmcp.org/mcp (Streamable HTTP, sin inicio de sesión), con herramientas para buscar servidores y skills, leer uno, listar categorías y obtener la configuración de instalación. Añádelo a Claude Code:
claude mcp add --transport http hostedmcp https://api.hostedmcp.org/mcp
Dataset
Todos los servidores, skills y plugins indexables en formato JSON, exportados semanalmente, están en github.com/Caqil/mcp-servers-dataset bajo CC BY 4.0.
Uso razonable y atribución
Usa los datos en tus propias herramientas, investigaciones y artículos. Si publicas algo basado en ellos, atribúyelo a "HostedMCP" con un enlace a hostedmcp.org. Las llamadas se cuentan por ruta sin almacenar tu dirección IP; consulta la política de privacidad. Para dudas o un límite mayor: legal@hostedmcp.org.