Skip to main content
This page documents the MCP tools exposed by the OpenClaw plugin local bridge, grounded in plugin source code.
Generated from plugin version 0.7.28 in ../../orgx-openclaw-plugin-tool-guidance. Regenerate with pnpm docs:generate-openclaw-plugin.

​
Endpoint Model

EndpointPurpose
/orgx/mcpFull plugin tool surface (all 33 tools).
/orgx/mcp/{domain}Domain-safe subset of tools.

​
Scoped Domains

DomainTool CountAdditional Tools Beyond Base
engineering18None
product18None
design18None
marketing18None
sales18None
operations23orgx_agent_sessions, orgx_apply_changeset, orgx_reassign_stream, orgx_reassign_streams, update_agent_config
orchestration25orgx_agent_sessions, orgx_apply_changeset, orgx_clear_agent_session, orgx_reassign_stream, orgx_reassign_streams, orgx_resume_agent_session, update_agent_config

​
Tool Catalog

CategoryTools
Sync & Reportingorgx_emit_activity, orgx_register_artifact, orgx_report_progress, orgx_status, orgx_sync
Delegation & Assignmentorgx_delegation_preflight, orgx_spawn_check
Decision & Run Controlorgx_checkpoint_restore, orgx_checkpoints_list, orgx_request_decision, orgx_run_action
Planning & Entity Managementorgx_apply_changeset, orgx_create_entity, orgx_reassign_stream, orgx_reassign_streams, orgx_update_entity, update_stream_progress
Quality, Proof & Outcomesorgx_get_outcome_attribution, orgx_proof_status, orgx_quality_score, orgx_record_outcome, orgx_verify_completion
Agent Policy & Configurationget_agent_config, list_agent_configs, orgx_sentinel_catalog, update_agent_config
Generalorgx_agent_sessions, orgx_clear_agent_session, orgx_get_morning_brief, orgx_list_entities, orgx_query_org_memory, orgx_recommend_next_action, orgx_resume_agent_session

​
Sync & Reporting

​
orgx_emit_activity

Emit append-only OrgX activity telemetry (launch reporting contract primary write tool).
​
initiative_id
string
Initiative UUID (required unless ORGX_INITIATIVE_ID is set)
​
message
string
required
Human-readable activity update
​
run_id
string
Optional run UUID
​
correlation_id
string
Required when run_id is omitted
​
source_client
string
Required when run_id is omitted Options: openclaw, codex, claude-code, api.
​
phase
string
Reporting phase Options: intent, execution, blocked, review, handoff, completed.
​
progress_pct
number
Optional progress percentage
​
level
string
Optional level (default info) Options: info, warn, error.
​
next_step
string
Optional next step
​
metadata
object
Optional structured metadata
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_register_artifact

Register a work output (PR, document, config change, report, etc.) as a work_artifact in OrgX. Makes it visible in the dashboard activity timeline and entity detail modals.
​
initiative_id
string
Convenience: initiative UUID. Used as entity_type=‘initiative’, entity_id=<this> when entity_type/entity_id are not provided.
​
entity_type
string
The type of entity this artifact is attached to Options: initiative, milestone, task, decision, project.
​
entity_id
string
UUID of the entity this artifact is attached to
​
name
string
required
Human-readable artifact name (e.g., ‘PR #107: Fix build size’)
​
artifact_type
string
required
Artifact type code (e.g., ‘eng.diff_pack’, ‘pr’, ‘document’). Falls back to ‘shared.project_handbook’ if the type is not recognized by OrgX.
​
confidence_score
number
Self-assessed confidence for this artifact in [0,1].
​
description
string
What this artifact is and why it matters
​
url
string
External link to the artifact (PR URL, file path, etc.)
​
content
string
Inline preview content (markdown/text). At least one of url or content is required.
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_report_progress

Alias for orgx_emit_activity. Report progress at key milestones so the team can track your work.
​
initiative_id
string
Initiative UUID (required unless ORGX_INITIATIVE_ID is set)
​
run_id
string
Optional run UUID
​
correlation_id
string
Required when run_id is omitted
​
source_client
string
Options: openclaw, codex, claude-code, api.
​
summary
string
required
What was accomplished (1-2 sentences, human-readable)
​
phase
string
required
Current work phase Options: researching, implementing, testing, reviewing, blocked.
​
progress_pct
number
Progress percentage (0-100)
​
next_step
string
What you plan to do next
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_status

Get current OrgX org status: active initiatives, agent states, pending decisions, active tasks. No parameters required. Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_sync

Push/pull memory sync with OrgX. Send local memory/daily log; receive initiatives, tasks, decisions, model routing policy.
​
memory
string
Local memory snapshot to push
​
dailyLog
string
Today’s session log to push
​
agents
object[]
Optional local agent states to sync into OrgX
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
Delegation & Assignment

​
orgx_delegation_preflight

Run delegation preflight to score scope quality, estimate ETA/cost, and suggest a split before autonomous execution.
​
intent
string
required
Task intent in natural language
​
acceptanceCriteria
string[]
Optional acceptance criteria to reduce ambiguity
​
constraints
string[]
Optional constraints (deadline, stack, policy)
​
domains
string[]
Optional preferred owner domains
Scope Class: Domain-specific or unscoped-only Scoped Domains: Not exposed on scoped domain endpoints

​
orgx_spawn_check

Check quality gate + get model routing before spawning a sub-agent. Returns allowed/denied, model tier, and check details.
​
domain
string
required
Agent domain (engineering, product, marketing, data, operations, design)
​
taskId
string
OrgX task ID to check
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
Decision & Run Control

​
orgx_checkpoint_restore

Restore a run to a specific checkpoint.
​
runId
string
required
Run UUID
​
checkpointId
string
required
Checkpoint UUID
​
reason
string
Optional restoration reason
Scope Class: Domain-specific or unscoped-only Scoped Domains: Not exposed on scoped domain endpoints

​
orgx_checkpoints_list

List checkpoints for a run.
​
runId
string
required
Run UUID
Scope Class: Domain-specific or unscoped-only Scoped Domains: Not exposed on scoped domain endpoints

​
orgx_request_decision

Alias for orgx_apply_changeset with decision.create. Request a human decision before proceeding.
​
initiative_id
string
Initiative UUID (required unless ORGX_INITIATIVE_ID is set)
​
run_id
string
Optional run UUID
​
correlation_id
string
Required when run_id is omitted
​
source_client
string
Options: openclaw, codex, claude-code, api.
​
question
string
required
The decision question (e.g., ‘Deploy to production?’)
​
context
string
Background context to help the human decide
​
options
string[]
Available choices (e.g., [‘Yes, deploy now’, ‘Wait for more testing’, ‘Cancel’])
​
urgency
string
required
How urgent this decision is Options: low, medium, high, urgent.
​
blocking
boolean
Whether work should pause until this is decided (default: true)
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_run_action

Apply a control action to a run: pause, resume, cancel, or rollback (rollback requires checkpointId).
​
runId
string
required
Run UUID
​
action
string
required
Control action Options: pause, resume, cancel, rollback.
​
checkpointId
string
Checkpoint UUID (required for rollback)
​
reason
string
Optional reason for audit trail
Scope Class: Domain-specific or unscoped-only Scoped Domains: Not exposed on scoped domain endpoints

​
Planning & Entity Management

​
orgx_apply_changeset

Apply an idempotent transactional OrgX changeset (launch reporting contract primary mutation tool).
​
initiative_id
string
Initiative UUID (required unless ORGX_INITIATIVE_ID is set)
​
idempotency_key
string
Idempotency key (<=120 chars). Auto-generated if omitted.
​
operations
object[]
required
Changeset operations (task.create, task.update, milestone.update, decision.create)
​
run_id
string
Optional run UUID
​
correlation_id
string
Required when run_id is omitted
​
source_client
string
Required when run_id is omitted Options: openclaw, codex, claude-code, api.
Scope Class: Domain-specific or unscoped-only Scoped Domains: operations, orchestration

​
orgx_create_entity

Create an OrgX entity (initiative, workstream, task, decision, milestone, etc.).
​
type
string
required
Entity type: initiative, workstream, task, decision, milestone, artifact, agent, blocker
​
title
string
required
Entity title
​
summary
string
Description
​
status
string
Initial status (active, not_started, todo)
​
initiative_id
string
Parent initiative ID (for workstreams/tasks)
​
workstream_id
string
Parent workstream ID (for tasks)
​
workspace_id
string
Workspace ID (canonical; preferred for new callers)
​
command_center_id
string
Deprecated alias for workspace_id
Scope Class: Domain-specific or unscoped-only Scoped Domains: Not exposed on scoped domain endpoints

​
orgx_reassign_stream

Reassign a workstream’s stream ownership/agents and return reassignment scheduling details.
​
workstream_id
string
required
Workstream UUID to reassign
​
initiative_id
string
required
Parent initiative UUID
​
status
string
Optional workstream status override (active, in_progress, pending, etc.)
​
domain
string
Optional target domain for the reassigned stream
​
role
string
Optional role hint for assignment routing
​
assigned_agent_ids
string[]
Optional assigned agent IDs
​
assignedAgentIds
string[]
Alias for assigned_agent_ids
​
assigned_agent_names
string[]
Optional assigned agent display names
​
assignedAgentNames
string[]
Alias for assigned_agent_names
​
assigned_agents
object[]
Optional structured assigned agent list
Scope Class: Domain-specific or unscoped-only Scoped Domains: operations, orchestration

​
orgx_reassign_streams

Convenience batch reassignment tool. Takes initiative_id and a workstream-to-domain mapping, then updates all listed workstreams.
​
initiative_id
string
required
Parent initiative UUID for all workstream updates
​
workstream_domains
object
Mapping of workstream UUID -> target domain
​
mapping
object
Alias for workstream_domains: mapping of workstream UUID -> target domain
​
mappings
object[]
Optional array mapping for advanced routing fields (workstream_id, domain, role, status).
​
status
string
Optional workstream status override applied to each reassigned stream
Scope Class: Domain-specific or unscoped-only Scoped Domains: operations, orchestration

​
orgx_update_entity

Update an existing OrgX entity by type and ID.
​
type
string
required
Entity type
​
id
string
required
Entity UUID
​
status
string
New status
​
title
string
New title
​
summary
string
New summary
Scope Class: Domain-specific or unscoped-only Scoped Domains: Not exposed on scoped domain endpoints

​
update_stream_progress

Legacy alias for orgx_report_progress. Report progress at key milestones so the team can track your work.
​
initiative_id
string
Initiative UUID (required unless ORGX_INITIATIVE_ID is set)
​
run_id
string
Optional run UUID
​
correlation_id
string
Required when run_id is omitted
​
source_client
string
Options: openclaw, codex, claude-code, api.
​
summary
string
required
What was accomplished (1-2 sentences, human-readable)
​
phase
string
required
Current work phase Options: researching, implementing, testing, reviewing, blocked.
​
progress_pct
number
Progress percentage (0-100)
​
next_step
string
What you plan to do next
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
Quality, Proof & Outcomes

​
orgx_get_outcome_attribution

Compatibility alias for detailed outcome attribution on a task or run. Prefer orgx_get_morning_brief for current value and ROI review.
​
task_id
string
Task ID to get attribution for
​
run_id
string
Run ID to get attribution for
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_proof_status

Check the proof chain status for a task or run. Returns a checklist of proof levels (L1-L7) with gaps highlighted. Use this to verify work is provably complete before marking done.
​
task_id
string
ID of the task to check proof for
​
run_id
string
ID of the run to check proof for
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_quality_score

Record a quality score (1-5) for completed agent work. Used to gate future spawns and track performance.
​
taskId
string
required
ID of the completed task
​
domain
string
required
Agent domain that did the work
​
score
number
required
Quality 1 (poor) to 5 (excellent)
​
notes
string
Notes on the assessment
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_record_outcome

Record an outcome event for a completed run, linking execution to business value. Required for L5 (Impact) proof level.
​
initiative_id
string
required
Initiative ID this outcome belongs to
​
execution_id
string
required
Execution/run ID that produced this outcome
​
agent_id
string
required
Agent that did the work
​
success
boolean
required
Whether the execution was successful
​
quality_score
number
Quality score 1-5
​
domain
string
Agent domain
​
metadata
object
Additional outcome metadata
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_verify_completion

Verify that an entity (task/milestone/workstream) meets completion requirements including proof chain. Returns structured result with any blocking issues.
​
entity_type
string
required
Entity type: task, milestone, workstream
​
entity_id
string
required
ID of the entity to verify
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
Agent Policy & Configuration

​
get_agent_config

Get a single agent behavior config by id (default only).
​
config_id
string
Agent config identifier. Use ‘default’.
​
refresh_remote
boolean
When true, re-fetch behavior config policy from OrgX before returning data.
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
list_agent_configs

List available agent behavior configs managed by this plugin.
​
refresh_remote
boolean
When true, re-fetch behavior config policy from OrgX before returning data.
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_sentinel_catalog

List built-in proactive sentinel templates. Supports optional domain filter.
​
domain
string
Optional domain filter (engineering, sales, operations, product).
Scope Class: Domain-specific or unscoped-only Scoped Domains: Not exposed on scoped domain endpoints

​
update_agent_config

Update plugin-managed agent behavior config policy (default config only).
​
config_id
string
Agent config identifier. Use ‘default’.
​
frozen
boolean
Freeze remote skill-pack refresh when true.
​
pinned_checksum
string
Pin behavior policy to this exact checksum.
​
pin_to_current
boolean
Pin to current local/remote checksum.
​
clear_pin
boolean
Clear any pinned checksum.
​
action
string
Use ‘rollback’ to revert to the previous config version.
​
rollback_to_audit_id
string
Optional audit entry id to rollback to. When omitted with action=‘rollback’, uses the most recent audit entry.
​
template_id
string
Optional preset template id. Currently supports ‘startup-speed’.
Scope Class: Domain-specific or unscoped-only Scoped Domains: operations, orchestration

​
General

​
orgx_agent_sessions

List active CLI session IDs stored for workstreams. Used for session resume support.
​
initiativeId
string
Optional initiative ID filter.
Scope Class: Domain-specific or unscoped-only Scoped Domains: operations, orchestration

​
orgx_clear_agent_session

Clear stored CLI session IDs for an initiative (forces fresh sessions on next dispatch).
​
initiativeId
string
required
Initiative UUID
Scope Class: Domain-specific or unscoped-only Scoped Domains: orchestration

​
orgx_get_morning_brief

Get the morning brief value surface: session summary, value signals, exceptions, trust events, and top receipts. Preferred replacement for ROI summary lookups.
​
workspace_id
string
required
Workspace ID to load the brief for
​
session_id
string
Optional autonomous session ID
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_list_entities

List OrgX entities of a given type with optional status filter.
​
type
string
required
Entity type: initiative, workstream, task, decision, agent
​
status
string
Filter by status
​
limit
number
Max results (default 20) Default: 20.
​
initiative_id
string
Filter by initiative ID
​
project_id
string
Legacy project/workspace scope filter
​
workspace_id
string
Workspace ID (canonical scope)
​
command_center_id
string
Deprecated alias for workspace_id
Scope Class: Domain-specific or unscoped-only Scoped Domains: Not exposed on scoped domain endpoints

​
orgx_query_org_memory

Search OrgX organizational memory (decisions, initiatives, artifacts). Preferred replacement for older decision-history lookups.
​
query
string
required
What to search for
​
scope
string
Optional memory scope Options: all, artifacts, decisions, initiatives.
​
limit
number
Max results to return
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_recommend_next_action

Get the preferred next action for a workspace, initiative, workstream, or milestone. Preferred replacement for raw queue scoring in operator workflows.
​
entity_type
string
Entity type to recommend for (default: workspace) Options: workspace, initiative, workstream, milestone.
​
entity_id
string
Entity ID. For workspace, use “default” or a workspace ID.
​
workspace_id
string
Optional canonical workspace scope
​
command_center_id
string
Deprecated alias for workspace_id
​
limit
number
Max recommendations to return
​
cascade
boolean
Refresh recommendations across the entity chain first
Scope Class: Base domain tool (available in every domain-scoped endpoint) Scoped Domains: design, engineering, marketing, operations, orchestration, product, sales

​
orgx_resume_agent_session

Store or update a CLI session ID for a workstream so the next slice resumes it.
​
workstreamId
string
required
Workstream UUID
​
sessionId
string
required
CLI session UUID to resume
​
initiativeId
string
required
Initiative UUID
​
sourceClient
string
Source client (codex, claude-code)
Scope Class: Domain-specific or unscoped-only Scoped Domains: orchestration