Public APIs

Search for free APIs using MCP

python

4

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Public APIs MCP provides an embeddable, semantic-search powered catalog of free public APIs. You can search APIs by name or description, fetch full details by id, and run the MCP server locally or through a client to integrate into your workflows.

How to use

You can interact with this MCP server through a client that supports MCP connections. Start by running the MCP server locally to serve requests from your client, or connect to a remote instance if available. Build an embeddings index (optional) to speed up semantic search, then issue search queries to discover APIs by intent and retrieve detailed API entries.

How to install

Prerequisites: ensure you have the MCP client tools available on your system. The typical workflow uses the MCP runtime to run a local server and optionally build an embeddings index.

uvx public-apis-mcp build-index

uvx public-apis-mcp run

Data & Index

Data for the catalog is stored at src/public_apis_mcp/datastore/free_apis.json. The embedding index is located at src/public_apis_mcp/datastore/index.npz and is auto-built when you run the server for the first time or when you build the index explicitly.

Testing with MCP Inspector

For exploring and developing this server, you can use the MCP Inspector utility. Install it globally and use it to run and test the MCP server in development or production modes.

# 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

Tool Reference

This server exposes two core tools to interact with the catalog.

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

Data & Index (detailed)

Data: src/public_apis_mcp/datastore/free_apis.json
Embedding index: src/public_apis_mcp/datastore/index.npz (auto-built)

Available tools

search_public_apis

Semantic search over the catalog using embeddings to match queries with API names and descriptions.

get_public_api_details

Fetch full API details by id to retrieve complete information for a specific API entry.