Sign in
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.

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.

ownerIdstring

Filter by the server owner's user ID.

repoOwnerstring

Filter by connected GitHub repository owner.

repoNamestring

Filter by connected GitHub repository name.

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://smithery.ai/server/smithery/hello-world",
      "owner": "user_abc123",
      "score": 0.016
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 10,
    "totalPages": 5,
    "totalCount": 42
  }
}

Changes