# MCP Server


The APIs.io catalog is also available to AI agents as a **Model Context Protocol** server over
Streamable HTTP:

```
https://apis.io/mcp
```

It's generated from the same OpenAPI contract as the REST API, so the two never drift. Every tool is
read-only.

## Connect

Point any MCP-capable client at the endpoint. For example, in a client that takes a remote MCP URL:

```json
{
  "mcpServers": {
    "apis-io": {
      "url": "https://apis.io/mcp"
    }
  }
}
```

The server speaks JSON-RPC: `initialize`, `tools/list`, and `tools/call`.

## Tools

`apis_io_search` is the power tool — find APIs, providers, or tags by free text, tags, providers,
artifact types, industry, region, and rating band. Plus drill-down and taxonomy tools:

- `find_apis` / `get_api`
- `find_providers` / `get_provider`
- `find_tags` / `get_tag`
- `find_industries` / `get_industry`, `find_regions` / `get_region`
- `find_ratings` / `get_provider_rating` / `get_rating_rubric`
- `find_artifacts` — artifacts of a given type (OpenAPI, AsyncAPI, Postman, …) across the catalog

```bash
curl -s https://apis.io/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

See the [API Reference](/api) for the underlying operations each tool maps to.