GET
/
api
/
v2
/
public
/
mcp-servers
/
:mcp_server_id
Get MCP Server by ID
curl --request GET \
  --url https://api.gocobalt.io/api/v2/public/mcp-servers/:mcp_server_id \
  --header 'Authorization: <authorization>' \
  --header 'linked_account_id: <linked_account_id>' \
  --header 'x-api-key: <api-key>'
{
    "_id": "686e2393750d509493c6d87c",
    "name": "New Updated Name for MCP",
    "description": "Updated Suggestion",
    "associated_org_id": "6698b77a733c5ebd8908189e",
    "environment": "test",
    "suggestions": [
        {
            "name": "Hello",
            "prompt": "Prompt Test1"
        }
    ],
    "associated_apps": [
        {
            "slug": "pipedrive",
            "workflows": [
                {
                    "id": "67fbc1e4954bde0dcae1d51c",
                    "name": "SETUP WRITEBACK",
                    "description": "Setup Writeback on Application"
                }
            ],
            "actions": [
                {
                    "id": "delete_lead",
                    "name": "Delete Lead",
                    "description": "To delete a lead"
                }
            ]
        }
    ],
    "resources": [],
    "createdAt": "2025-07-09T08:08:51.177Z",
    "updatedAt": "2025-07-09T08:37:19.407Z",
    "chains": [
        {
            "name": "STep 1 ",
            "goals": "This shoud. be Goal",
            "steps": "Step 1 \nStep 2 \nStep 3",
            "precheck": "",
            "successCondition": "",
            "responseFormat": "",
            "onError": "",
            "_id": "686e2a3f7e7cb9099d06ca40"
        }
    ]
}
This API retrieves detailed information about a specific MCP server using its unique identifier.

​
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

​
Path Parameters

​
mcp_server_id
string
required
Unique identifier for the MCP server

​
Response description

​
_id
string
Unique identifier for the MCP server
​
name
string
Name of the MCP server
​
description
string
Description of the MCP server
​
associated_org_id
string
Organization ID associated with the MCP server
​
environment
string
Environment (test/production) where the MCP server is running
​
suggestions
array
Array of suggestion objects for the MCP server
​
associated_apps
array
Array of applications associated with the MCP server
​
chains
array
Array of chain objects configured for the MCP server
​
resources
array
Array of resources associated with the MCP server
​
createdAt
date
Creation timestamp
​
updatedAt
date
Last update timestamp
{
    "_id": "686e2393750d509493c6d87c",
    "name": "New Updated Name for MCP",
    "description": "Updated Suggestion",
    "associated_org_id": "6698b77a733c5ebd8908189e",
    "environment": "test",
    "suggestions": [
        {
            "name": "Hello",
            "prompt": "Prompt Test1"
        }
    ],
    "associated_apps": [
        {
            "slug": "pipedrive",
            "workflows": [
                {
                    "id": "67fbc1e4954bde0dcae1d51c",
                    "name": "SETUP WRITEBACK",
                    "description": "Setup Writeback on Application"
                }
            ],
            "actions": [
                {
                    "id": "delete_lead",
                    "name": "Delete Lead",
                    "description": "To delete a lead"
                }
            ]
        }
    ],
    "resources": [],
    "createdAt": "2025-07-09T08:08:51.177Z",
    "updatedAt": "2025-07-09T08:37:19.407Z",
    "chains": [
        {
            "name": "STep 1 ",
            "goals": "This shoud. be Goal",
            "steps": "Step 1 \nStep 2 \nStep 3",
            "precheck": "",
            "successCondition": "",
            "responseFormat": "",
            "onError": "",
            "_id": "686e2a3f7e7cb9099d06ca40"
        }
    ]
}