GET
/
api
/
v2
/
public
/
mcp-servers
List All MCP Servers
curl --request GET \
  --url https://api.gocobalt.io/api/v2/public/mcp-servers \
  --header 'Authorization: <authorization>' \
  --header 'linked_account_id: <linked_account_id>' \
  --header 'x-api-key: <api-key>'
{
    "docs": [
        {
            "_id": "686e12889a52f0683c93b619",
            "name": "MCP CONFIG",
            "description": "This is SOmething",
            "createdAt": "2025-07-09T06:56:08.507Z",
            "updatedAt": "2025-07-09T07:51:08.859Z"
        },
        {
            "_id": "686e231ddc5abb7e41501eae",
            "name": "MCP Server Dhananjay",
            "description": "This is a Dummy MCP Server",
            "createdAt": "2025-07-09T08:06:53.272Z",
            "updatedAt": "2025-07-09T08:06:53.272Z"
        },
        {
            "_id": "686e2393750d509493c6d87c",
            "name": "New Updated Name for MCP",
            "description": "Updated Suggestion",
            "createdAt": "2025-07-09T08:08:51.177Z",
            "updatedAt": "2025-07-09T08:37:19.407Z"
        }
    ],
    "totalDocs": 3,
    "limit": 10,
    "totalPages": 1,
    "page": 1,
    "pagingCounter": 1,
    "hasPrevPage": false,
    "hasNextPage": false,
    "prevPage": null,
    "nextPage": null
}

This API retrieves a paginated list of all MCP servers in your organization.

Request description

This API supports two authentication methods. You can use either Session Token authentication OR the combination of API key and linked account ID.

Authentication Option 1: Session Token

Authorization
string
required

Bearer token using your session token for authentication

Format: Bearer YOUR_SESSION_TOKEN

Authentication Option 2: API Key + Linked Account

x-api-key
string
required

Your Cobalt API key

linked_account_id
string
required

The unique identifier for the linked account

Query Parameters

page
integer
default:"1"

Page number for pagination

limit
integer
default:"10"

Number of records per page (maximum 100)

Response description

docs
array

Array of MCP server objects

totalDocs
integer

Total number of MCP servers

limit
integer

Number of records per page

totalPages
integer

Total number of pages

page
integer

Current page number

pagingCounter
integer

Paging counter

hasPrevPage
boolean

Whether there is a previous page

hasNextPage
boolean

Whether there is a next page

prevPage
integer

Previous page number (null if none)

nextPage
integer

Next page number (null if none)

{
    "docs": [
        {
            "_id": "686e12889a52f0683c93b619",
            "name": "MCP CONFIG",
            "description": "This is SOmething",
            "createdAt": "2025-07-09T06:56:08.507Z",
            "updatedAt": "2025-07-09T07:51:08.859Z"
        },
        {
            "_id": "686e231ddc5abb7e41501eae",
            "name": "MCP Server Dhananjay",
            "description": "This is a Dummy MCP Server",
            "createdAt": "2025-07-09T08:06:53.272Z",
            "updatedAt": "2025-07-09T08:06:53.272Z"
        },
        {
            "_id": "686e2393750d509493c6d87c",
            "name": "New Updated Name for MCP",
            "description": "Updated Suggestion",
            "createdAt": "2025-07-09T08:08:51.177Z",
            "updatedAt": "2025-07-09T08:37:19.407Z"
        }
    ],
    "totalDocs": 3,
    "limit": 10,
    "totalPages": 1,
    "page": 1,
    "pagingCounter": 1,
    "hasPrevPage": false,
    "hasNextPage": false,
    "prevPage": null,
    "nextPage": null
}