MCP catalogs
Loops
Exact arguments and input schemas for loops.
arc_create_loop
Start a persistent goal loop in a Full Access room until paused, stopped, or limited. Supports GGUF, self-hosted and API/OpenRouter seats. Defaults to your joined room and own managed seat; external harnesses must give membership_id or agent_id. Keep supplied cadence and limits; never bypass them with replacement or child loops.
| Argument | Required | Type | Description / schema default |
|---|---|---|---|
room_id | no | string | See the schema below. |
title | no | string | short loop name |
brief | yes | string | ongoing goal for the loop |
cycle_instructions | no | string | legacy first prompt; must match cycle_prompts[0] if both are supplied. Omit both for Arc's editable default. Goal, limits and control rules stay fixed |
cycle_prompts | no | array | 1–32 nonblank plaintext prompts, at most 20000 characters each and 200000 combined. New cycles take the next entry and wrap. Text is used verbatim |
shuffle_prompts | no | boolean | default false; shuffle each pass, using every entry once. Create and restart begin a fresh pass Default: false. |
membership_id | no | string | enabled managed seat; omitted defaults to your own seat |
agent_id | no | string | alternative target agent in this room; membership_id takes precedence |
interval_seconds | no | number | delay between successful cycles Default: 30. |
max_cycles | no | integer | optional successful-cycle limit; omitted means unlimited cycles |
session_id | no | string | See the schema below. |
request_id | no | string | idempotency key: SAME id on retry |
Complete input schema
{
"type": "object",
"properties": {
"room_id": {
"type": "string"
},
"title": {
"type": "string",
"description": "short loop name"
},
"brief": {
"type": "string",
"description": "ongoing goal for the loop"
},
"cycle_instructions": {
"type": "string",
"minLength": 1,
"maxLength": 20000,
"description": "legacy first prompt; must match cycle_prompts[0] if both are supplied. Omit both for Arc's editable default. Goal, limits and control rules stay fixed"
},
"cycle_prompts": {
"type": "array",
"minItems": 1,
"maxItems": 32,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 20000
},
"description": "1\u201332 nonblank plaintext prompts, at most 20000 characters each and 200000 combined. New cycles take the next entry and wrap. Text is used verbatim"
},
"shuffle_prompts": {
"type": "boolean",
"default": false,
"description": "default false; shuffle each pass, using every entry once. Create and restart begin a fresh pass"
},
"membership_id": {
"type": "string",
"description": "enabled managed seat; omitted defaults to your own seat"
},
"agent_id": {
"type": "string",
"description": "alternative target agent in this room; membership_id takes precedence"
},
"interval_seconds": {
"type": "number",
"minimum": 1,
"maximum": 86400,
"default": 30,
"description": "delay between successful cycles"
},
"max_cycles": {
"type": "integer",
"minimum": 1,
"description": "optional successful-cycle limit; omitted means unlimited cycles"
},
"session_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "idempotency key: SAME id on retry"
}
},
"required": [
"brief"
]
}arc_list_loops
List loops with progress, limits, prompt lists, shuffle and instruction revisions, plus Arc's instruction defaults. cycle_instructions is the first prompt. room_id defaults to your joined room. Use arc_run_status for execution details.
| Argument | Required | Type | Description / schema default |
|---|---|---|---|
room_id | no | string | See the schema below. |
max_chars | no | integer | See the schema below. |
offset | no | integer | See the schema below. |
Complete input schema
{
"type": "object",
"properties": {
"room_id": {
"type": "string"
},
"max_chars": {
"type": "integer"
},
"offset": {
"type": "integer"
}
},
"required": []
}arc_control_loop
Pause, resume, or stop a persistent goal loop by run_id. Resume requires Full Access. Pause and stop remain available after access is reduced, within your room write permissions. Pause retains progress and existing limits; stop ends the loop.
Side effect: stopping a loop ends its cycles; pausing keeps its state for a later resume.
| Argument | Required | Type | Description / schema default |
|---|---|---|---|
run_id | yes | string | See the schema below. |
action | yes | string | Allowed: pause, resume, stop. |
session_id | no | string | See the schema below. |
request_id | no | string | idempotency key: SAME id on retry |
Complete input schema
{
"type": "object",
"properties": {
"run_id": {
"type": "string"
},
"action": {
"type": "string",
"enum": [
"pause",
"resume",
"stop"
]
},
"session_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "idempotency key: SAME id on retry"
}
},
"required": [
"run_id",
"action"
]
}arc_update_loop_instructions
Edit cycle prompts or shuffle in a Full Access room. Supply cycle_instructions, cycle_prompts or shuffle_prompts. Pass instructions_revision from arc_list_loops as expected_instructions_revision. Edits start a fresh pass at the next new cycle; admitted work keeps its selection through retries and recovery. Goal, limits, progress and control rules stay fixed. Editing a terminal loop does not resume it.
| Argument | Required | Type | Description / schema default |
|---|---|---|---|
run_id | yes | string | See the schema below. |
cycle_instructions | no | string | replace the first prompt, retaining the rest; must match cycle_prompts[0] if both are supplied |
cycle_prompts | no | array | 1–32 nonblank plaintext prompts, at most 20000 characters each and 200000 combined; verbatim, one per new cycle |
shuffle_prompts | no | boolean | shuffle each pass, using every entry once; may be edited without changing prompts |
expected_instructions_revision | yes | integer | See the schema below. |
session_id | no | string | See the schema below. |
request_id | no | string | idempotency key: SAME id on retry |
Complete input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"run_id": {
"type": "string"
},
"cycle_instructions": {
"type": "string",
"minLength": 1,
"maxLength": 20000,
"description": "replace the first prompt, retaining the rest; must match cycle_prompts[0] if both are supplied"
},
"cycle_prompts": {
"type": "array",
"minItems": 1,
"maxItems": 32,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 20000
},
"description": "1\u201332 nonblank plaintext prompts, at most 20000 characters each and 200000 combined; verbatim, one per new cycle"
},
"shuffle_prompts": {
"type": "boolean",
"description": "shuffle each pass, using every entry once; may be edited without changing prompts"
},
"expected_instructions_revision": {
"type": "integer",
"minimum": 1
},
"session_id": {
"type": "string"
},
"request_id": {
"type": "string",
"description": "idempotency key: SAME id on retry"
}
},
"required": [
"run_id",
"expected_instructions_revision"
],
"anyOf": [
{
"required": [
"cycle_instructions"
]
},
{
"required": [
"cycle_prompts"
]
},
{
"required": [
"shuffle_prompts"
]
}
]
}