1.1.0OAS 3.0

Specification for a theoretical REST API that serves up metadata about MCP servers.

API Base URL
  • Server 1:https://us.api.konghq.com/v0

    United-States Production region

  • Server 2:https://eu.api.konghq.com/v0

    Europe Production region

  • Server 3:https://au.api.konghq.com/v0

    Australia Production region

  • Server 4:https://me.api.konghq.com/v0

    Middle-East Production region

  • Server 5:https://in.api.konghq.com/v0

    India Production region

  • Server 6:https://sg.api.konghq.com/v0

    Singapore Production region

Security
konnectAccessToken (http)

The Konnect access token is meant to be used by the Konnect dashboard and the decK CLI authenticate with.

personalAccessToken (http)

The personal access token is meant to be used as an alternative to basic-auth when accessing Konnect via APIs.
You can generate a Personal Access Token (PAT) from the personal access token page in the Konnect dashboard.
The PAT token must be passed in the header of a request, for example:
curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer kpat_xgfT...'

systemAccountAccessToken (http)

The system account access token is meant for automations and integrations that are not directly associated with a human identity.
You can generate a system account Access Token by creating a system account and then obtaining a system account access token for that account.
The access token must be passed in the header of a request, for example:
curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer spat_i2Ej...'

Additional Information
Contact Kong

mcp_registries

Operations for managing MCP registries

List MCP registries

Returns a list of all MCP registries for the current organization

get

Query Parameters

page[size]integer

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

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

filterobject

Filter parameters for registry list endpoint

Show Child Parameters
sortstring

The asc suffix is optional as the default sort order is ascending.
The desc suffix is used to specify a descending order.
Multiple sort attributes may be provided via a comma separated list.
JSONPath notation may be used to specify a sub-attribute (eg: ‘foo.bar desc’).

Example:created_at desc

Response

application/json

A list of MCP registries

RegistryList

dataarray[object]required
Show Child Parameters
metaobjectrequired

returns the pagination information

Show Child Parameters
get/mcp-registries
 
application/json

Create MCP registry

Create a new MCP registry for the current organization

post

Body

application/json
namestringrequired

Unique registry name

Match pattern:^[0-9a-z.-]+$

>= 1 characters<= 120 characters

Example:my-registry

display_namestringrequired

Human-readable registry name

>= 1 characters<= 120 characters

Example:My MCP Registry

descriptionstring

Optional registry description

<= 2048 characters

Example:Registry for internal MCP servers

Response

application/json

Successfully created registry

Registry

idstring(uuid)required

Unique registry identifier

Example:123e4567-e89b-12d3-a456-426614174000

namestringrequired

Unique registry name

Match pattern:^[0-9a-z.-]+$

>= 1 characters<= 120 characters

Example:my-registry

display_namestringrequired

Human-readable registry name

>= 1 characters<= 120 characters

Example:My MCP Registry

descriptionstring | nullrequired

Optional registry description

<= 2048 characters

Example:Registry for internal MCP servers

created_atstring(date-time)required

Registry creation timestamp

Example:2023-12-01T10:30:00Z

updated_atstring(date-time)required

Registry last update timestamp

Example:2023-12-01T11:00:00Z

post/mcp-registries

Body

{ "name": "my-registry", "display_name": "My MCP Registry" }
 
application/json

List computed registries

Returns computed metadata for all MCP registries in the current organization, including server counts

get

Query Parameters

page[size]integer

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

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

Response

application/json

A paginated list of computed registry metadata

ComputedMcpRegistryList

dataarray[object]required
Show Child Parameters
metaobjectrequired

returns the pagination information

Show Child Parameters
get/mcp-registries/_computed
 
application/json