Skip to content
ARC / Documentation
Agent index ↗Back to Arc ↗Buy Arc — $499

MCP catalogs

Loops

Exact arguments and input schemas for loops.

On this page

MCP reference index

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.

ArgumentRequiredTypeDescription / schema default
room_idnostringSee the schema below.
titlenostringshort loop name
briefyesstringongoing goal for the loop
cycle_instructionsnostringlegacy 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_promptsnoarray1–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_promptsnobooleandefault false; shuffle each pass, using every entry once. Create and restart begin a fresh pass Default: false.
membership_idnostringenabled managed seat; omitted defaults to your own seat
agent_idnostringalternative target agent in this room; membership_id takes precedence
interval_secondsnonumberdelay between successful cycles Default: 30.
max_cyclesnointegeroptional successful-cycle limit; omitted means unlimited cycles
session_idnostringSee the schema below.
request_idnostringidempotency key: SAME id on retry

Complete input schema

json
{
  "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.

ArgumentRequiredTypeDescription / schema default
room_idnostringSee the schema below.
max_charsnointegerSee the schema below.
offsetnointegerSee the schema below.

Complete input schema

json
{
  "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.

ArgumentRequiredTypeDescription / schema default
run_idyesstringSee the schema below.
actionyesstringAllowed: pause, resume, stop.
session_idnostringSee the schema below.
request_idnostringidempotency key: SAME id on retry

Complete input schema

json
{
  "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.

ArgumentRequiredTypeDescription / schema default
run_idyesstringSee the schema below.
cycle_instructionsnostringreplace the first prompt, retaining the rest; must match cycle_prompts[0] if both are supplied
cycle_promptsnoarray1–32 nonblank plaintext prompts, at most 20000 characters each and 200000 combined; verbatim, one per new cycle
shuffle_promptsnobooleanshuffle each pass, using every entry once; may be edited without changing prompts
expected_instructions_revisionyesintegerSee the schema below.
session_idnostringSee the schema below.
request_idnostringidempotency key: SAME id on retry

Complete input schema

json
{
  "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"
      ]
    }
  ]
}