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

# Retrieve agent tool integration

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

## Request

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

Retrieve a single tool integration attached to an agent. Returns 404 when the agent or the integration is not found.

## Path parameters

- `id` string, uuid, required: Agent ID
- `integrationId` string, uuid, required: Tool integration ID

## Response `200`

Default Response

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