PUT
/
api
/
v2
/
public
/
mcp-servers
/
:mcp_server_id
curl -X PUT "https://api.gocobalt.io/api/v2/public/mcp-servers/686e2393750d509493c6d87c" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Enterprise MCP Server",
    "description": "Updated MCP server configuration for enterprise customers",
    "suggestions": [
        {
            "name": "Customer Onboarding",
            "prompt": "Create a new customer account with complete profile setup"
        }
    ],
    "chains": [
        {
            "name": "Lead Processing Chain",
            "goals": "Qualify and process incoming leads through CRM workflow",
            "steps": "Step 1: Validate lead data\nStep 2: Create contact in CRM\nStep 3: Assign to sales representative",
            "precheck": "Verify required fields are present",
            "successCondition": "Lead successfully created and assigned",
            "responseFormat": "JSON with contact ID and assignment details",
            "onError": "Log error and retry with manual intervention"
        }
    ],
    "associated_apps": [
        {
            "slug": "hubspot",
            "workflows": [
                {
                    "id": "67fbc1e4954bde0dcae1d51c",
                    "name": "Contact Sync Workflow",
                    "description": "Synchronize contacts between systems"
                }
            ],
            "actions": [
                {
                    "id": "create_contact",
                    "name": "Create Contact",
                    "description": "Create a new contact in HubSpot"
                }
            ]
        }
    ]
  }'
{
    "_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",
    "__v": 0,
    "chains": [
        {
            "name": "STep 1 ",
            "goals": "This shoud. be Goal",
            "steps": "Step 1 \nStep 2 \nStep 3",
            "precheck": "",
            "successCondition": "",
            "responseFormat": "",
            "onError": "",
            "_id": "686e2a3f7e7cb9099d06ca40"
        }
    ]
}
This API allows you to update an existing MCP server with new configurations, suggestions, chains, and associated applications.

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

Body Parameters

name
string
Name of the MCP server
description
string
Description of the MCP server
suggestions
array
Array of suggestion objects for the MCP server
chains
array
Array of chain objects to configure for the MCP server
associated_apps
array
Array of applications to associate with 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
__v
integer
Version 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",
    "__v": 0,
    "chains": [
        {
            "name": "STep 1 ",
            "goals": "This shoud. be Goal",
            "steps": "Step 1 \nStep 2 \nStep 3",
            "precheck": "",
            "successCondition": "",
            "responseFormat": "",
            "onError": "",
            "_id": "686e2a3f7e7cb9099d06ca40"
        }
    ]
}
curl -X PUT "https://api.gocobalt.io/api/v2/public/mcp-servers/686e2393750d509493c6d87c" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Enterprise MCP Server",
    "description": "Updated MCP server configuration for enterprise customers",
    "suggestions": [
        {
            "name": "Customer Onboarding",
            "prompt": "Create a new customer account with complete profile setup"
        }
    ],
    "chains": [
        {
            "name": "Lead Processing Chain",
            "goals": "Qualify and process incoming leads through CRM workflow",
            "steps": "Step 1: Validate lead data\nStep 2: Create contact in CRM\nStep 3: Assign to sales representative",
            "precheck": "Verify required fields are present",
            "successCondition": "Lead successfully created and assigned",
            "responseFormat": "JSON with contact ID and assignment details",
            "onError": "Log error and retry with manual intervention"
        }
    ],
    "associated_apps": [
        {
            "slug": "hubspot",
            "workflows": [
                {
                    "id": "67fbc1e4954bde0dcae1d51c",
                    "name": "Contact Sync Workflow",
                    "description": "Synchronize contacts between systems"
                }
            ],
            "actions": [
                {
                    "id": "create_contact",
                    "name": "Create Contact",
                    "description": "Create a new contact in HubSpot"
                }
            ]
        }
    ]
  }'