API & DEVELOPERS

MCP reference · v1

list_workspaces

List only companies assigned to this verified identity.

Read operation

Company permissions

Required scopes: orchesphere.read. Current identity, company and service/portal rights are checked for every call. Scopes do not create access.

Current active company assignments; verified global authority may see all company workspaces. Equivalent REST operation.

Input schema

No input fields are required.

Complete MCP input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Tool call

json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_workspaces",
    "arguments": {}
  }
}

POST to https://orchesphere.ai/mcp with a Bearer token approved for the MCP resource. Initialize the connection first. Examples use fictional identifiers.

Response handling

A successful tool result includes text content and structuredContent. Inspect isError before treating a tool result as successful. Authentication and scope failures may use HTTP 401/403 with WWW-Authenticate. This tool does not publish a separate MCP output schema; use its returned structure rather than assuming a provider business-record response.

All MCP tools · Errors and retry guidance