---
title: "Search the scraped MCP directories"
method: GET
path: "/registry/directory-servers"
tags: ["Registry"]
---

# Search the scraped MCP directories

`GET /registry/directory-servers`

Cross-source search over Claude, ChatGPT, and any future directory source. Omit `source` (or pass `all`) to search every source. The `cursor` is filter-bound. Prefer a matching curated card from `listRegistryServers` (global scope) when one exists — those carry vetted OAuth config. Bearer always required (guest tokens allowed). Not in PUBLIC_OPERATIONS.

## Query parameters

- `q` string
- `source` string
- `rowType` string
- `endpointKind` string
- `verifiedTier` string
- `connectableOnly` boolean
- `cursor` string
- `limit` integer

## Response `200`

Page of results. `nextCursor` is omitted on the last page. Cursors are filter-bound — do not reuse one after changing q/source/filters.

- CatalogServerPage
  - `items` CatalogServer[], required
    - `id` string, required
    - `source` string, required
    - `serverName` string, required
    - `displayName` string
    - `description` string
    - `rowType` string
    - `verifiedTier` string
    - `authPosture` string
    - `unavailableReason` string
    - `endpointKind` string
    - `remoteUrl` string
    - `remoteUrlOptions` string[]
    - `remoteUrlRegex` string
    - `remoteUrlHint` string
    - `latestContentHash` string — Freshness pin for install.
    - `oauthProbe` object
  - `nextCursor` string — Opaque, filter-bound. Omitted on the last page.

## Other responses

- `401` — Missing, invalid, revoked, or orphaned key (`UNAUTHORIZED`) — or the **target MCP server** needs an OAuth grant (`OAUTH_REQUIRED`), which is a property of the server, not your key.
- `403` — Key is valid but not allowed to do this.
- `429` — Per-key rate limit exceeded (60 requests/minute sustained, bursts up to 10). Honor `Retry-After` and back off with jitter.
- `500` — Something failed on MCPJam's side.
- `502` — Could not connect to the target MCP server.

---

[API](https://skmtc.net/mcpjam/apis/mcpjam-api.md) · [All operations](https://skmtc.net/mcpjam/apis/mcpjam-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mcpjam/mcpjam-api/revisions/61274583b124/schema)