Skip to main content
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

  • 200
  • Error
​
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
}