AIGatewayMCPServer

object
One Of
typestringrequired

Allowed values:conversion-only

display_namestringrequired

The display name for the MCP Server.

Example:Kong Air Flights

refstringrequired

A user-defined unique identifier for this MCP server, used as a stable human-readable reference.

Example:kongair-flights

configobjectrequired

Routing, logging, and server configuration for the MCP Server.

* Additional properties are NOT allowed.
Show Child Parameters
toolsarray[object]required

A tool exposed by the MCP Server, mapped to a backend HTTP endpoint.

* Additional properties are NOT allowed.
Show Child Parameters
policiesarray[object]required

Lightweight object used to reference a policy instance, identified by its ref.

* Additional properties are NOT allowed.
Show Child Parameters
labelsobject

Public labels store information about an entity that can be used for filtering a list of objects.

Public labels are intended to store PUBLIC metadata.

Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.

Example:{"category":"finance"}

managed_byobject

Indicates the managing entities for a resource. A maximum of 5 keys is allowed.

Keys must be 63 characters or less, starting and ending with an alphanumeric character,
and may include dashes (-), underscores (_), and dots (.).

Values must be non-empty strings of 127 characters or less.

Keys and values must not contain spaces or control characters, and are case-insensitive.

Example:{"team":"platform","owner":"kong"}

Example

AIGatewayMCPTool

object

A tool exposed by the MCP Server, mapped to a backend HTTP endpoint.

* Additional properties are NOT allowed.
aclsobject

Access control rules for allowing or denying consumer groups access to this tool.
When configured, these will override the default access control rules defined on the MCP Server.

* Additional properties are NOT allowed.
Show Child Parameters
annotationsobject
* Additional properties are NOT allowed.
Show Child Parameters
descriptionstringrequired

A description of what the tool does.

Example:Search for available flights

headersobject

The headers of the exported API. By default, Kong will extract the headers from API configuration. If the configured headers are not exactly matched, this field is required.

* Additional properties are allowed.
hoststring

The host of the exported API, which must match the route’s hosts. It should be the route’s host. By default, Kong will extract the host from API configuration. If the configured host is wildcard, this field is required.

namestring

Tool identifier. In passthrough-listener mode, used to match remote MCP Server tools for ACL enforcement. In other modes, it is also used as the tool name (overrides annotations.title if present).

methodstringrequired

The method of the exported API, which must match the route’s methods.

Allowed values:DELETEGETPATCHPOSTPUT

pathstring

The path of the exported API, which must match the route’s paths. Path not starting with ‘/’ are treated as relative path and the route path will be added as the prefix. By default, Kong will extract the path from API configuration.

queryobject

The query arguments of the exported API. If the generated query arguments are not exactly matched, this field is required.

* Additional properties are allowed.
request_bodyobject

The API requestBody specification defined in OpenAPI JSON format. For example, ‘{“content”:{“application/x-www-form-urlencoded”:{“schema”:{“type”:“object”,“properties”:{“color”:{“type”:“array”,“items”:{“type”:“string”}}}}}}}’. See https://swagger.io/docs/specification/v3_0/describing-request-body/describing-request-body/ for more details. Note that $ref is not supported.

* Additional properties are allowed.
responsesobject

The API responses specification defined in OpenAPI JSON format. This specification will be used to validate the upstream response and map it back to the structuredOutput. For example, ‘{“200”:{“content”:{“application/json”:{“schema”:{“type”:“object”,“properties”:{“result”:{“type”:“string”}}}}}}}}’. See https://swagger.io/docs/specification/v3_0/describing-responses/ for more details. Only one non-error (status code < 400) response is supported. Note that $ref is not supported.

* Additional properties are allowed.
schemestring

The scheme of the exported API. By default, Kong will extract the scheme from API configuration. If the configured scheme is not expected, this field can be used to override it.

Allowed values:httphttps

parametersarray[object]

An API parameter specification defined in OpenAPI JSON format. For example, ‘[{“name”: “city”, “in”: “query”, “description”: “Name of the city to get the weather for”, “required”: true, “schema”: {“type”: “string”}}]’. See https://swagger.io/docs/specification/v3_0/describing-parameters/ for more details.

* Additional properties are NOT allowed.
Show Child Parameters
Example

AIGatewayMCPToolAnnotations

object
* Additional properties are NOT allowed.
destructive_hintboolean

If true, the tool may perform destructive updates

idempotent_hintboolean

If true, repeated calls with same args have no additional effect

open_world_hintboolean

If true, tool interacts with external entities

read_only_hintboolean

If true, the tool does not modify its environment

titlestring

Human-readable title for the tool

Example

AIGatewayMCPToolHeaders

object

The headers of the exported API. By default, Kong will extract the headers from API configuration. If the configured headers are not exactly matched, this field is required.

* Additional properties are allowed.

AIGatewayMCPToolQuery

object

The query arguments of the exported API. If the generated query arguments are not exactly matched, this field is required.

* Additional properties are allowed.