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
Bearer token using your session token for authenticationFormat: Bearer YOUR_SESSION_TOKEN
Authentication Option 2: API Key + Linked Account
The unique identifier for the linked account
Path Parameters
Unique identifier for the MCP server to update
Body Parameters
Description of the MCP server
Array of suggestion objects for the MCP server
Prompt text for the suggestion
Array of chain objects to configure for the MCP server
Goals for the chain execution
Steps to execute in the chain (newline separated)
Success condition for the chain
Response format configuration
Error handling configuration
Array of applications to associate with the MCP serverShow Associated App Object
Application identifier slug
Array of workflow objects
Response description
Unique identifier for the MCP server
Description of the MCP server
Organization ID associated with the MCP server
Environment (test/production) where the MCP server is running
Array of suggestion objects for the MCP server
Array of applications associated with the MCP server
Array of chain objects configured for the MCP server
Array of resources associated with the MCP server
{
"_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"
}
]
}
]
}'