Deciders
MCP tools for the Deciders module. See the Deciders module docs for permissions and data model.
list-deciders
List deciders
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (required if not using project key auth) |
limit | number | no | Results 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. |
offset | number | no | Results to skip. Negative or not an integer it is 400 VALIDATION_FAILED. |
create-decider
Create a decider
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (required if not using project key auth) |
name | string | yes | Human-readable name, unique per project |
description | string | null | no | — |
agent_id | string | no | A tool-less agent that answers |
tool_id | string | no | An http or pipeline tool that answers |
questions | array<object> | yes | The questions, in the order the model is shown them. |
version_label | string | no | Optional tag for version 1, e.g. initial |
get-decider
Get a decider
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
decider_id | string | yes | The decider ID |
update-decider
Update a decider
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
decider_id | string | yes | The decider ID |
name | string | no | — |
description | string | null | no | — |
agent_id | string | no | Replaces the backend with this agent |
tool_id | string | no | Replaces the backend with this tool |
questions | array<object> | no | The questions, in the order the model is shown them. |
version_label | string | no | Optional tag for the version this write archives. Ignored when the write changes no question, since no version is archived. |
expected_version | any | no | Refuses the write unless the decider is at this version. |
delete-decider
Delete a decider
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
decider_id | string | yes | The decider ID |
list-decider-versions
List a decider's versions
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
decider_id | string | yes | The decider ID |
limit | number | no | Results 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. |
offset | number | no | Results to skip. Negative or not an integer it is 400 VALIDATION_FAILED. |
get-decider-version
Fetch an archived decider version
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
decider_id | string | yes | The decider ID |
version | number | yes | The archived version number |
restore-decider-version
Restore an archived decider version
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
decider_id | string | yes | The decider ID |
version | number | yes | The archived version number |
label | string | no | Optional tag for the new version. Defaults to restored from vN. |
create-decision
Request a decision
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
decider_id | string | yes | The decider ID |
input | any | yes | What 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. |
metadata | any | no | Caller-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
| Argument | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (required if not using project key auth) |
agent_id | string | no | A tool-less agent that answers |
tool_id | string | no | An http or pipeline tool that answers |
questions | array<object> | yes | The questions, in the order the model is shown them. |
input | any | yes | What 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. |
metadata | any | no | Caller-owned annotations stored on the decision. A non-object is rejected with 400 VALIDATION_FAILED. |
list-decisions
List decisions
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
project_id | string | no | Project ID (required if not using project key auth) |
decider_id | string | no | Only decisions requested from this decider |
status | array<string> | no | Only decisions in these statuses. Repeat the parameter to OR values. A value outside the enum, empty string included, is a 400. |
limit | number | no | Results 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. |
offset | number | no | Results to skip. Negative or not an integer it is 400 VALIDATION_FAILED. |
get-decision
Get a decision
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
decision_id | string | yes | The decision ID |