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
limitnumbernoResults per page. Above the maximum it is clamped, and limit in the response reports the page served; below 1 or not an integer it is 400 VALIDATION_FAILED.
offsetnumbernoResults to skip. Negative or not an integer it is 400 VALIDATION_FAILED.

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.
expected_versionanynoRefuses the write unless the resource is at this version.

delete-guardrail​

Delete a guardrail

Arguments​

ArgumentTypeRequiredDescription
guardrail_idstringyes—

list-guardrail-versions​

List a guardrail's config versions

Arguments​

ArgumentTypeRequiredDescription
guardrail_idstringyes—
limitnumbernoResults per page. Above the maximum it is clamped, and limit in the response reports the page served; below 1 or not an integer it is 400 VALIDATION_FAILED.
offsetnumbernoResults to skip. Negative or not an integer it is 400 VALIDATION_FAILED.

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.tools.* against.