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
}