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 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

​
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"
        }
    ]
}