Give the model access to additional tools via remote Model Context Protocol (MCP) servers. Learn more about MCP.

interface Mcp {
    allowed_tools?: null | string[] | McpAllowedToolsFilter;
    headers?: null | {
        [key: string]: string;
    };
    require_approval?:
        | null
        | "never"
        | McpToolApprovalFilter
        | "always";
    server_description?: string;
    server_label: string;
    server_url: string;
    type: "mcp";
}

Properties

allowed_tools?: null | string[] | McpAllowedToolsFilter

List of allowed tool names or a filter object.

headers?: null | {
    [key: string]: string;
}

Optional HTTP headers to send to the MCP server. Use for authentication or other purposes.

require_approval?:
    | null
    | "never"
    | McpToolApprovalFilter
    | "always"

Specify which of the MCP server's tools require approval.

server_description?: string

Optional description of the MCP server, used to provide more context.

server_label: string

A label for this MCP server, used to identify it in tool calls.

server_url: string

The URL for the MCP server.

type: "mcp"

The type of the MCP tool. Always mcp.