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

# List connections

`GET /connect/{namespace}`

List all connections in a namespace. Supports filtering by metadata using `metadata.{key}={value}` query params (e.g., `metadata.userId=alice`).

## 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
    - `mcpUrl` string, required — MCP server URL
    - `metadata` object, nullable, required
    - `iconUrl` string, nullable
    - `createdAt` string — ISO 8601 timestamp
    - `status` union
      - object
        - `state` 'connected', required
      - object
        - `state` 'auth_required', required
        - `authorizationUrl` string, uri — URL to redirect user for OAuth authorization
      - 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-01-27** `12e546828dc5` — 1 info
  - added the new optional `query` request parameter `mcpUrl`

[Change 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/9d53933ba12e?raw)