Add Agent Tool
Attach a tool to an agent (action, custom_function, mcp, agent, or workflow). The API handles catalog resolution and graph wiring.
type:
action—{ "type": "action", "connection_id": "...", "operation_ids": ["<catalog id>"] }custom_function—{ "type": "custom_function", "custom_function_id": "..." }mcp(registry) —{ "type": "mcp", "mcp_id": "<registry id>" }mcp(inline) —{ "type": "mcp", "url": "https://...", "name": "...", "transport": "streamable-http" }agent(sub-agent) —{ "type": "agent", "agent_id": "..." }workflow—{ "type": "workflow", "workflow_id": "..." }
Authorizations
API Key for authentication
Path Parameters
Query Parameters
Deploy the agent after adding so the change takes effect immediately.
Body
- AddActionTool
- AddCustomFunctionTool
- AddMcpTool
- AddSubAgentTool
- AddWorkflowTool
- AddSkillTool
Attach connector operations as agent tools.
Response
Successful Response
Stable handle for this attached tool. Pass it to DELETE to remove the tool.
The kind of attached tool.
action, custom_function, mcp, agent, workflow, skill Human-readable tool name.
Connector connection id. Actions only.
Operation catalog id. Actions only.
OpenAPI operationId. Actions only.
Operation serves AI-generated mock data instead of the real API. Actions only.
Custom function id. Custom functions only.
MCP registry id. MCP only.
Subset of MCP tools exposed. MCP only.
MCP server url. MCP only.
MCP auth type (api_key/oauth2/custom_headers/none). MCP only.
Registry entry id when this MCP is attached from the shared org registry (editing it affects every agent). Absent for inline MCPs. MCP only.
MCP transport (streamable-http/sse/stdio). MCP only.
Custom header names configured on the MCP (keys only; values are never returned). MCP only.
OAuth2 client id for the MCP, if set. MCP only.
Extra OAuth2 scopes for the MCP. MCP only.
Whether the authorized MCP token is shared across the org's other agents. MCP only.
Whether an API key is stored for the MCP (the value is never returned). MCP only.
Whether an OAuth2 client secret is stored for the MCP (the value is never returned). MCP only.
Referenced sub-agent or workflow id.
Skill name from the xpander skills catalog. Skills only.

