MCP tools

Generated from OpenRig 0.5.14 (cc75efdd), commit cc75efdd17fb967bde7cff6c5805791986af78d8.

Discovered through MCP tools/list; no tools were invoked. Required inputs are marked below. JSON schemas are retained in full for nested constraints.

rig_up

Bootstrap a rig from a spec or bundle

Input	Type	Required	Description
sourceRef	"string"	yes	Path to .yaml rig spec or .rigbundle
plan	"boolean"	no	Plan mode — preview without executing
autoApprove	"boolean"	no	Auto-approve trusted actions
targetRoot	"string"	no	Target root directory for package installation

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "sourceRef": {
      "type": "string",
      "description": "Path to .yaml rig spec or .rigbundle"
    },
    "plan": {
      "description": "Plan mode — preview without executing",
      "type": "boolean"
    },
    "autoApprove": {
      "description": "Auto-approve trusted actions",
      "type": "boolean"
    },
    "targetRoot": {
      "description": "Target root directory for package installation",
      "type": "string"
    }
  },
  "required": [\
    "sourceRef"\
  ]
}

rig_down

Tear down a rig

Input	Type	Required	Description
rigId	"string"	yes	Rig identifier to tear down
delete	"boolean"	no	Delete rig record after stopping
force	"boolean"	no	Kill sessions immediately
snapshot	"boolean"	no	Take snapshot before teardown

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "rigId": {
      "type": "string",
      "description": "Rig identifier to tear down"
    },
    "delete": {
      "description": "Delete rig record after stopping",
      "type": "boolean"
    },
    "force": {
      "description": "Kill sessions immediately",
      "type": "boolean"
    },
    "snapshot": {
      "description": "Take snapshot before teardown",
      "type": "boolean"
    }
  },
  "required": [\
    "rigId"\
  ]
}

rig_ps

List rigs and their status

Input	Type	Required	Description

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

rig_status

Check daemon health

Input	Type	Required	Description

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

rig_snapshot_create

Create a snapshot for a rig

Input	Type	Required	Description
rigId	"string"	yes	Rig identifier

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "rigId": {
      "type": "string",
      "description": "Rig identifier"
    }
  },
  "required": [\
    "rigId"\
  ]
}

rig_snapshot_list

List snapshots for a rig

Input	Type	Required	Description
rigId	"string"	yes	Rig identifier

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "rigId": {
      "type": "string",
      "description": "Rig identifier"
    }
  },
  "required": [\
    "rigId"\
  ]
}

rig_restore

Restore a rig from a snapshot

Input	Type	Required	Description
rigId	"string"	yes	Rig identifier
snapshotId	"string"	yes	Snapshot identifier

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "rigId": {
      "type": "string",
      "description": "Rig identifier"
    },
    "snapshotId": {
      "type": "string",
      "description": "Snapshot identifier"
    }
  },
  "required": [\
    "rigId",\
    "snapshotId"\
  ]
}

rig_discover

Scan for tmux sessions to discover

Input	Type	Required	Description

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}

rig_bind

Bind a discovered session to an existing node or create a new node in a pod

Input	Type	Required	Description
discoveryId	"string"	yes	Discovery session identifier
rigId	"string"	yes	Target rig identifier
logicalId	"string"	no	Existing node logical ID (mode: bind to existing)
podNamespace	"string"	no	Pod namespace to create node in (mode: create in pod)
memberName	"string"	no	Member name for new node (required with podNamespace)

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "discoveryId": {
      "type": "string",
      "description": "Discovery session identifier"
    },
    "rigId": {
      "type": "string",
      "description": "Target rig identifier"
    },
    "logicalId": {
      "description": "Existing node logical ID (mode: bind to existing)",
      "type": "string"
    },
    "podNamespace": {
      "description": "Pod namespace to create node in (mode: create in pod)",
      "type": "string"
    },
    "memberName": {
      "description": "Member name for new node (required with podNamespace)",
      "type": "string"
    }
  },
  "required": [\
    "discoveryId",\
    "rigId"\
  ]
}

rig_bundle_inspect

Inspect a .rigbundle file

Input	Type	Required	Description
bundlePath	"string"	yes	Path to .rigbundle file

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "bundlePath": {
      "type": "string",
      "description": "Path to .rigbundle file"
    }
  },
  "required": [\
    "bundlePath"\
  ]
}

rig_agent_validate

Validate an AgentSpec (agent.yaml) from YAML text

Input	Type	Required	Description
yaml	"string"	yes	YAML text of the agent spec

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "yaml": {
      "type": "string",
      "description": "YAML text of the agent spec"
    }
  },
  "required": [\
    "yaml"\
  ]
}

rig_rig_validate

Validate a RigSpec (rig.yaml) from YAML text

Input	Type	Required	Description
yaml	"string"	yes	YAML text of the rig spec

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "yaml": {
      "type": "string",
      "description": "YAML text of the rig spec"
    }
  },
  "required": [\
    "yaml"\
  ]
}

rig_rig_nodes

Get node inventory for a rig — session names, status, attach commands, resume commands

Input	Type	Required	Description
rigId	"string"	yes	Rig identifier

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "rigId": {
      "type": "string",
      "description": "Rig identifier"
    }
  },
  "required": [\
    "rigId"\
  ]
}

rig_send

Send a message to an agent's terminal using reliable two-step send

Input	Type	Required	Description
session	"string"	yes	Target session name (e.g. example-seat@example)
text	"string"	yes	Message text to send
verify	"boolean"	no	Verify delivery by checking pane content
force	"boolean"	no	Send even if target appears mid-task
waitForIdleSeconds	"number"	no	Wait until explicit idle evidence before sending

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "description": "Target session name (e.g. example-seat@example)"
    },
    "text": {
      "type": "string",
      "description": "Message text to send"
    },
    "verify": {
      "description": "Verify delivery by checking pane content",
      "type": "boolean"
    },
    "force": {
      "description": "Send even if target appears mid-task",
      "type": "boolean"
    },
    "waitForIdleSeconds": {
      "description": "Wait until explicit idle evidence before sending",
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "required": [\
    "session",\
    "text"\
  ]
}

rig_capture

Capture terminal output from an agent session

Input	Type	Required	Description
session	"string"	no	Session name (omit for multi-target with rig/pod)
rig	"string"	no	Capture all sessions in a rig
pod	"string"	no	Capture all sessions in a pod
lines	"number"	no	Number of lines to capture (default: 20)

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "session": {
      "description": "Session name (omit for multi-target with rig/pod)",
      "type": "string"
    },
    "rig": {
      "description": "Capture all sessions in a rig",
      "type": "string"
    },
    "pod": {
      "description": "Capture all sessions in a pod",
      "type": "string"
    },
    "lines": {
      "description": "Number of lines to capture (default: 20)",
      "type": "number"
    }
  }
}

rig_chatroom_send

Send a message to a rig's chatroom

Input	Type	Required	Description
rigName	"string"	yes	Rig name to send message to
body	"string"	yes	Message body
sender	"string"	no	(deprecated, ignored) the sender is derived from the seat env (X-OpenRig-Session, stamped by the MCP server's DaemonClient); the chat route derives it from the transport header

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "rigName": {
      "type": "string",
      "description": "Rig name to send message to"
    },
    "body": {
      "type": "string",
      "description": "Message body"
    },
    "sender": {
      "description": "(deprecated, ignored) the sender is derived from the seat env (X-OpenRig-Session, stamped by the MCP server's DaemonClient); the chat route derives it from the transport header",
      "type": "string"
    }
  },
  "required": [\
    "rigName",\
    "body"\
  ]
}

rig_chatroom_watch

Get recent chatroom messages for a rig (MCP returns history, not streaming)

Input	Type	Required	Description
rigName	"string"	yes	Rig name

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "rigName": {
      "type": "string",
      "description": "Rig name"
    }
  },
  "required": [\
    "rigName"\
  ]
}

rig_add

Add a single member to an existing pod in a running rig (the add_member converge op). Identity-migration-free: mints a fresh seat, nothing existing re-keys.

Input	Type	Required	Description
rigId	"string"	yes	Target rig identifier
podNamespace	"string"	yes	Namespace of the existing pod to add the member to
member	"object"	yes	Member fragment with spec snake_case fields: id, runtime, agent_ref, profile, cwd (and optional model, codex_config_profile, restore_policy, label)
edges	"array"	no	Optional pod-local edges (from/to are member ids within the pod; resolved against the new member + existing pod-mates)
rigRoot	"string"	no	Root directory for agent resolution

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "rigId": {
      "type": "string",
      "description": "Target rig identifier"
    },
    "podNamespace": {
      "type": "string",
      "description": "Namespace of the existing pod to add the member to"
    },
    "member": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Member fragment with spec snake_case fields: id, runtime, agent_ref, profile, cwd (and optional model, codex_config_profile, restore_policy, label)"
    },
    "edges": {
      "description": "Optional pod-local edges (from/to are member ids within the pod; resolved against the new member + existing pod-mates)",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string"
          },
          "to": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          }
        },
        "required": [\
          "from",\
          "to",\
          "kind"\
        ]
      }
    },
    "rigRoot": {
      "description": "Root directory for agent resolution",
      "type": "string"
    }
  },
  "required": [\
    "rigId",\
    "podNamespace",\
    "member"\
  ]
}

Read as Markdown

MCP tools ​

rig_up ​

rig_down ​

rig_ps ​

rig_status ​

rig_snapshot_create ​

rig_snapshot_list ​

rig_restore ​

rig_discover ​

rig_bind ​

rig_bundle_inspect ​

rig_agent_validate ​

rig_rig_validate ​

rig_rig_nodes ​

rig_send ​

rig_capture ​

rig_chatroom_send ​

rig_chatroom_watch ​

rig_add ​

MCP tools

rig_up

rig_down

rig_ps

rig_status

rig_snapshot_create

rig_snapshot_list

rig_restore

rig_discover

rig_bind

rig_bundle_inspect

rig_agent_validate

rig_rig_validate

rig_rig_nodes

rig_send

rig_capture

rig_chatroom_send

rig_chatroom_watch

rig_add