> ## Documentation Index > Fetch the complete documentation index at: https://smithery.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml get /servers openapi: 3.1.0 info: title: Smithery Platform API description: >- API for the Smithery platform — discover, deploy, and manage MCP (Model Context Protocol) servers. Provides endpoints for browsing the server registry, managing deployments, creating scoped access tokens, and connecting to MCP servers. version: 1.0.0 servers: - url: https://api.smithery.ai security: - bearerAuth: [] tags: - name: servers description: >- Browse the MCP server registry, manage server configuration, and handle deployments - name: skills description: Discover and search reusable prompt-based skills for MCP servers - name: tools description: Search for MCP tools across all registered servers paths: /servers: get: tags: - servers summary: List all servers description: >- 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. operationId: getServers parameters: - in: query name: q schema: type: string description: >- Search query for full-text and semantic search across server names and descriptions. - in: query name: page schema: type: integer minimum: 1 maximum: 9007199254740991 description: Page number (1-indexed). - in: query name: pageSize schema: type: integer minimum: 1 maximum: 100 description: Number of results per page (default 10, max 100). - in: query name: topK schema: type: integer minimum: 10 maximum: 500 description: >- 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. - in: query name: fields schema: type: string description: Comma-separated list of fields to include in response - in: query name: ids schema: type: array items: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: Filter by specific server IDs. - in: query name: qualifiedName schema: type: string description: >- Exact match on the server's qualified name (e.g. "smithery/hello-world"). Deprecated: use GET /servers/:namespace/:server instead. - in: query name: namespace schema: type: string description: Filter by the namespace that owns the server. - in: query name: remote schema: type: string enum: - '0' - '1' - 'true' - 'false' description: >- Filter by remote status. Remote servers are accessed via URL; non-remote servers run locally via stdio. - in: query name: isDeployed schema: type: string enum: - '0' - '1' - 'true' - 'false' description: >- Filter by deployment status. Deployed servers are hosted on Smithery infrastructure. - in: query name: verified schema: type: string enum: - '0' - '1' - 'true' - 'false' description: Filter to only verified servers. - in: query name: smitheryManaged schema: type: string enum: - '0' - '1' - 'true' - 'false' description: Filter to servers whose namespace is owned by the Smithery org. - in: query name: ownerId schema: type: string description: Filter by the server owner's user ID. - in: query name: repoOwner schema: type: string description: Filter by GitHub repository owner from repository_url. - in: query name: repoName schema: type: string description: Filter by GitHub repository name from repository_url. - in: query name: seed schema: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Random seed for deterministic pagination. When provided, results use a stable sort order that is consistent across pages for the same seed value. responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/ServersListResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ServersListError' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ServersListError' '422': description: Unprocessable entity content: application/json: schema: $ref: '#/components/schemas/ServersListError' x-codeSamples: - lang: JavaScript source: |- import Smithery from '@smithery/api'; const client = new Smithery({ apiKey: process.env['SMITHERY_API_KEY'], // This is the default and can be omitted }); // Automatically fetches more pages as needed. for await (const serverListResponse of client.servers.list()) { console.log(serverListResponse.id); } components: schemas: ServersListResponse: type: object properties: servers: type: array items: $ref: '#/components/schemas/ServerSummary' pagination: type: object properties: currentPage: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Current page number (1-indexed). example: 1 pageSize: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Number of results per page. example: 10 totalPages: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Total number of pages available. example: 5 totalCount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Total number of matching servers. example: 42 required: - currentPage - pageSize - totalPages - totalCount additionalProperties: false required: - servers - pagination additionalProperties: false ServersListError: type: object properties: error: type: string example: Server not found required: - error additionalProperties: false ServerSummary: type: object properties: id: type: string example: abc123 qualifiedName: type: string description: Unique identifier in namespace/slug format. example: smithery/hello-world namespace: anyOf: - type: string - type: 'null' description: The namespace this server belongs to, or null if unassigned. example: smithery-ai slug: anyOf: - type: string - type: 'null' description: URL-friendly short name within the namespace. example: hello-world displayName: type: string example: Hello World description: type: string example: A simple hello world server iconUrl: anyOf: - type: string - type: 'null' example: https://example.com/icon.png verified: type: boolean description: Whether this server has been verified by Smithery. example: true useCount: type: number description: Total number of times this server has been connected to. example: 42 remote: anyOf: - type: boolean - type: 'null' description: >- Whether the server is accessed via URL (true) or runs locally via stdio (false). Null if unknown. example: true isDeployed: type: boolean description: Whether the server is currently hosted on Smithery infrastructure. example: true createdAt: type: string description: ISO 8601 timestamp of when the server was registered. example: '2024-01-01T00:00:00.000Z' homepage: type: string description: >- The server owner's homepage URL, or the server's Smithery page as a fallback. Will become nullable in a future release. example: https://example.com bySmithery: type: boolean description: >- Whether this server is maintained by Smithery (i.e. owned by the Smithery organization). example: false owner: anyOf: - type: string - type: 'null' description: User ID of the server owner, or null for community servers. example: user_abc123 score: anyOf: - type: number - type: 'null' description: RRF relevance score from search (null for browse requests). example: 0.016 required: - id - qualifiedName - namespace - slug - displayName - description - iconUrl - verified - useCount - remote - isDeployed - createdAt - homepage - bySmithery - owner - score additionalProperties: false id: ServerSummary securitySchemes: bearerAuth: type: http scheme: bearer description: Smithery API key as Bearer token ````