Skip to main content

IAM

MCP tools for the IAM module. See the IAM module docs for permissions and data model.

check-iam-permission​

Check a permission of the calling credential

Arguments​

ArgumentTypeRequiredDescription
actionstringyesA module:Operation action the deployment registered or a built-in one (agents:DeleteAgent); an unknown action or a wildcard is 400.
resourcestringyessrn:<project_id>:<resource_type>:<id>, where the type is one the action's module registered, or for a built-in action one its module's routes check it on, and <id> may be * for an action on no single resource (a create or a list). A projects:* action is checked on the whole project, srn:<project_id>:*:*, which takes no context.tags.
contextobjectnoWhat the conditions of a policy statement read.

create-iam-token​

Issue an IAM token

Arguments​

ArgumentTypeRequiredDescription
policyobjectnoAn inline policy document, validated as POST /api/v1/policies validates one (400 IAM_TOKEN_POLICY_INVALID otherwise). Work the token starts holds this snapshot.
policy_idsarray<string>noPolicies of the key's project or global ones, read as they stand at each request. An unknown id is 400 IAM_TOKEN_POLICY_INVALID.
principalobjectnoA principal of the caller's own, opaque to the runtime.
tool_contextobjectnoA tool_context layer the token pins: on every tool call the token makes, and every call its work starts (generations, nested builtin and soat calls, call-tool relays), a caller key the layer names is dropped in any casing and the layer's value is sent instead. Admission sees the caller's own bag. Keys follow the tool_context key grammar and may not be a server identity key (INVALID_TOOL_CONTEXT_KEY). A key under the deployment's reserved prefix (SOAT_RESERVED_TOOL_CONTEXT_PREFIX) needs iam:PinReservedToolContext on srn:<project_id>:iam_token:*, else 400 INVALID_TOOL_CONTEXT_KEY.
ttl_secondsnumbernoSeconds until the token expires.

revoke-iam-principal​

Revoke a principal

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoThe project to revoke it in; defaults to the calling credential's project.
principalobjectyesA principal of the caller's own, opaque to the runtime.