McpGatewaySkill
Bridge a Model Context Protocol (MCP) Gateway service with SWAIG functions. The skill connects to the gateway at load time, enumerates the configured services and tools, and registers each as a SWAIG function on the agent.
The gateway URL is validated by an SSRF guard — private, loopback, and
cloud-metadata endpoints are rejected. Every later request, and every redirect
it follows, is checked the same way, so a gateway that redirects to a private or
internal address, or a hostname that later resolves to one, is refused. A tool
call is tried up to retry_attempts times in total, with a per-request timeout
of request_timeout seconds. It’s tried again after a connection error, a
timeout, a refused address, or an HTTP 5xx response, but not after a 4xx
response or a 200 whose body isn’t JSON.
Class: McpGatewaySkill
Tools: Dynamically registered from the gateway (prefixed by tool_prefix)
Env vars: MCP_GATEWAY_AUTH_TOKEN, MCP_GATEWAY_AUTH_USER,
MCP_GATEWAY_AUTH_PASSWORD
gateway_url
URL of the MCP Gateway service. Must pass the SSRF guard.
auth_token
Bearer token for authentication. Falls back to the
MCP_GATEWAY_AUTH_TOKEN environment variable. Takes precedence over
basic auth when provided.
auth_user
Basic-auth username (used when auth_token is not supplied). Falls back
to MCP_GATEWAY_AUTH_USER.
auth_password
Basic-auth password. Falls back to MCP_GATEWAY_AUTH_PASSWORD.
services
Services to expose. Each entry has:
name(string) — service name registered on the gateway.tools("*"orstring[]) — which tools to expose from that service.
Empty array exposes every available service/tool.
session_timeout
Gateway session timeout in seconds.
tool_prefix
Prefix prepended to each SWAIG function name registered from the gateway
(e.g., mcp_todo_add_todo).
retry_attempts
Total attempts per tool call, including the first.
request_timeout
Per-request timeout in seconds.
verify_ssl
Whether to verify TLS certificates on outbound requests. Setting this to
false alone is ignored; verification stays on unless allow_insecure_tls
is also true.
allow_insecure_tls
Explicit opt-in that, together with verify_ssl: false, disables TLS
certificate verification. Only the certificate check is skipped: the address
checks still apply.
With verify_ssl: false and allow_insecure_tls: true, outbound requests to
the gateway accept any certificate and are exposed to interception. Use it only
against a trusted self-signed gateway on a private network.