Update MCP Server

curl --request PUT \
  --url https://api.app.shinzo.ai/v1/mcp/servers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "url": "<string>",
  "headers": {},
  "status": "<string>",
  "configuration": {}
}
'

PUT

mcp

servers

{id}

Update MCP Server

curl --request PUT \
  --url https://api.app.shinzo.ai/v1/mcp/servers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "url": "<string>",
  "headers": {},
  "status": "<string>",
  "configuration": {}
}
'

Authentication

Requires JWT token or Platform API key via Authorization: Bearer <token> header.

string

required

MCP server UUID

string

Server name (1-100 characters)

string

Description (max 500 characters)

string

Endpoint URL

object

HTTP headers (stored encrypted)

string

Server status: active or inactive

object

Additional configuration options

Example Request

curl -X PUT https://api.app.shinzo.ai/v1/mcp/servers/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated GitHub MCP Server",
    "status": "inactive"
  }'

Example Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "github-mcp",
  "description": "Updated GitHub MCP Server",
  "endpoint_url": "https://mcp.github.com/sse",
  "transport_type": "http",
  "hosting_mode": "remote",
  "status": "inactive",
  "health_status": "healthy",
  "created_at": "2026-01-10T08:00:00Z",
  "updated_at": "2026-01-15T14:30:00Z"
}

Status Codes

Code	Description
`200`	MCP server updated successfully
`400`	Invalid request (validation error)
`401`	Unauthorized - invalid or missing authentication
`404`	MCP server not found
`409`	Server with that name already exists

Overview

Authentication

AI Agents

Agent Messaging

Agent Schedules & Triggers

Agent Channels

Agent Filesystem

MCP Servers

Spotlight

Tokens

Provider Keys

Telemetry

Update MCP Server

Authentication

Example Request

Example Response

Status Codes

​Authentication

​Example Request

​Example Response

​Status Codes

Authentication

Example Request

Example Response

Status Codes