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 | Record<string, string>;
    require_approval?:
        | null
        | "never"
        | McpToolApprovalFilter
        | "always";
    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 | Record<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_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.