Public APIs MCP

Public APIs MCP

Catalog of free public APIs with semantic search.

The catalog includes an extensive list of APIs from the public-apis GitHub repo.
Thank you to all the maintainers, contributors and API creators! 💯

Related MCP server: MCP Server: Scalable OpenAPI Endpoint Discovery and API Request Tool

🎯 Features

• search_public_apis: embedding-based search over API names and descriptions

• get_public_api_details: retrieve full details by id

• Resources: public-apis://apis, public-apis://api/{id}

🔧 Setup (uv)

Add to MCP clients (e.g., Claude Desktop) using uv.

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

🚀 Usage

• Build embeddings index (optional; auto-build on first search):

• Run the MCP server over STDIO:

📋 Tool Reference

search_public_apis

• Purpose: Semantic search over the catalog

• Parameters: query (str), limit (int, default 5)

• Returns: list of { id, name, score, snippet }

Example call payload:

get_public_api_details

• Purpose: Fetch full details by id

• Parameters: id (str)

• Returns: ApiItem

Example call payload:

🛠️ Development

Prerequisites:

• Python 3.10+

• uv (https://docs.astral.sh/uv/)

Setup:

Run tests:

Lint and format:

Type checking:

MCP Client Dev Config

Build and Try

📦 Data & Index

• Data: src/public_apis_mcp/datastore/free_apis.json

• Embedding index: src/public_apis_mcp/datastore/index.npz (auto-built)

Testing with MCP Inspector

For exploring and/or developing this server, use the MCP Inspector npm utility:

📝 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.