tools

List host-side tools

Changed on

Lists the tools the orchestrator can run inside a turn, each annotated with whether this caller can use it. Tools the caller cannot use are returned with a reason rather than hidden.

get/api/v1/tools

Request

Response

object'list' required

Example response

{
  "object": "list",
  "data": [
    {
      "server_label": "slack",
      "type": "mcp",
      "name": "Slack",
      "auth": "connection",
      "connect": "oauth",
      "connect_path": "/oauth/slack/connect",
      "logo_url": "https://proteus-prod-public.s3.us-east-1.amazonaws.com/connectors/slack.svg",
      "mode": "remote_mcp",
      "default_require_approval": "never",
      "required_scope": "mcp:slack",
      "unavailable_reason": "not_implemented"
    }
  ]
}

Changes