O catálogo do HostedMCP está aberto a desenvolvedores de três formas: uma API REST, um MCP server que seu cliente de IA pode chamar e um dataset que você pode baixar. As três são gratuitas, somente leitura e não exigem chave.
API REST
URL base: https://api.hostedmcp.org/v1. Toda resposta é JSON. As requisições são limitadas a 300 por minuto por endereço IP; acima disso você recebe HTTP 429 com Retry-After: 60. As respostas podem ficar em cache por cinco minutos, e o CORS é aberto, então você pode chamar a API a partir do navegador.
| Método e caminho | O que retorna |
|---|---|
GET /servers |
MCP servers, os melhores primeiro. Query: q, category, transport (stdio ou remote), official, verified, sort (quality, stars, downloads, new), limit (até 50), cursor |
GET /servers/{owner}/{name} |
Um server: pacotes, variáveis de ambiente, tools, licença, verificações automatizadas e FAQs |
GET /servers/{owner}/{name}/install?client=cursor |
O trecho de configuração para um client, o arquivo em que ele vai, os passos de configuração do client, um link de instalação do Cursor e o comando code --add-mcp do VS Code |
GET /skills |
Agent skills. Query: q, category, sort (quality, stars, new), limit, cursor |
GET /skills/{owner}/{name} |
Uma skill: repositório, pasta, licença, tools pré-aprovadas, arquivos e verificações |
GET /search?q=postgres |
Servers e skills que correspondem a uma query. type opcional (all, server, skill) e limit (até 20) |
GET /badge/{server or skill}/{owner}/{name}.svg |
O badge do README com a pontuação das verificações |
As listas retornam items, total e nextCursor; passe nextCursor de volta como cursor para a próxima página, até que ele seja null. A configuração de instalação funciona para estes clients: claude-code, cursor, vscode, claude-desktop, codex, gemini-cli, windsurf, devin, antigravity, chatgpt, zed, cline, continue, goose e 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"
Os erros vêm como {"error": {"code", "message", "requestId"}} com HTTP 400 para um parâmetro inválido, 404 para um listing desconhecido e 422 quando um server não tem nada que o client escolhido consiga executar. READMEs e arquivos SKILL.md não fazem parte da API: eles pertencem aos seus autores, então siga o link repo. Placeholders como <YOUR_API_KEY> substituem segredos em toda configuração.
MCP server
O mesmo catálogo é um MCP server em https://api.hostedmcp.org/mcp (Streamable HTTP, sem login), com ferramentas para buscar servers e skills, ler um item, listar categorias e obter a configuração de instalação. Adicione-o ao Claude Code:
claude mcp add --transport http hostedmcp https://api.hostedmcp.org/mcp
Dataset
Todos os servidores, skills e plugins indexáveis em JSON, exportados semanalmente, estão em github.com/Caqil/mcp-servers-dataset sob CC BY 4.0.
Uso justo e crédito
Use os dados em suas próprias ferramentas, pesquisas e artigos. Se você publicar algo construído com base neles, dê crédito ao "HostedMCP" com um link para hostedmcp.org. As chamadas são contadas por rota sem armazenar seu endereço IP; consulte a política de privacidade. Dúvidas ou um limite maior: legal@hostedmcp.org.