---
title: "List connections"
method: GET
path: "/connect/{namespace}"
tags: ["connect"]
---

# List connections

`GET /connect/{namespace}`

## Request

- Base URL: `https://api.smithery.ai`
- URL: `https://api.smithery.ai/connect/{namespace}`
- Auth: HTTP bearer

List all connections in a namespace. Supports filtering by metadata using `metadata.{key}={value}` query params.

## Path parameters

- `namespace` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `name` string
- `mcpUrl` string

## Response `200`

List of connections

- ConnectionsListResponse
  - `connections` Connection[], required
    - `connectionId` string, required: Connection ID (auto-generated or developer-defined)
    - `name` string, required: Human-readable name
    - `transport` 'http' | 'uplink': Connection transport
    - `mcpUrl` string, nullable, required: MCP server URL. Null for uplink connections.
    - `metadata` object, nullable, required
    - `mock` MockConfig
      - `enabled` boolean, required: Turn mock mode on for this connection.
      - `scenario` string: Natural-language starting-state for the simulator (threaded into the LLM system prompt so generated data is consistent with the scenario across calls).
    - `iconUrl` string, nullable
    - `createdAt` string: ISO 8601 timestamp
    - `status` union
      - object
        - `state` 'connected', required
      - object
        - `state` 'disconnected', required
      - object
        - `state` 'auth_required', required
        - `setupUrl` string, uri: Hosted Smithery URL for completing setup and OAuth
        - `authorizationUrl` string, uri: Deprecated compatibility alias for setupUrl
      - object
        - `state` 'input_required', required
        - `setupUrl` string, uri: Hosted Smithery URL for completing setup in the browser
        - `http` CredentialProfileHttp, required
          - `headers` object
          - `query` object
        - `missing` object, required
          - `headers` string[], required
          - `query` string[], required
      - object
        - `state` 'error', required
        - `message` string, required: Error message
    - `serverInfo` ServerInfo
      - `name` string, required
      - `title` string
      - `icons` object[]
        - `src` string, required
        - `mimeType` string
        - `sizes` string[]
        - `theme` 'light' | 'dark'
      - `version` string, required
      - `websiteUrl` string
      - `description` string
  - `nextCursor` string, nullable, required: Cursor for next page, null if no more results

## Other responses

- `400`: Bad request

## Changes

- **2026-10-16** `17463ce9a13a`: 1 info
  - endpoint added
- **2026-04-24** `3f57836881dd`: 1 breaking
  - api path removed without deprecation
- **2026-04-23** `10f65f70e8c0`: 2 breaking, 1 info
  - response property `connections/items/mcpUrl` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added `subschema #2: ConnectionStatusDisconnected` to the `connections/items/status` response property `oneOf` list for the response status `200`
  - added the optional property `connections/items/transport` to the response with the `200` status
- **2026-04-21** `e0848f588e5f`: 1 breaking, 2 info
  - the `connections/items/mock` response's property type changed from `boolean` to `object` for status `200`
  - added the optional property `connections/items/mock/scenario` to the response with the `200` status
  - added the required property `connections/items/mock/enabled` to the response with the `200` status
- **2026-04-20** `0ac2ebb989ed`: 1 info
  - added the optional property `connections/items/mock` to the response with the `200` status

[Operation history](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/changes/connect/:namespace/get.md)

---

[API](https://skmtc.dev/smithery-ai/apis/smithery-platform-api.md) - [All operations](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smithery-ai/apis/smithery-platform-api/revisions/17463ce9a13a?raw)