servers

Get a server

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

get/servers/{qualifiedName}

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

Changed in 5 of the 47 revisions of this API.256

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

      response-optional-property-added

  • 3f57836881dd52See the full diff
    • removed the optional property ////// from the response with the status

      response-optional-property-removed

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

      response-property-enum-value-added

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

      response-property-enum-value-added

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

      response-property-enum-value-added

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

      response-property-enum-value-added

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

      response-property-became-required

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

      response-property-became-required

    • removed the required property from the response with the status

      response-required-property-removed

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

    • 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

    • added the required property to the response with the status

      response-required-property-added

    • api path removed without deprecation

      api-path-removed-without-deprecation