List Agent Tools

Retrieve all enabled tools for an agent, including AgentPress tools and MCP tools

Endpoint

GET /agents/{agent_id}/tools

Retrieves all tools enabled for a specific agent, including both AgentPress native tools and MCP (Model Context Protocol) tools from configured servers.

Authentication

Requires JWT authentication via the Authorization header.

Path Parameters

agent_id · string · required

The unique identifier of the agent

Response

Returns a JSON object containing two arrays:

agentpress_tools · array

Array of AgentPress native tools configured for the agent

Show Tool Object

name · string

The tool name (e.g., sb_shell_tool, web_search_tool, browser_tool)

enabled · boolean

Whether the tool is enabled for this agent

mcp_tools · array

Array of MCP tools from connected servers (Composio, custom MCPs)

Show MCP Tool Object

name · string

The tool name from the MCP server (e.g., GMAIL_SEND_EMAIL, SLACK_SEND_MESSAGE)

server · string

The MCP server name this tool belongs to

enabled · boolean

Whether the tool is enabled (always true for listed tools)

Available AgentPress Tools

The system includes several categories of native tools:

Core Tools

• expand_msg_tool - Expand message context
• message_tool - Send messages to users
• task_list_tool - Manage task lists
• sb_git_sync - Git synchronization

Sandbox Tools

• sb_shell_tool - Execute shell commands
• sb_files_tool - File operations
• sb_file_reader_tool - Read file contents
• sb_expose_tool - Expose sandbox URLs
• sb_vision_tool - Image analysis
• sb_image_edit_tool - Image editing
• sb_kb_tool - Knowledge base access
• sb_presentation_tool - Create presentations
• sb_canvas_tool - Canvas operations
• sb_spreadsheet_tool - Spreadsheet operations
• sb_upload_file_tool - File uploads

Search Tools

• web_search_tool - Web search
• image_search_tool - Image search
• people_search_tool - People search
• company_search_tool - Company search
• paper_search_tool - Academic paper search

Utility Tools

• browser_tool - Browser automation
• vapi_voice_tool - Voice generation
• reality_defender_tool - Content verification
• apify_tool - Web scraping
• composio_upload_tool - Upload files to Composio

Agent Builder Tools

• agent_config_tool - Agent configuration
• agent_creation_tool - Create new agents
• mcp_search_tool - Search MCP integrations
• credential_profile_tool - Manage credentials
• trigger_tool - Configure triggers

Example Request

cURL

curl -X GET "https://api.kortix.ai/agents/agt_abc123/tools" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Example Response

{
  "agentpress_tools": [
    {
      "name": "sb_shell_tool",
      "enabled": true
    },
    {
      "name": "sb_files_tool",
      "enabled": true
    },
    {
      "name": "web_search_tool",
      "enabled": true
    },
    {
      "name": "browser_tool",
      "enabled": false
    }
  ],
  "mcp_tools": [
    {
      "name": "GMAIL_SEND_EMAIL",
      "server": "Gmail",
      "enabled": true
    },
    {
      "name": "SLACK_SEND_MESSAGE",
      "server": "Slack",
      "enabled": true
    },
    {
      "name": "GITHUB_CREATE_ISSUE",
      "server": "GitHub",
      "enabled": true
    }
  ]
}

Error Responses

404 · error

Worker not found - The agent does not exist or you don’t have access

{
  "detail": "Worker not found"
}

403 · error

Access denied - You don’t own this agent and it’s not public

{
  "detail": "Access denied"
}

401 · error

Unauthorized - Invalid or missing authentication token

{
  "detail": "Not authenticated"
}

Notes

• Tools are configured per agent version. The response reflects the current active version.
• MCP tools are dynamically loaded from configured integrations (Composio profiles, custom MCP servers).
• Only enabled tools appear in the response for MCP tools.
• AgentPress tools show their enabled state explicitly, including disabled tools.
• Tool metadata and schemas can be fetched separately if needed for UI rendering.