Catalog MCP Versions

Create MCP version

Changed on

Creates the latest version. Currently, a MCP only has a single version. Returns 409 if a version already exists.

post/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

Request body

versionstring required

User-supplied version label.

Example request

{
  "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"
        }
      ]
    }
  ]
}

Response

Response schema for MCP versions.

idstring uuid required

The unique identifier of the version.

versionstring required

User-supplied version label.

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "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