---
title: "List the caller's MCP connections"
method: GET
path: "/v1/ai/mcp/connections"
tags: ["AI Knowledge"]
---

# List the caller's MCP connections

`GET /v1/ai/mcp/connections`

## Request

- Base URL: `https://api.quillhub.ai`
- URL: `https://api.quillhub.ai/v1/ai/mcp/connections`
- Auth: HTTP bearer

Returns every non-deleted connection of the authenticated user, both transports. Secrets are never included — only `has_secret`/`secret_updated_at`.

## Query parameters

- `enabled` 'true' | 'false': Filter by the `enabled` flag.

## Response `200`

Connections.

- object
  - `connections` object[], required
    - `id` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `transport` 'stdio' | 'http', required
    - `enabled` boolean, required
    - `launch` union, required
      - object
        - `transport` 'stdio', required
        - `command` string, required
        - `args` string[], required
        - `env` object, required
      - object
        - `transport` 'http', required
        - `url` string, required
        - `auth_type` 'none' | 'bearer' | 'header', required
        - `auth_header` string, nullable, required
    - `launch_fingerprint` string, required
    - `tool_prefix` string, required
    - `has_secret` boolean, required
    - `secret_updated_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `401`: Unauthenticated.

---

[API](https://skmtc.dev/quillhub/apis/quillhub-public-api.md) · [All operations](https://skmtc.dev/quillhub/apis/quillhub-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quillhub/apis/quillhub-public-api/revisions/5bd42ee9d967?raw)