HostedMCP's catalog is open to developers in three ways: a REST API, an MCP server your AI client can call, and a dataset you can download. All three are free, read-only and need no key.
REST API
Base URL: https://api.hostedmcp.org/v1. Every response is JSON. Requests are limited to 300 per minute per IP address; above that you get HTTP 429 with Retry-After: 60. Responses may be cached for five minutes, and CORS is open, so you can call the API from a browser.
| Method and path | What it returns |
|---|---|
GET /servers |
MCP servers, best first. Query: q, category, transport (stdio or remote), official, verified, sort (quality, stars, downloads, new), limit (up to 50), cursor |
GET /servers/{owner}/{name} |
One server: packages, environment variables, tools, license, automated checks and FAQs |
GET /servers/{owner}/{name}/install?client=cursor |
The config snippet for one client, the file it goes in, the client's setup steps, a Cursor install link and the VS Code code --add-mcp command |
GET /skills |
Agent skills. Query: q, category, sort (quality, stars, new), limit, cursor |
GET /skills/{owner}/{name} |
One skill: repository, folder, license, pre-approved tools, files and checks |
GET /search?q=postgres |
Servers and skills matching a query. Optional type (all, server, skill) and limit (up to 20) |
GET /badge/{server or skill}/{owner}/{name}.svg |
The README badge with the checks score |
Lists return items, total and nextCursor; pass nextCursor back as cursor for the next page, until it is null. Install config works for these clients: claude-code, cursor, vscode, claude-desktop, codex, gemini-cli, windsurf, devin, antigravity, chatgpt, zed, cline, continue, goose and 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"
Errors come as {"error": {"code", "message", "requestId"}} with HTTP 400 for a bad parameter, 404 for an unknown listing and 422 when a server has nothing the chosen client can run. READMEs and SKILL.md files are not part of the API: they belong to their authors, so follow the repo link. Placeholders such as <YOUR_API_KEY> stand in for secrets in every config.
MCP server
The same catalog is an MCP server at https://api.hostedmcp.org/mcp (Streamable HTTP, no sign-in), with tools to search servers and skills, read one, list categories and get install config. Add it to Claude Code:
claude mcp add --transport http hostedmcp https://api.hostedmcp.org/mcp
Dataset
Every indexable server, skill and plugin as JSON, exported weekly, is at github.com/Caqil/mcp-servers-dataset under CC BY 4.0.
Fair use and credit
Use the data in your own tools, research and articles. If you publish something built on it, credit "HostedMCP" with a link to hostedmcp.org. Calls are counted per route without storing your IP address; see the privacy policy. Questions or a higher limit: legal@hostedmcp.org.