Sign in

v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-305398191.8 KB
servers

List all servers

Search and browse public MCP servers in the Smithery registry. Supports full-text and semantic search via the q parameter, and filtering by deployment status, verification, ownership, and more.

get/servers

Query parameters

qstring

Search query for full-text and semantic search across server names and descriptions.

pageinteger

Page number (1-indexed).

pageSizeinteger

Number of results per page (default 10, max 100).

topKinteger

Maximum number of candidate results to consider from the search index before pagination. The server applies a hard cap of 500 to keep the rerank window bounded; pass seed for stable deep pagination.

fieldsstring

Comma-separated list of fields to include in response

idsstring[]

Filter by specific server IDs.

qualifiedNamestring

Exact match on the server's qualified name (e.g. "smithery/hello-world"). Deprecated: use GET /servers/:namespace/:server instead.

namespacestring

Filter by the namespace that owns the server.

remote'0' | '1' | 'true' | 'false'

Filter by remote status. Remote servers are accessed via URL; non-remote servers run locally via stdio.

isDeployed'0' | '1' | 'true' | 'false'

Filter by deployment status. Deployed servers are hosted on Smithery infrastructure.

verified'0' | '1' | 'true' | 'false'

Filter to only verified servers.

smitheryManaged'0' | '1' | 'true' | 'false'

Filter to servers whose namespace is owned by the Smithery org.

ownerIdstring

Filter by the server owner's user ID.

repoOwnerstring

Filter by GitHub repository owner from repository_url.

repoNamestring

Filter by GitHub repository name from repository_url.

seedinteger

Random seed for deterministic pagination. When provided, results use a stable sort order that is consistent across pages for the same seed value.

Response

Successful response

Example response

{
  "servers": [
    {
      "id": "abc123",
      "qualifiedName": "smithery/hello-world",
      "namespace": "smithery-ai",
      "slug": "hello-world",
      "displayName": "Hello World",
      "description": "A simple hello world server",
      "iconUrl": "https://example.com/icon.png",
      "verified": true,
      "useCount": 42,
      "remote": true,
      "isDeployed": true,
      "createdAt": "2024-01-01T00:00:00.000Z",
      "homepage": "https://example.com",
      "owner": "user_abc123",
      "score": 0.016
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 10,
    "totalPages": 5,
    "totalCount": 42
  }
}