---
title: "Konnect MCP Servers"
url: "https://nov18-dev.movespot.fyi/apis/konnect-mcp-servers-dev-1/versions/273fb08c-b67b-49ca-b68f-f174984adea1"
---

# Konnect MCP Servers

OpenAPI specification document.

```json
{"openapi":"3.0.0","info":{"title":"Konnect MCP Servers","version":"1.0.0","description":"The endpoints for managing MCP Servers in Konnect.\n","contact":{"name":"Kong","url":"https://cloud.konghq.com"}},"servers":[{"url":"https://us.api.konghq.com/v1","description":"United-States Production region"},{"url":"https://eu.api.konghq.com/v1","description":"Europe Production region"},{"url":"https://au.api.konghq.com/v1","description":"Australia Production region"},{"url":"https://me.api.konghq.com/v1","description":"Middle-East Production region"},{"url":"https://in.api.konghq.com/v1","description":"India Production region"},{"url":"https://sg.api.konghq.com/v1","description":"Singapore Production region"}],"paths":{"/mcp-resources":{"get":{"operationId":"list-mcp-resources","summary":"List MCP Resources","description":"Returns a list of MCP resource objects.","parameters":[{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/PageAfter"},{"$ref":"#/components/parameters/MCPServerCommonFilter"}],"responses":{"200":{"description":"A response to listing MCP resources.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListMCPResourcesResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}},"tags":["MCP Servers"]},"post":{"operationId":"create-mcp-resource","summary":"Create an MCP Resource","description":"Create an MCP resource in the Konnect Organization.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPResourceInput"}}}},"responses":{"201":{"description":"A response to creating an MCP resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPResourceInfo"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}},"tags":["MCP Servers"]}},"/mcp-resources/{resourceId}":{"parameters":[{"$ref":"#/components/parameters/mcpResourceId"}],"get":{"operationId":"get-mcp-resource","summary":"Get an MCP Resource","description":"Retrieve an MCP resource by its ID.","responses":{"200":{"description":"A response to retrieving an MCP resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPResourceInfo"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]},"delete":{"operationId":"delete-mcp-resource","summary":"Delete an MCP Resource","description":"Delete an MCP resource by its ID.","responses":{"204":{"description":"Successfully deleted MCP resource."},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]},"put":{"operationId":"update-mcp-resource","summary":"Update an MCP Resource","description":"Update an MCP resource by its ID.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPResourceInput"}}}},"responses":{"200":{"description":"A response to updating an MCP resource.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPResourceInfo"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}},"tags":["MCP Servers"]}},"/mcp-resources/{resourceId}/spec":{"parameters":[{"$ref":"#/components/parameters/mcpResourceId"}],"get":{"operationId":"get-mcp-resource-spec","summary":"Get MCP Resource Spec","description":"Retrieve the raw spec content for an MCP resource.","responses":{"200":{"description":"A response to retrieving an MCP resource spec.\nUse `Accept` header to specify the format of the response content, either JSON or YAML.\nWhen `Accept` header is not specified, JSON is returned by default.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPAPISpec"}},"application/yaml":{"schema":{"$ref":"#/components/schemas/MCPAPISpecYAML"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"tags":["MCP Servers"]}}},"components":{"parameters":{"mcpResourceId":{"name":"resourceId","in":"path","required":true,"description":"The ID of the MCP resource.","schema":{"type":"string","format":"uuid"}},"MCPServerCommonFilter":{"schema":{"type":"object","properties":{"name":{"$ref":"#/components/schemas/StringFieldContainsFilter"}}},"in":"query","name":"filter","description":"Filter documents returned in the response.","required":false,"style":"deepObject"},"PageAfter":{"name":"page[after]","description":"Request the next page of data, starting with the item after this parameter.","required":false,"in":"query","allowEmptyValue":true,"schema":{"type":"string","example":"ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ"}},"PageSize":{"name":"page[size]","description":"The maximum number of items to include per page. The last page of a collection may include fewer items.","required":false,"in":"query","allowEmptyValue":true,"schema":{"type":"integer","example":10}}},"schemas":{"MCPResourceInfo":{"type":"object","properties":{"id":{"description":"The unique identifier for the MCP resource.","type":"string","format":"uuid"},"name":{"description":"The unique name of the MCP resource.","type":"string","maxLength":256,"minLength":1},"mcp_servers":{"description":"List of MCP server IDs that reference this resource.","type":"array","items":{"type":"string","format":"uuid"}},"type":{"description":"The type of the MCP resource.","type":"string","enum":["api"]},"source":{"$ref":"#/components/schemas/MCPResourceSource"},"version":{"description":"The version of the MCP resource. In the case of API resources, this corresponds\nto the version of the spec (e.g., \"3.0.0\").\n","type":"string"},"updated_at":{"$ref":"#/components/schemas/UpdatedAt"},"created_at":{"$ref":"#/components/schemas/CreatedAt"}},"required":["id","name","mcp_servers","type","source","version","updated_at","created_at"]},"MCPResourceSource":{"description":"The source of the MCP resource, indicating how it was created.","type":"string","enum":["upload","api_catalog"],"x-enum-varnames":["MCPResourceSourceUpload","MCPResourceSourceAPICatalog"]},"MCPResourceAPIConfigType":{"description":"The type of the MCP resource API configuration.","type":"string","enum":["spec","api_reference"],"x-enum-varnames":["MCPResourceAPIConfigTypeSpec","MCPResourceAPIConfigTypeAPIReference"]},"MCPResourceInput":{"type":"object","properties":{"type":{"description":"The type of the MCP resource.","type":"string","default":"api","enum":["api"]},"config":{"discriminator":{"propertyName":"type","mapping":{"spec":"#/components/schemas/MCPResourceSpecConfig","api_reference":"#/components/schemas/MCPResourceAPIReferenceConfig"}},"oneOf":[{"$ref":"#/components/schemas/MCPResourceSpecConfig"},{"$ref":"#/components/schemas/MCPResourceAPIReferenceConfig"}]}},"required":["type","config"]},"MCPResourceSpecConfig":{"description":"The configuration of the MCP resource.","type":"object","properties":{"type":{"allOf":[{"$ref":"#/components/schemas/MCPResourceAPIConfigType"},{"type":"string","enum":["spec"],"x-go-type":"MCPResourceAPIConfigType"}]},"spec":{"description":"The specification of the MCP resource in JSON or YAML format.","type":"string","maxLength":10000000}},"required":["type","spec"]},"MCPResourceAPIReferenceConfig":{"description":"The configuration of the MCP resource referencing an API catalog entry.","type":"object","properties":{"type":{"allOf":[{"$ref":"#/components/schemas/MCPResourceAPIConfigType"},{"type":"string","enum":["api_reference"],"x-go-type":"MCPResourceAPIConfigType"}]},"api_reference":{"$ref":"#/components/schemas/MCPAPIReference"}},"required":["type","api_reference"]},"MCPAPIReference":{"type":"object","properties":{"id":{"description":"The unique identifier for the API catalog entry.","type":"string","format":"uuid"},"version_id":{"description":"The version of the API catalog entry.","type":"string","format":"uuid"}},"required":["id","version_id"]},"ListMCPResourcesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MCPResourceInfo"}},"meta":{"$ref":"#/components/schemas/CursorMeta"}},"required":["data","meta"]},"MCPAPISpec":{"description":"Represents raw API spec content, such as an OpenAPI document.","type":"object","example":{"openapi":"3.0.0","info":{"version":"1.0.0","title":"Swagger Petstore"},"servers":[{"url":"http://petstore.swagger.io/v1"}],"paths":{}},"additionalProperties":true},"MCPAPISpecYAML":{"description":"Represents raw API spec content in YAML format, such as an OpenAPI document.","type":"string","example":"openapi: \"3.0.0\"\ninfo:\n  version: 1.0.0\n  title: Swagger Petstore\nservers:\n  - url: http://petstore.swagger.io/v1\npaths: {}\n"},"StringFieldContainsFilter":{"description":"Filters on the given string field value by fuzzy match.","type":"object","properties":{"contains":{"type":"string"}},"additionalProperties":false,"required":["contains"],"title":"StringFieldContainsFilter","x-examples":{"example-1":{"contains":"some-value"}}},"CreatedAt":{"description":"An ISO-8601 timestamp representation of entity creation date.","type":"string","format":"date-time","example":"2022-11-04T20:10:06.927Z","readOnly":true},"UpdatedAt":{"description":"An ISO-8601 timestamp representation of entity update date.","type":"string","format":"date-time","example":"2022-11-04T20:10:06.927Z","readOnly":true},"CursorMetaPage":{"type":"object","properties":{"first":{"description":"URI to the first page","type":"string","format":"path"},"last":{"description":"URI to the last page","type":"string","format":"path"},"next":{"description":"URI to the next page","type":"string","format":"path","nullable":true},"previous":{"description":"URI to the previous page","type":"string","format":"path","nullable":true},"size":{"description":"Requested page size","type":"number","example":10}},"required":["size","next","previous"]},"CursorMeta":{"description":"Pagination metadata.","type":"object","properties":{"page":{"$ref":"#/components/schemas/CursorMetaPage"}},"required":["page"]},"BaseError":{"description":"standard error","type":"object","properties":{"status":{"description":"The HTTP status code of the error. Useful when passing the response\nbody to child properties in a frontend UI. Must be returned as an integer.\n","type":"integer","readOnly":true},"title":{"description":"A short, human-readable summary of the problem. It should not\nchange between occurences of a problem, except for localization.\nShould be provided as \"Sentence case\" for direct use in the UI.\n","type":"string","readOnly":true},"type":{"description":"The error type.","type":"string","readOnly":true},"instance":{"description":"Used to return the correlation ID back to the user, in the format\nkong:trace:<correlation_id>. This helps us find the relevant logs\nwhen a customer reports an issue.\n","type":"string","readOnly":true},"detail":{"description":"A human readable explanation specific to this occurence of the problem.\nThis field may contain request/entity data to help the user understand\nwhat went wrong. Enclose variable values in square brackets. Should be\nprovided as \"Sentence case\" for direct use in the UI.\n","type":"string","readOnly":true}},"required":["status","title","instance","detail"],"title":"Error"},"InvalidRules":{"description":"invalid parameters rules","type":"string","enum":["required","is_array","is_base64","is_boolean","is_date_time","is_integer","is_null","is_number","is_object","is_string","is_uuid","is_fqdn","is_arn","unknown_property","missing_reference","is_label","matches_regex","invalid","is_supported_network_availability_zone_list","is_supported_network_cidr_block","is_supported_provider_region","type"],"nullable":true,"readOnly":true},"InvalidParameterStandard":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"$ref":"#/components/schemas/InvalidRules"},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"is a required field","readOnly":true}},"additionalProperties":false,"required":["field","reason"]},"InvalidParameterMinimumLength":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["min_length","min_digits","min_lowercase","min_uppercase","min_symbols","min_items","min"],"nullable":false,"readOnly":true},"minimum":{"type":"integer","example":8},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"must have at least 8 characters","readOnly":true}},"additionalProperties":false,"required":["field","reason","rule","minimum"]},"InvalidParameterMaximumLength":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["max_length","max_items","max"],"nullable":false,"readOnly":true},"maximum":{"type":"integer","example":8},"source":{"type":"string","example":"body"},"reason":{"type":"string","example":"must not have more than 8 characters","readOnly":true}},"additionalProperties":false,"required":["field","reason","rule","maximum"]},"InvalidParameterChoiceItem":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["enum"],"nullable":false,"readOnly":true},"reason":{"type":"string","example":"is a required field","readOnly":true},"choices":{"type":"array","items":{},"minItems":1,"nullable":false,"readOnly":true,"uniqueItems":true},"source":{"type":"string","example":"body"}},"additionalProperties":false,"required":["field","reason","rule","choices"]},"InvalidParameterDependentItem":{"type":"object","properties":{"field":{"type":"string","example":"name","readOnly":true},"rule":{"description":"invalid parameters rules","type":"string","enum":["dependent_fields"],"nullable":true,"readOnly":true},"reason":{"type":"string","example":"is a required field","readOnly":true},"dependents":{"type":"array","items":{},"nullable":true,"readOnly":true,"uniqueItems":true},"source":{"type":"string","example":"body"}},"additionalProperties":false,"required":["field","rule","reason","dependents"]},"InvalidParameters":{"description":"invalid parameters","type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/InvalidParameterStandard"},{"$ref":"#/components/schemas/InvalidParameterMinimumLength"},{"$ref":"#/components/schemas/InvalidParameterMaximumLength"},{"$ref":"#/components/schemas/InvalidParameterChoiceItem"},{"$ref":"#/components/schemas/InvalidParameterDependentItem"}]},"minItems":1,"nullable":false,"uniqueItems":true},"BadRequestError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","required":["invalid_parameters"],"properties":{"invalid_parameters":{"$ref":"#/components/schemas/InvalidParameters"}}}]},"UnauthorizedError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":401},"title":{"example":"Unauthorized"},"type":{"example":"https://httpstatuses.com/401"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Invalid credentials"}}}]},"ForbiddenError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":403},"title":{"example":"Forbidden"},"type":{"example":"https://httpstatuses.com/403"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Forbidden"}}}]},"ConflictError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":409},"title":{"example":"Conflict"},"type":{"example":"https://httpstatuses.com/409"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Conflict"}}}]},"NotFoundError":{"allOf":[{"$ref":"#/components/schemas/BaseError"},{"type":"object","properties":{"status":{"example":404},"title":{"example":"Not Found"},"type":{"example":"https://httpstatuses.com/404"},"instance":{"example":"kong:trace:1234567890"},"detail":{"example":"Not found"}}}]}},"examples":{"UnauthorizedExample":{"value":{"status":401,"title":"Unauthorized","instance":"kong:trace:8347343766220159418","detail":"Unauthorized"}},"ForbiddenExample":{"value":{"status":403,"title":"Forbidden","instance":"kong:trace:2723154947768991354","detail":"You do not have permission to perform this action"}},"NotFoundExample":{"value":{"status":404,"title":"Not Found","instance":"kong:trace:6816496025408232265","detail":"Not Found"}}},"responses":{"BadRequest":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}}},"Unauthorized":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"},"examples":{"UnauthorizedExample":{"$ref":"#/components/examples/UnauthorizedExample"}}}}},"Forbidden":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"},"examples":{"UnauthorizedExample":{"$ref":"#/components/examples/ForbiddenExample"}}}}},"Conflict":{"description":"Conflict","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ConflictError"}}}},"NotFound":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFoundError"},"examples":{"NotFoundExample":{"$ref":"#/components/examples/NotFoundExample"}}}}}},"securitySchemes":{"personalAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Token","description":"The personal access token is meant to be used as an alternative to basic-auth when accessing Konnect via APIs.\nYou can generate a Personal Access Token (PAT) from the [personal access token page](https://cloud.konghq.com/global/account/tokens/) in the Konnect dashboard.\nThe PAT token must be passed in the header of a request, for example:\n`curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer kpat_xgfT...'`\n"},"systemAccountAccessToken":{"type":"http","scheme":"bearer","bearerFormat":"Token","description":"The system account access token is meant for automations and integrations that are not directly associated with a human identity.\nYou can generate a system account Access Token by creating a system account and then obtaining a system account access token for that account.\nThe access token must be passed in the header of a request, for example:\n`curl -X GET 'https://global.api.konghq.com/v2/users/' --header 'Authorization: Bearer spat_i2Ej...'`\n"}}},"tags":[{"name":"MCP Servers"}],"security":[{"personalAccessToken":[]},{"systemAccountAccessToken":[]}]}
```
