Skip to main content

Deciders

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

list-deciders​

List deciders

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
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.

create-decider​

Create a decider

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
namestringyesHuman-readable name, unique per project
descriptionstring | nullno—
agent_idstringnoA tool-less agent that answers
tool_idstringnoAn http or pipeline tool that answers
questionsarray<object>yesThe questions, in the order the model is shown them.
version_labelstringnoOptional tag for version 1, e.g. initial

get-decider​

Get a decider

Arguments​

ArgumentTypeRequiredDescription
decider_idstringyesThe decider ID

update-decider​

Update a decider

Arguments​

ArgumentTypeRequiredDescription
decider_idstringyesThe decider ID
namestringno—
descriptionstring | nullno—
agent_idstringnoReplaces the backend with this agent
tool_idstringnoReplaces the backend with this tool
questionsarray<object>noThe questions, in the order the model is shown them.
version_labelstringnoOptional tag for the version this write archives. Ignored when the write changes no question, since no version is archived.
expected_versionanynoRefuses the write unless the decider is at this version.

delete-decider​

Delete a decider

Arguments​

ArgumentTypeRequiredDescription
decider_idstringyesThe decider ID

list-decider-versions​

List a decider's versions

Arguments​

ArgumentTypeRequiredDescription
decider_idstringyesThe decider ID
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-decider-version​

Fetch an archived decider version

Arguments​

ArgumentTypeRequiredDescription
decider_idstringyesThe decider ID
versionnumberyesThe archived version number

restore-decider-version​

Restore an archived decider version

Arguments​

ArgumentTypeRequiredDescription
decider_idstringyesThe decider ID
versionnumberyesThe archived version number
labelstringnoOptional tag for the new version. Defaults to restored from vN.

create-decision​

Request a decision

Arguments​

ArgumentTypeRequiredDescription
decider_idstringyesThe decider ID
inputanyyesWhat is judged, not stored: a string; a list of user messages whose content is a string or input_text and input_image parts (an image as a base64 data URL); or any other JSON value, which an agent is shown as indented JSON. An array of objects carrying role is read as messages.
metadataanynoCaller-owned annotations stored on the decision and returned on every read — typically the id of what was judged, since the input itself is not stored. Written once, with the decision. A non-object is rejected with 400 VALIDATION_FAILED and no decision is written.

create-inline-decision​

Request a decision with inline questions

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
agent_idstringnoA tool-less agent that answers
tool_idstringnoAn http or pipeline tool that answers
questionsarray<object>yesThe questions, in the order the model is shown them.
inputanyyesWhat is judged, not stored: a string; a list of user messages whose content is a string or input_text and input_image parts (an image as a base64 data URL); or any other JSON value, which an agent is shown as indented JSON. An array of objects carrying role is read as messages.
metadataanynoCaller-owned annotations stored on the decision. A non-object is rejected with 400 VALIDATION_FAILED.

list-decisions​

List decisions

Arguments​

ArgumentTypeRequiredDescription
project_idstringnoProject ID (required if not using project key auth)
decider_idstringnoOnly decisions requested from this decider
statusarray<string>noOnly decisions in these statuses. Repeat the parameter to OR values. A value outside the enum, empty string included, is a 400.
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-decision​

Get a decision

Arguments​

ArgumentTypeRequiredDescription
decision_idstringyesThe decision ID