federation_act
Invoke any served tool through the root surface, for clients that only call tools in their own tools/list (CO 525, CO 529). BRANCHED platform tools: tenant_id + tool + arguments; names from federation_enter_tenant's platform_tools, schemas from federation_help {"tenant_id":"","tool_defs":""}. UNLISTED root tools: tool + arguments, no tenant_id; names + schemas from federation_help {"tool_defs":"all"}. Authorization is decided per inner tool exactly as a direct call: scope, tenant ownership and pricing apply unchanged — reach, never authority. Refusals: act_recursion, tenant_id_required, tenant_id_not_applicable, unknown_tool. For reads, prefer federation_read: clients can allow it once. Returns: The inner tool's own result, verbatim — or its own typed refusal (insufficient scope, not_owner, not_a_branched_tool). Example: call federation_act with arguments {"tenant_id":"<tenant_id>","tool":""}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tool": "<tool>"
},
"name": "federation_act"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tool | Yes | A branched platform tool (e.g. 'booking_status') or an unlisted root tool; names and schemas from federation_help with tool_defs. | |
| arguments | No | The inner tool's own arguments, exactly as its schema defines them. | |
| tenant_id | No | REQUIRED for a branched platform tool: the tenant that serves it (from federation_enter_tenant). OMIT for a root tool. |