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 authenticationFormat: 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
}