Class: OpenAI::Models::Beta::AgentTool::Mcp

Inherits:
Internal::Type::BaseModel show all
Defined in:
lib/openai/models/beta/agent_tool.rb,
sig/openai/models/beta/agent_tool.rbs

Defined Under Namespace

Modules: ConnectionOrigin

Instance Attribute Summary collapse

Attributes inherited from Internal::Type::BaseModel

#last_response

Instance Method Summary collapse

Methods inherited from Internal::Type::BaseModel

==, #==, #[], #_request_id, #_set_last_response, coerce, #deconstruct_keys, #deep_to_h, dump, #encode_with, fields, hash, #hash, inherited, #inspect, inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, coerce_with_error, dump, #dump, #inspect, inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(allowed_tools:, connection_origin:, credential_id:, request_metadata:, required:, server_label:, transport:, type: :mcp) ⇒ Object

Tools provided by a remote MCP server.

Parameters:

  • allowed_tools (Array<String>, nil) —

    The MCP tools the agent may call.

  • connection_origin (Symbol, OpenAI::Models::Beta::AgentTool::Mcp::ConnectionOrigin) —

    Where outbound MCP HTTP connections originate.

  • credential_id (String, nil) —

    The attached vault credential selected for this MCP server, if any. Optional when exactly one attached credential matches the server URL.

  • request_metadata (Hash{Symbol=>Object}) —

    Metadata included with requests to this MCP server.

  • required (Boolean) —

    Whether this MCP server must initialize before the first turn.

  • server_label (String) —

    A label used to identify the MCP server in tool calls.

  • transport (OpenAI::Models::Beta::McpTransport::HTTP, OpenAI::Models::Beta::McpTransport::Stdio) —

    The transport used to connect to the MCP server.

  • type (Symbol, :mcp) (defaults to: :mcp) —

    The type of the object. Always mcp.




# File 'lib/openai/models/beta/agent_tool.rb', line 147

Instance Attribute Details

#allowed_tools ⇒ Array<String>?

The MCP tools the agent may call.

Parameters:

  • value (::Array[String], nil)

Returns:

  • (Array<String>, nil) 


102
 
# File 'lib/openai/models/beta/agent_tool.rb', line 102

required :allowed_tools, OpenAI::Internal::Type::ArrayOf[String], nil?: true

#connection_origin ⇒ Symbol, OpenAI::Models::Beta::AgentTool::Mcp::ConnectionOrigin

Where outbound MCP HTTP connections originate.

Parameters:

  • value (OpenAI::Models::Beta::AgentTool::Mcp::connection_origin)

Returns:



108
 
# File 'lib/openai/models/beta/agent_tool.rb', line 108

required :connection_origin, enum: -> { OpenAI::Beta::AgentTool::Mcp::ConnectionOrigin }

#credential_id ⇒ String?

The attached vault credential selected for this MCP server, if any. Optional when exactly one attached credential matches the server URL.

Parameters:

  • value (String, nil)

Returns:

  • (String, nil) 


115
 
# File 'lib/openai/models/beta/agent_tool.rb', line 115

required :credential_id, String, nil?: true

#request_metadata ⇒ Hash{Symbol=>Object}

Metadata included with requests to this MCP server.

Parameters:

  • value (::Hash[Symbol, top])

Returns:

  • (Hash{Symbol=>Object}) 


121
 
# File 'lib/openai/models/beta/agent_tool.rb', line 121

required :request_metadata, OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown]

#required ⇒ Boolean

Whether this MCP server must initialize before the first turn.

Parameters:

Returns:



127
 
# File 'lib/openai/models/beta/agent_tool.rb', line 127

required :required, OpenAI::Internal::Type::Boolean

#server_label ⇒ String

A label used to identify the MCP server in tool calls.

Parameters:

  • value (String)

Returns:

  • (String) 


133
 
# File 'lib/openai/models/beta/agent_tool.rb', line 133

required :server_label, String

#transport ⇒ OpenAI::Models::Beta::McpTransport::HTTP, OpenAI::Models::Beta::McpTransport::Stdio

The transport used to connect to the MCP server.

Parameters:

  • value (OpenAI::Models::Beta::mcp_transport)

Returns:



139
 
# File 'lib/openai/models/beta/agent_tool.rb', line 139

required :transport, union: -> { OpenAI::Beta::McpTransport }

#type ⇒ Symbol, :mcp

The type of the object. Always mcp.

Parameters:

  • value (:mcp)

Returns:

  • (Symbol, :mcp) 


145
 
# File 'lib/openai/models/beta/agent_tool.rb', line 145

required :type, const: :mcp

Instance Method Details

#to_hash ⇒ {

Returns:

  • ({) 


106
 
# File 'sig/openai/models/beta/agent_tool.rbs', line 106

def to_hash: -> {