Skip to main content

Guardrails

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

create-guardrail

Create a guardrail

Arguments

ArgumentTypeRequiredDescription
project_idstringnoPublic ID of the project
namestringyesHuman-readable name
descriptionstring | nullno
documentobjectyesThe action-class document. class maps a call to an action class; guard gates class-B autonomy. Both are single JSON Logic expressions over the args.* / context.* / runtime.* namespaces.
context_tool_idstring | nullno
context_modestringno
version_labelstringnoOptional tag for the config version this write archives (e.g. initial). Annotates the version only — it is not stored on the guardrail and is not part of the config, so labelling a change is never itself a change.

list-guardrails

List guardrails

Arguments

ArgumentTypeRequiredDescription
project_idstringnoProject public ID to filter by
limitnumbernoMaximum number of results to return
offsetnumbernoNumber of results to skip

get-guardrail

Get a guardrail

Arguments

ArgumentTypeRequiredDescription
guardrail_idstringyes

update-guardrail

Update a guardrail

Arguments

ArgumentTypeRequiredDescription
guardrail_idstringyes
namestringno
descriptionstring | nullno
documentobjectnoThe action-class document. class maps a call to an action class; guard gates class-B autonomy. Both are single JSON Logic expressions over the args.* / context.* / runtime.* namespaces.
context_tool_idstring | nullno
context_modestring | nullno
version_labelstringnoOptional tag for the config version this write archives (e.g. pre-tightening). Annotates the version only — it is not stored on the guardrail and is not part of the config, so labelling a change is never itself a change. Ignored when the write changes no policy, since no version is created.

delete-guardrail

Delete a guardrail

Arguments

ArgumentTypeRequiredDescription
guardrail_idstringyes

list-guardrail-versions

List a guardrail's config versions

Arguments

ArgumentTypeRequiredDescription
guardrail_idstringyes
limitnumbernoMaximum number of results to return
offsetnumbernoNumber of results to skip

get-guardrail-version

Fetch an archived guardrail version

Arguments

ArgumentTypeRequiredDescription
guardrail_idstringyes
versionnumberyes

restore-guardrail-version

Restore an archived guardrail config

Arguments

ArgumentTypeRequiredDescription
guardrail_idstringyes
versionnumberyes
labelstringnoOptional tag for the version the restore creates. Defaults to restored from v<version>.

evaluate-guardrail

Dry-run evaluate a guardrail

Arguments

ArgumentTypeRequiredDescription
guardrail_idstringyes
argsobjectnoThe proposed call's arguments (the args.* namespace).
guardrail_contextobjectnoThe caller-supplied guardrail context (the context.* namespace), combined with the context tool per context_mode.
tool_idstringnoOptional tool to resolve runtime.tool.* against.