---
title: "List MCP connections"
method: GET
path: "/integrations/mcp/connections"
tags: ["mcp-connections"]
---

# List MCP connections

`GET /integrations/mcp/connections`

## Request

- Base URL: `https://example.scalr.io/api/iacp/v3`
- URL: `https://example.scalr.io/api/iacp/v3/integrations/mcp/connections`
- Auth: HTTP bearer

List account OAuth connections in descending creation-ID order, including terminated
connections. Available even when MCP is disabled for the account.

## Query parameters

- `page[number]` string
- `page[size]` string
- `filter[status]` string
- `query` string
- `fields` object
  - `mcp-connections` string: The comma-separated list of fields to return in response for McpConnection resource.

## Response `200`

Success.

- McpConnectionListingDocument: JSON:API Document Listing see: https://jsonapi.org/format/#document-structure
  - `data` McpConnection[]
    - `attributes` object
      - `application-name` string: The registered application name. Names are not unique.
      - `authorized-by` object
        - `email` string, required
        - `full-name` string, nullable
        - `id` string, required
      - `callback` string, nullable
      - `client-id` string: The public OAuth client registration UUID.
      - `created-at` string, date-time
      - `last-activity-at` string, date-time, nullable: Last accepted authenticated MCP operation. Unknown for unused legacy grants.
      - `status` 'active' | 'terminated': Whether authorization was terminated; does not indicate transport connectivity.
      - `terminated-at` string, date-time, nullable
    - `id` string
    - `links` object
    - `type` 'mcp-connections', required
  - `included` object[]
  - `links` object
  - `meta` object

## Other responses

- `403`: User unauthorized to perform this action.
- `404`: Account not found or inaccessible.
- `4XX`: Client error.
- `5XX`: Server error.

## Changes

- **2026-11-03** `d3e1dc85657a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scalr/apis/scalr-iacp-api/changes/integrations/mcp/connections/get.md)

---

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