Skip to main content
PUT
/
v1
/
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": {}
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.shinzo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Requires JWT token or Platform API key via Authorization: Bearer <token> header.
​
id
string
required
MCP server UUID
​
name
string
Server name (1-100 characters)
​
description
string
Description (max 500 characters)
​
url
string
Endpoint URL
​
headers
object
HTTP headers (stored encrypted)
​
status
string
Server status: active or inactive
​
configuration
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

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