Skip to main content
GET
List Agent Tools
Returns the skills you attached to this agent, one AgentTool per attachment (the same shape as the tools array on Get Agent). Each item has a type of action (an operation of a connected service), custom_function, mcp, agent (a sub-agent), or workflow, plus the identifiers for that kind (connection_id and operation_id for actions, custom_function_id, mcp_id, or target_id). The list holds attached skills only. Capabilities the runtime provides on its own (web search, email, file sharing, scheduling, live surfaces) are not attachments and do not appear here, so a freshly created agent returns [] even though it can already use them.

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

agent_id
string
required

Response

Successful Response

id
string
required

Stable handle for this attached tool. Pass it to DELETE to remove the tool.

type
enum<string>
required

The kind of attached tool.

Available options:
action,
custom_function,
mcp,
agent,
workflow,
skill
name
string | null

Human-readable tool name.

connection_id
string | null

Connector connection id. Actions only.

operation_id
string | null

Operation catalog id. Actions only.

operation_name
string | null

OpenAPI operationId. Actions only.

use_mock
boolean | null

Operation serves AI-generated mock data instead of the real API. Actions only.

custom_function_id
string | null

Custom function id. Custom functions only.

mcp_id
string | null

MCP registry id. MCP only.

allowed_tools
string[] | null

Subset of MCP tools exposed. MCP only.

mcp_url
string | null

MCP server url. MCP only.

mcp_auth_type
string | null

MCP auth type (api_key/oauth2/custom_headers/none). MCP only.

mcp_registry_id
string | null

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
string | null

MCP transport (streamable-http/sse/stdio). MCP only.

mcp_headers
string[] | null

Custom header names configured on the MCP (keys only; values are never returned). MCP only.

mcp_client_id
string | null

OAuth2 client id for the MCP, if set. MCP only.

mcp_additional_scopes
string[] | null

Extra OAuth2 scopes for the MCP. MCP only.

mcp_share_user_token
boolean | null

Whether the authorized MCP token is shared across the org's other agents. MCP only.

mcp_has_api_key
boolean | null

Whether an API key is stored for the MCP (the value is never returned). MCP only.

mcp_has_client_secret
boolean | null

Whether an OAuth2 client secret is stored for the MCP (the value is never returned). MCP only.

target_id
string | null

Referenced sub-agent or workflow id.

skill_name
string | null

Skill name from the xpander skills catalog. Skills only.