Skip to main content
POST
/
v1
/
mcp
/
servers
Create MCP Server
curl --request POST \
  --url https://api.app.shinzo.ai/v1/mcp/servers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "transport_type": "<string>",
  "url": "<string>",
  "headers": {},
  "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.
​
name
string
required
Server name (1-100 characters)
​
description
string
Description of the server (max 500 characters)
​
transport_type
string
Transport type (use "http")
​
url
string
required
Endpoint URL for the MCP server
​
headers
object
HTTP headers, such as authentication headers (stored encrypted)
​
configuration
object
Additional configuration options
Sensitive values in headers are encrypted at rest. They are never returned in API responses after creation.

​
Example Request

curl -X POST https://api.app.shinzo.ai/v1/mcp/servers \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "github-mcp",
    "description": "GitHub MCP Server",
    "transport_type": "http",
    "url": "https://mcp.github.com/sse",
    "headers": {
      "Authorization": "Bearer ghp_xxxxxxxxxxxx"
    }
  }'

​
Example Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "github-mcp",
  "description": "GitHub MCP Server",
  "endpoint_url": "https://mcp.github.com/sse",
  "transport_type": "http",
  "hosting_mode": "remote",
  "status": "active",
  "health_status": "unknown",
  "created_at": "2026-01-15T10:00:00Z",
  "updated_at": "2026-01-15T10:00:00Z"
}

​
Status Codes

CodeDescription
201MCP server created successfully
400Invalid request (validation error)
401Unauthorized - invalid or missing authentication
409Server with that name already exists