`get_org_admin_by_orgid`

Read-only

Calls GET /api/org-admin/{orgId} as the signed-in person · REST reference

What an organization can grant, and what the caller holds there

With the caller's own token; requires org.view in the organization (every member holds it) or platform authority. heldFeatures is what the portal gates on.

Arguments

Argument	Type		Description
`orgId`path	string (uuid)	required

Example call

A client sends this over the MCP session; Claude and other agents build it for you. The values are placeholders — the shape is real.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_org_admin_by_orgid",
    "arguments": {
      "orgId": "11111111-1111-4111-8111-111111111111"
    }
  }
}

Result

On success (HTTP 200) the tool returns one text item holding the API's JSON, pretty-printed.

The organization's administration view.

json

{
  "data": {
    "heldFeatures": [
      "string"
    ],
    "orgId": "11111111-1111-4111-8111-111111111111",
    "orgName": "string",
    "permissions": [
      {}
    ],
    "orgType": "string"
  },
  "success": true
}

Fields

Field	Type	Description
`data`	object
`data.heldFeatures`	array of string	The catalog features the CALLER holds in this organization — what they may do here, and the most they may delegate. Gate the UI on these, never on a role name.
`data.orgId`	string (uuid)
`data.orgName`	string
`data.orgType`	string \| null
`data.permissions`	array of object	Everything the organization can grant, in catalog order.
`data.permissions[].category`	string
`data.permissions[].description`	string
`data.permissions[].feature`	string	The catalog feature id, e.g. hospital.vouchers.redeem
`data.permissions[].id`	string (uuid)
`data.permissions[].name`	string
`data.permissions[].orgId`	string (uuid)
`data.permissions[].riskLevel`	"LOW" \| "MEDIUM" \| "HIGH" \| "CRITICAL"
`success`	true

When it fails

A failed call returns isError: true with the API's message as text.

400: The request was malformed or failed a guard.
403: Authenticated, but the caller holds none of the required permissions.
404: No such resource — or none this caller may see.

What the model is shown

This is the tool exactly as the server lists it in tools/list. The description starts with the REST call it makes.

json

{
  "name": "get_org_admin_by_orgid",
  "description": "GET /api/org-admin/{orgId} — With the caller's own token; requires `org.view` in the organization (every member holds it) or platform authority. `heldFeatures` is what the portal gates on.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "orgId": {
        "type": "string"
      }
    },
    "required": [
      "orgId"
    ]
  },
  "annotations": {
    "readOnlyHint": true,
    "openWorldHint": false
  }
}