Skip to main content
GET
/
servers
List/Search servers
curl --request GET \
  --url https://registry.smithery.ai/servers \
  --header 'Authorization: Bearer <token>'
{
  "servers": [
    {
      "qualifiedName": "smithery/hello-world",
      "displayName": "Hello World",
      "description": "A simple hello world server",
      "iconUrl": "https://example.com/icon.png",
      "verified": true,
      "useCount": 42,
      "remote": true,
      "createdAt": "<string>",
      "homepage": "https://smithery.ai/server/smithery/hello-world"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 10,
    "totalPages": 5,
    "totalCount": 42
  }
}

​
Search Servers

The registry is a list of MCP servers that are available to use. You can search for MCP servers by name, description, or tags. To get started, all you need is a Smithery API Key. You can get one at smithery.ai/account/api-keys.

Authorizations

​
Authorization
string
header
required

Your Smithery API key. You can get one at https://smithery.ai/account/api-keys

Query Parameters

​
q
string

Search query. We use semantic search, so treat this as a prompt. You can use special filters:

  • Text Search: Simply type any text to search semantically (e.g., machine learning).
  • Owner Filter: Use owner:username to filter by repository owner (e.g., owner:smithery-ai).
  • Repository Filter: Use repo:repository-name to filter by repository name (e.g., repo:fetch).
  • Deployment Status: Use is:deployed to show only deployed servers.
  • Verification Status: Use is:verified to show only verified servers.

You can combine multiple filters. For example: owner:mem0ai is:verified memory.

Example:

"owner:mem0ai is:verified memory"

​
page
string

Page number for pagination (default: 1)

Example:

"1"

​
pageSize
string

Number of items per page (default: 10)

Example:

"10"

Response

Successful response

​
servers
object[]
required
​
pagination
object
required