Catalog MCP Versions

List MCP versions

Changed on

Returns the MCP's versions.

get/v1/mcp-servers/{mcpId}/versions

Request

  • Base URL: https://global.api.konghq.com
  • URL: https://global.api.konghq.com/v1/mcp-servers/{mcpId}/versions
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Query parameters

page[size]integer
Example:10

The maximum number of items to include per page. The last page of a collection may include fewer items.

page[number]integer
Example:1

Determines which page of the entities to retrieve.

Response

Response schema for a paginated list of MCP versions.

Example response

{
  "meta": {
    "page": {
      "number": 1,
      "size": 10,
      "total": 100
    }
  },
  "data": [
    {
      "id": "9c4a1b2c-3d4e-5f60-7182-93a4b5c6d7e8",
      "version": "1.0.0",
      "tools": [
        {
          "name": "my-tool"
        }
      ],
      "resources": [
        {
          "name": "my-resource"
        }
      ],
      "remotes": [
        {
          "type": "streamable-http",
          "url": "https://api.example.com/mcp"
        }
      ],
      "packages": [
        {
          "registry": {
            "type": "npm",
            "base_url": "https://registry.npmjs.org"
          },
          "identifier": "@modelcontextprotocol/server-brave-search",
          "version": "1.0.2",
          "file_sha256": "fe333e598595000ae021bd27117db32ec69af6987f507ba7a63c90638ff633ce",
          "transport": {
            "type": "stdio"
          },
          "runtime": {
            "hint": "npx",
            "arguments": [
              {
                "type": "positional",
                "value_hint": "file_path"
              }
            ]
          },
          "package_arguments": [
            {
              "type": "positional",
              "value_hint": "file_path"
            }
          ],
          "environment_variables": [
            {
              "choices": [],
              "name": "SOME_VARIABLE"
            }
          ]
        }
      ],
      "created_at": "2022-11-04T20:10:06.927Z",
      "updated_at": "2022-11-04T20:10:06.927Z"
    }
  ]
}

Changes

  • 7aab863a6daaRevision changes
    • breaking

      added to the / response property oneOf list for the response status

    • warning

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

    • warning

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

  • 59663dd13a10Revision changes
    • info

      endpoint added