Catalog MCPs

List MCPs

Changed on

Returns a paginated list of MCPs for the current organization. Each row includes a managed_by object derived from whether the MCP is linked to an AI Gateway MCP.

get/v1/mcp-servers

Request

  • Base URL: https://global.api.konghq.com
  • URL: https://global.api.konghq.com/v1/mcp-servers
  • 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.

Filter MCPs returned in the response.

{
  "created_at": {
    "eq": "2022-03-30T07:20:50Z"
  },
  "updated_at": {
    "eq": "2022-03-30T07:20:50Z"
  }
}
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

Sort MCPs by specified fields. Supported sort attributes are:

  • display_name
  • name
  • created_at
  • updated_at

Default sort is display_name in ascending order.

Response

Response schema for a paginated list of MCPs.

Example response

{
  "meta": {
    "page": {
      "number": 1,
      "size": 10,
      "total": 100
    }
  },
  "data": [
    {
      "id": "7703e2f2-f9c0-47e3-9146-5fa50486b871",
      "name": "my-mcp",
      "display_name": "My MCP",
      "description": "Description of MCP.",
      "labels": {
        "env": "test"
      },
      "managed_by": {
        "owner": "terraform"
      },
      "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