---
title: "Get an MCP connector"
method: GET
path: "/mcp-connectors/{connectionId}"
tags: ["MCP Connectors"]
---

# Get an MCP connector

`GET /mcp-connectors/{connectionId}`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/mcp-connectors/{connectionId}`
- Auth: none declared

Get one configured MCP connector by connection ID.

## Path parameters

- `connectionId` string, uuid, required: Connection ID to fetch.

## Query parameters

- `projectId` string, uuid: Project the connector belongs to. Auto-filled from SDK context when omitted.

## Response `200`

OK

- object
  - `connector` object, required
    - `maskedHeaders` object[]
      - `id` string, required
      - `name` string, required
      - `maskedValue` string, required
    - `grantedScopes` string[]
    - `connectionStatus` object
      - `state` 'connected' | 'needs_attention' | 'connecting' | 'not_connected', required
      - `reasonCode` 'credentials_rejected' | 'permissions_missing' | 'configuration_invalid' | 'discovery_failed' | 'health_check_failed' | 'stream_failed' | 'recovery_required', nullable, required
      - `checkedAt` string, date-time, nullable, required
      - `verification` 'verified' | 'unverified', required
    - `recovery` object
      - `action` 'reconnect' | 'update_credentials' | 'manage_installation' | 'manage_owner' | 'review_setup', nullable, required
      - `canCheck` boolean, required
      - `canDisconnect` boolean, required
      - `target` object
        - `kind` 'integration' | 'connected_account' | 'mcp_connector' | 'log_source' | 'sandbox_cli', required
        - `resourceId` string, required
        - `providerId` string, required
        - `scope` object, required
          - `kind` 'user' | 'organization' | 'project', required
          - `id` string, required
    - `connectionId` string, uuid, required: Connection ID.
    - `connectionKey` string, required: Stable key used to reference this connector in tool calls.
    - `providerId` string, required: Provider identifier, e.g. "linear".
    - `displayName` string, required: Human-readable connector name.
    - `source` 'preset' | 'custom', required: Whether the connector is a built-in preset or a custom server.
    - `installStatus` 'configured' | 'authorizing' | 'connected' | 'error', required: Current connection lifecycle status.
    - `authMode` 'none' | 'headers' | 'oauth' | 'aws-sigv4', required: Authentication mode.
    - `transport` 'streamable-http' | 'sse', required: Transport protocol.
    - `serverUrl` string, required: MCP server URL.
    - `readOnly` boolean, required: Whether the connector is restricted to read-only tools.
    - `management` object, required: Lifecycle owner and supported connector mutations.
      - `mode` 'user' | 'system', required
      - `managedBy` object, nullable, required
        - `type` 'integration', required
        - `id` string, required
        - `displayName` string, required
        - `iconKey` string, required
      - `capabilities` object, required
        - `canRename` boolean, required
        - `canEditCredentials` boolean, required
        - `canSetReadOnly` boolean, required
        - `canConfigureTools` boolean, required
        - `canDisconnect` boolean, required
    - `enabledToolCount` integer, required: Number of tools enabled and available for this connector.
    - `connectedAt` string, date-time, nullable, required: When the connector last became connected, if ever.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Changes

- **2026-10-15** `6bdb938c29b8`: 2 info
  - added the optional property `connector/grantedScopes` to the response with the `200` status
  - added the optional property `connector/maskedHeaders` to the response with the `200` status
- **2026-09-17** `9be5c4da3dc5`: 2 info
  - added the optional property `connector/connectionStatus` to the response with the `200` status
  - added the optional property `connector/recovery` to the response with the `200` status

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/mcp-connectors/:connectionId/get.md)

---

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