Add it to Claude Code
claude mcp add public-apis -- mcp-public-apisMake your agent remember this setup
public-apis's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Indexes over 1,400 public APIs from the public-apis catalogue
- Supports filtering by category, authentication type, and keyword
- Allows querying by technical requirements like HTTPS support and CORS compatibility
- Provides a tool to refresh the index from the source README
Tools 3
list_categoriesReturns all available API categories.query_apisFilters the index by keyword, category, auth, HTTPS, and CORS.update_indexRe-downloads the README and rebuilds the index.Try it
Original README from Attilio81/MCP_PUBLIC_APIS
MCP Public APIs
An MCP server that indexes the public-apis catalogue and lets an LLM query it by category, auth type, HTTPS support, CORS, and keyword — without browsing the README manually.
Why
Without this MCP, an LLM recommending a public API has to guess or ask the user to check manually. With it, the LLM can say:
"I need a Books API, HTTPS, no auth, CORS-enabled for your React app." →
query_apis(category="Books", no_auth=True, https=True, cors="yes")
Tools
| Tool | Description |
|---|---|
list_categories |
Returns all available API categories (Animals, Finance, …) |
query_apis |
Filters the index by keyword, category, auth, HTTPS, CORS |
update_index |
Re-downloads the README and rebuilds the index |
`query_apis` parameters
| Parameter | Type | Description |
|---|---|---|
keyword |
str |
Substring match on name or description |
category |
str |
Exact category (case-insensitive) |
auth |
str |
"apiKey", "OAuth", "" (none), etc. |
no_auth |
bool |
Shortcut: APIs that need no authentication |
https |
bool |
True = HTTPS only, False = HTTP only |
cors |
str |
"yes", "no", "unknown" |
Installation
cd MCP_PUBLIC_APIS
pip install -e .
Running
mcp-public-apis
Or add it to your MCP client config:
{
"mcpServers": {
"public-apis": {
"command": "mcp-public-apis"
}
}
}
Development
pip install -e ".[dev]"
pytest
Data Source
The index is built from the raw README.md of public-apis/public-apis on GitHub, which lists ~1400 public APIs organised into ~80 categories. The schema mirrors the README table exactly:
name · url · description · auth · https · cors · category