Get MCP Server

Retrieve detailed information about a specific MCP server.

GET /v1/mcp/servers/{id}

Get MCP Server

cURL

curl --request GET \
  --url https://api.app.shinzo.ai/v1/mcp/servers/{id} \
  --header 'Authorization: Bearer <token>'

Authentication

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

id · string · required

MCP server UUID

Example Request

curl -X GET https://api.app.shinzo.ai/v1/mcp/servers/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer <token>"

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": "healthy",
  "last_health_check": "2026-01-15T09:00:00Z",
  "configuration": {},
  "created_at": "2026-01-10T08:00:00Z",
  "updated_at": "2026-01-12T09:15:00Z",
  "agent_access": [
    {
      "id": "grant-uuid-1",
      "agent": {
        "uuid": "agt-uuid-1",
        "name": "code-review-agent",
        "status": "active"
      },
      "access_mode": "all",
      "allowed_tools": null,
      "enabled": true
    },
    {
      "id": "grant-uuid-2",
      "agent": {
        "uuid": "agt-uuid-2",
        "name": "data-agent",
        "status": "paused"
      },
      "access_mode": "selected",
      "allowed_tools": ["create_issue", "list_issues"],
      "enabled": true
    }
  ]
}

Status Codes

Code	Description
200	Success
401	Unauthorized - invalid or missing authentication
404	MCP server not found