Skip to main content
GET
/
connect
/
{namespace}
JavaScript
import Smithery from '@smithery/api';

const client = new Smithery({
  apiKey: process.env['SMITHERY_API_KEY'], // This is the default and can be omitted
});

const connectionsListResponse = await client.experimental.connect.connections.list('namespace');

console.log(connectionsListResponse.connections);
{
  "connections": [
    {
      "connectionId": "clever-dolphin-a9X3",
      "name": "<string>",
      "mcpUrl": "<string>",
      "metadata": {},
      "iconUrl": "<string>",
      "createdAt": "<string>",
      "status": {
        "state": "<string>"
      },
      "serverInfo": {
        "name": "<string>",
        "version": "<string>",
        "title": "<string>",
        "icons": [
          {
            "src": "<string>",
            "mimeType": "<string>",
            "sizes": [
              "<string>"
            ],
            "theme": "light"
          }
        ],
        "websiteUrl": "<string>",
        "description": "<string>"
      }
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

​
Authorization
string
header
required

Smithery API key as Bearer token

Path Parameters

​
namespace
string
required

Query Parameters

​
limit
integer

Maximum number of items to return (default 100, max 100)

Required range: 1 <= x <= 100
Example:

50

​
cursor
string

Pagination cursor from previous response's nextCursor

​
name
string

Filter by exact connection name

​
mcpUrl
string

Filter by exact MCP server URL

Response

List of connections

​
connections
object[]
required
​
nextCursor
string | null
required

Cursor for next page, null if no more results