Skip to main content
GET
List Agent Tools

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.