Skip to main content
GET
/
agent
/
tool
/
{agent_id}
List Agent Tools
curl --request GET \
  --url https://api.getoutbox.ai/agent/tool/{agent_id} \
  --header 'Authorization: <api-key>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "type": "<string>",
    "builtin_key": "<string>",
    "display_name": "<string>",
    "mcp_tool": "<string>",
    "url": "<string>",
    "description": "<string>",
    "method": "<string>",
    "auth_token": "<string>",
    "config": {},
    "is_async": true,
    "is_success": true,
    "is_prerun": true,
    "is_postrun": true,
    "schema": [
      {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "type": "<string>",
        "required": true
      }
    ],
    "destinations": [
      {}
    ],
    "mcp_config_id": "<string>",
    "mcp_allowed_tools": [
      "<string>"
    ],
    "mcp_toolkit": "<string>",
    "icon_url": "<string>",
    "application_icon_url": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Company API Key

Path Parameters

​
agent_id
string
required

The ID of the agent

Response

Tools retrieved successfully

​
id
string<uuid>
​
name
string
​
type
string

custom, builtin, mcp, transfer, etc.

​
builtin_key
string | null

Built-in tool key (builtin tools only).

​
display_name
string | null

Resolved display name for built-in or MCP tools.

​
mcp_tool
string | null

MCP tool identifier (mcp tools only).

​
url
string | null
​
description
string | null
​
method
string | null

HTTP method (custom tools).

​
auth_token
string | null
​
config
object

Preset tool inputs supplied by the developer.

​
is_async
boolean
​
is_success
boolean
​
is_prerun
boolean
​
is_postrun
boolean
​
schema
object[]

Tool input variables.

​
destinations
object[]

Transfer destinations (transfer tools only). Each entry: id, phone_number, description, transfer_message, transfer_type, plus optional custom_message, fallback_message, extension, transfer_agent_prompt, assistant_first_message*.

​
mcp_config_id
string | null

Composio MCP server ID (mcp tools only).

​
mcp_allowed_tools
string[]

Allowed-tool whitelist for MCP servers.

​
mcp_toolkit
string | null
​
icon_url
string | null

Application icon URL (mcp tools only).

​
application_icon_url
string | null

Application icon URL for resolved tool metadata.