Public APIs MCP

Instructions

Implementation Reference

• src/public_apis_mcp/tools.py:35-43 (handler)

  The handler function implementing the get_public_api_details tool logic: loads the indexed catalog and retrieves the specific ApiItem by ID, raising ValueError if not found.
  def get_public_api_details(id: str) -> ApiItem: """Get detailed information about a specific API by its unique public-apis-mcp server ID """ items, by_id = load_catalog_indexed() item = by_id.get(id) if not item: raise ValueError(f"API id not found: {id}") return item
• src/public_apis_mcp/types.py:6-15 (schema)

  Pydantic model (schema) for ApiItem, which is the return type of the get_public_api_details tool.
  class ApiItem(BaseModel): id: str api: str = Field(description="API display name") api_link: str description: str auth: str | None = None https: str | bool | None = None cors: str | None = None category: str | None = None
• src/public_apis_mcp/server.py:11-11 (registration)

  Invocation of register_tools on the MCP instance, which registers the get_public_api_details tool.
  register_tools(mcp)
• src/public_apis_mcp/tools.py:34-34 (registration)

  The @mcp.tool decorator applied to the get_public_api_details function, performing the actual tool registration.
  @mcp.tool