---
title: "List an organisation's open MCP connections and shared connection-quota usage"
method: GET
path: "/api/v1/orgs/mcp-connections"
tags: ["org-mcp-connections"]
---

# List an organisation's open MCP connections and shared connection-quota usage

`GET /api/v1/orgs/mcp-connections`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/api/v1/orgs/mcp-connections`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

## Query parameters

- `org_id` string, required: Keycloak organisation id (must appear in the JWT org_ids claim)

## Response `200`

Successful Response

- OrgMcpConnectionsResponse: The org's open MCP connections plus shared connection-quota usage.
  - `organisation_id` string, required
  - `mcp_open_count` integer, required
  - `used` integer, required
  - `max_connections` integer, nullable
  - `at_limit` boolean
  - `connections` OrgMcpConnectionItem[], required
    - `id` string, required
    - `auth_method` string, required
    - `user` string, nullable
    - `client_info_name` string, nullable
    - `client_info_version` string, nullable
    - `client_ip` string, nullable
    - `user_agent` string, nullable
    - `linked_repository_name` string, nullable
    - `linked_repositories` LinkedRepositoryItem[]
      - `id` string, required
      - `name` string, nullable
    - `created_at` string, nullable
    - `last_connection` string, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)