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.

AIGatewayMCPToolRequestBody

object

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.