Skip to main content
Glama

Public APIs MCP

by zazencodes
GitHub
Python
MIT License
1
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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! 💯

🎯 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

{ "mcpServers": { "public-apis": { "command": "uvx", "args": ["public-apis-mcp"] } } }

🚀 Usage

  • Build embeddings index (optional; auto-build on first search):
uvx public-apis-mcp build-index
  • Run the MCP server over STDIO:
uvx public-apis-mcp run

📋 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:

{ "name": "search_public_apis", "arguments": { "query": "weather", "limit": 5 } }

get_public_api_details

  • Purpose: Fetch full details by id
  • Parameters: id (str)
  • Returns: ApiItem

Example call payload:

{ "name": "get_public_api_details", "arguments": { "id": "a6b3a6b3-a6b3-a6b3-a6b3-a6b3a6b3a6b3" } }

🛠️ Development

Prerequisites:

  • Python 3.10+
  • uv (https://docs.astral.sh/uv/)

Setup:

uv sync --dev

Run tests:

FREE_APIS_MCP_TEST_MODE=1 uv run pytest -q

Lint and format:

uv run ruff check --fix uv run ruff format

Type checking:

uv run mypy src/

MCP Client Dev Config

{ "mcpServers": { "public-apis-dev": { "command": "uv", "args": [ "--directory", "<abs_path>/public-apis-mcp", "run", "public-apis-mcp" ] } } }

Build and Try

uv build uv run --with dist/*.whl public-apis-mcp --help

📦 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:

# Install MCP Inspector npm install -g @modelcontextprotocol/inspector # Run local development server with the inspector npx @modelcontextprotocol/inspector uv run public-apis-mcp # Run PyPI production server with the inspector npx @modelcontextprotocol/inspector uvx public-apis-mcp

📝 License

MIT License - see LICENSE file for details.

🤝 Contributing

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

Deploy Server
-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Enables semantic search and discovery of free public APIs from an extensive catalog. Provides embedding-based search over API names and descriptions, plus detailed API information retrieval.

  1. 🎯 Features
    1. 🔧 Setup (uv)
      1. Claude Desktop
    2. 🚀 Usage
      1. 📋 Tool Reference
        1. search_public_apis
        2. get_public_api_details
      2. 🛠️ Development
        1. MCP Client Dev Config
        2. Build and Try
      3. 📦 Data & Index
        1. Testing with MCP Inspector
          1. 📝 License
            1. 🤝 Contributing

              Related MCP Servers

              • Semantic Scholar MCP Server

                zongmin-yu
                -
                security
                A
                license
                -
                quality
                Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.
                Last updated -
                61
                MIT License

              • Web Search MCP Server

                williamvd4
                A
                security
                F
                license
                A
                quality
                Enables free web searching using Google search results with no API keys required, returning structured results with titles, URLs, and descriptions.
                Last updated -
                1
                11
                3

              • Semantic Scholar MCP Server

                JackKuo666
                -
                security
                F
                license
                -
                quality
                Provides tools for accessing the Semantic Scholar API to search papers, retrieve paper and author details, and fetch citations and references through the Model Context Protocol.
                Last updated -
                26
                • Apple
                • Linux

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/zazencodes/public-apis-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server