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