AIGatewayMCPTool
objectA tool exposed by the MCP Server, mapped to a backend HTTP endpoint.
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.
Show Child Parameters
Show Child Parameters
A description of what the tool does.
Example:Search for available flights
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.
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.
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).
The method of the exported API, which must match the route’s methods.
Allowed values:DELETEGETPATCHPOSTPUT
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.
The query arguments of the exported API. If the generated query arguments are not exactly matched, this field is required.
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.
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.
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
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.
Show Child Parameters
AIGatewayMCPToolAnnotations
objectIf true, the tool may perform destructive updates
If true, repeated calls with same args have no additional effect
If true, tool interacts with external entities
If true, the tool does not modify its environment
Human-readable title for the tool
AIGatewayMCPToolHeaders
objectThe 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.
AIGatewayMCPToolQuery
objectThe query arguments of the exported API. If the generated query arguments are not exactly matched, this field is required.
AIGatewayMCPToolRequestBody
objectThe 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.