SMsmithery-ai
servers

Get a server

Changed on

Retrieve server details including connections, tools, and security status.

get/servers/{qualifiedName}

Request

  • Base URL
    https://api.smithery.ai
  • URL
    https://api.smithery.ai/servers/{qualifiedName}
  • Auth
    HTTP bearer

Path parameters

qualifiedNamestring required

The server's qualified name (e.g. 'namespace/server' or 'namespace' for namespace-only servers). Use %2F to encode the slash.

Response

Server found

qualifiedNamestring required
displayNamestring required
descriptionstring required
iconUrlstring nullable required
remoteboolean required
deploymentUrlstring nullable required

Example response

{
  "qualifiedName": "smithery/hello-world",
  "displayName": "Hello World",
  "description": "A simple hello world server",
  "iconUrl": "https://example.com/icon.png",
  "remote": true,
  "deploymentUrl": "https://api.example.com",
  "security": {
    "scanPassed": true
  },
  "tools": [
    {
      "name": "get_weather",
      "description": "Get current weather"
    }
  ],
  "resources": [
    {
      "name": "config://settings",
      "uri": "config://app/settings",
      "description": "Application settings",
      "mimeType": "application/json"
    }
  ],
  "prompts": [
    {
      "name": "summarize",
      "description": "Summarize the given text",
      "arguments": [
        {
          "name": "text",
          "description": "The text to summarize",
          "required": true
        }
      ]
    }
  ]
}

Changes

  • 6926fbee5e94Revision changes
    • info

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

  • 3f57836881ddRevision changes
    • warning

      removed the optional property ////// from the response with the status

    • warning

      added the new binary enum value to the ////// response property for the response status

    • warning

      added the new bun enum value to the ////// response property for the response status

    • warning

      added the new node enum value to the ////// response property for the response status

    • warning

      added the new python enum value to the ////// response property for the response status

    • info

      the response property ////// became required for the status

    • info

      the response property ////// became required for the status