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. 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
  }
}

Changes

Changed in 6 of the 47 revisions of this API.8

  • 21ab1c95bb451See the full diff
    • ○

      added the new optional query request parameter smitheryManaged

      new-optional-request-parameter

  • 6926fbee5e941See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

  • 8f89ae4612e11See the full diff
    • ○

      added the new optional query request parameter seed

      new-optional-request-parameter

  • 0df1e1efdca41See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

  • 0ea2d8e23fa12See the full diff
    • ○

      added the new optional query request parameter fields

      new-optional-request-parameter

    • ○

      added the new optional query request parameter namespace

      new-optional-request-parameter

  • 12e546828dc52See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog