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