---
title: "List all servers"
method: GET
path: "/servers"
tags: ["servers"]
---

# List all servers

`GET /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.

## Query parameters

- `q` string
- `page` integer
- `pageSize` integer
- `topK` integer
- `fields` string
- `ids` string[]
- `qualifiedName` string
- `namespace` string
- `remote` '0' | '1' | 'true' | 'false'
- `isDeployed` '0' | '1' | 'true' | 'false'
- `verified` '0' | '1' | 'true' | 'false'
- `smitheryManaged` '0' | '1' | 'true' | 'false'
- `ownerId` string
- `repoOwner` string
- `repoName` string
- `seed` integer

## Response `200`

Successful response

- ServersListResponse
  - `servers` ServerSummary[], required
    - `id` string, required
    - `qualifiedName` string, required — Unique identifier in namespace/slug format.
    - `namespace` string, nullable, required — The namespace this server belongs to, or null if unassigned.
    - `slug` string, nullable, required — URL-friendly short name within the namespace.
    - `displayName` string, required
    - `description` string, required
    - `iconUrl` string, nullable, required
    - `verified` boolean, required — Whether this server has been verified by Smithery.
    - `useCount` number, required — Total number of times this server has been connected to.
    - `remote` boolean, nullable, required — Whether the server is accessed via URL (true) or runs locally via stdio (false). Null if unknown.
    - `isDeployed` boolean, required — Whether the server is currently hosted on Smithery infrastructure.
    - `createdAt` string, required — ISO 8601 timestamp of when the server was registered.
    - `homepage` string, required — The server owner's homepage URL, or the server's Smithery page as a fallback. Will become nullable in a future release.
    - `bySmithery` boolean, required — Whether this server is maintained by Smithery (i.e. owned by the Smithery organization).
    - `owner` string, nullable, required — User ID of the server owner, or null for community servers.
    - `score` number, nullable, required — RRF relevance score from search (null for browse requests).
  - `pagination` object, required
    - `currentPage` integer, required — Current page number (1-indexed).
    - `pageSize` integer, required — Number of results per page.
    - `totalPages` integer, required — Total number of pages available.
    - `totalCount` integer, required — Total number of matching servers.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `422` — Unprocessable entity

---

[API](https://skmtc.net/smithery-ai/apis/smithery-platform-api.md) · [All operations](https://skmtc.net/smithery-ai/apis/smithery-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smithery-ai/smithery-platform-api/versions/60b8c3d2fecf/schema)