---
title: "List agent tool integrations"
method: GET
path: "/v1/agents/{id}/tool-integrations"
---

# List agent tool integrations

`GET /v1/agents/{id}/tool-integrations`

## Request

- Base URL: `https://api.runbear.io`
- URL: `https://api.runbear.io/v1/agents/{id}/tool-integrations`
- Auth: HTTP bearer

List MCP, Pipedream, and Custom MCP integrations attached to an agent. `status` is computed: `ready` means the integration is fully authorized and callable; `pending_auth` means OAuth must be completed before tools are usable. Returns 404 when the agent is not found or its provider does not support tool integrations.

## Path parameters

- `id` string, uuid, required: Agent ID

## Response `200`

Default Response

- AgentToolIntegrationListResponse
  - `toolIntegrations` ToolIntegration[], required
    - union: A tool integration attached to an agent. Discriminated on `type`: `managed-mcp` (Runbear-managed MCP server), `pipedream` (Pipedream connector), or `custom-mcp` (caller-hosted MCP server).
      - object
        - `id` string, uuid, required: Tool integration ID.
        - `status` 'ready' | 'pending_auth', required: Connection health. `ready` means the integration is fully authorized and callable. `pending_auth` means the user must complete OAuth (or otherwise complete setup) before tools are usable.
        - `createdAt` string, required
        - `updatedAt` string, required
        - `excludedTools` string[]: Tools excluded from the agent's toolbox by name.
        - `type` 'managed-mcp', required
        - `app` string, required: Managed MCP catalog slug (e.g., "notion").
      - object
        - `id` string, uuid, required: Tool integration ID.
        - `status` 'ready' | 'pending_auth', required: Connection health. `ready` means the integration is fully authorized and callable. `pending_auth` means the user must complete OAuth (or otherwise complete setup) before tools are usable.
        - `createdAt` string, required
        - `updatedAt` string, required
        - `excludedTools` string[]: Tools excluded from the agent's toolbox by name.
        - `type` 'pipedream', required
        - `nameSlug` string, required: Pipedream app slug (e.g., "firecrawl", "aws").
        - `authType` 'keys' | 'oauth' | 'none', nullable, required: Authentication style required by the Pipedream app.
      - object
        - `id` string, uuid, required: Tool integration ID.
        - `status` 'ready' | 'pending_auth', required: Connection health. `ready` means the integration is fully authorized and callable. `pending_auth` means the user must complete OAuth (or otherwise complete setup) before tools are usable.
        - `createdAt` string, required
        - `updatedAt` string, required
        - `excludedTools` string[]: Tools excluded from the agent's toolbox by name.
        - `type` 'custom-mcp', required
        - `app` string, required: Display label for the MCP server.
        - `url` string, required: Remote MCP server URL.
        - `transportType` 'sse' | 'streamableHttp', required
        - `auth` union, required
          - object
            - `type` 'oauth', required
          - object
            - `type` 'none', required
          - object
            - `type` 'static', required
            - `headerKey` string, required
        - `httpHeaders` object: HTTP headers forwarded to the MCP server. Vault-backed values expose only `keyName`, never the secret value.

## Other responses

- `404`: Default Response

---

[API](https://skmtc.dev/runbear/apis/runbear-api.md) - [All operations](https://skmtc.dev/runbear/apis/runbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runbear/apis/runbear-api/revisions/c6a9c3066a5a?raw)