---
title: "Unified MCP Connections screen listing"
method: GET
path: "/api/v1/mcp-connections"
tags: ["mcp-connections"]
---

# Unified MCP Connections screen listing

`GET /api/v1/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/mcp-connections`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

Returns repositories and standalone connections in one shape (ADR-006 §13.5). Filter with RSQL subset: `search=type==all` (default), `search=type==repository`, or `search=type==connection`.

## Query parameters

- `search` string: Single predicate: type==all | type==repository | type==connection.

## Response `200`

Successful Response

- McpConnectionView[]
  - `id` string, required
  - `type` 'repository' | 'connection', required
  - `name` string, required
  - `stack_profile` McpConnectionStackProfileSnippet, required: Nested stack_profile { id, name, version }.
    - `id` string, uuid, required
    - `name` string, required
    - `version` string: Semantic version when present in catalogue; otherwise empty string.
  - `api_key` McpConnectionApiKeySnippet: Active MCP key metadata (never plaintext).
    - `id` string, required
    - `last_four` string, required
    - `expires_at` string, date-time, required
    - `is_revoked` boolean, required
  - `last_connection_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `actions` McpConnectionActions, required: Per-row capability flags for the MCP Connections screen.
    - `can_edit` boolean, required
    - `can_delete` boolean, required
    - `can_renew_key` boolean, required
    - `can_revoke_key` boolean, required

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