Skip to main content

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
mcp_tools
array
Array of MCP tools from connected servers (Composio, custom MCPs)

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 -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.

Build docs developers (and LLMs) love