# OrgX OrgX is coordination infrastructure for AI-native teams. It gives your LLM a persistent organizational layer: initiatives with milestones and tasks, human-in-the-loop decision workflows, specialist a… ## Quick Start ```bash # Connect this server (installs CLI if needed) npx -y @smithery/cli@latest mcp add useorgx/orgx-mcp # Browse available tools npx -y @smithery/cli@latest tool list useorgx/orgx-mcp # Get full schema for a tool npx -y @smithery/cli@latest tool get useorgx/orgx-mcp get_pending_decisions # Call a tool npx -y @smithery/cli@latest tool call useorgx/orgx-mcp get_pending_decisions '{}' ``` ## Direct MCP Connection Endpoint: `https://orgx-mcp--useorgx.run.tools` ## Tools (62) - `get_pending_decisions` — List OrgX decisions awaiting approval. USE WHEN: older clients still call this tool directly. NEXT: Present each decisi… - `approve_decision` — Approve a specific pending OrgX decision after the user confirms. USE WHEN: user says to approve a decision returned fr… - `reject_decision` — Reject a pending OrgX decision with a reason. USE WHEN: user wants to reject or request revisions on a decision. NEXT: … - `get_agent_status` — Show what OrgX agents are currently doing (running/idle). USE WHEN: user asks about agent activity, progress, or what a… - `query_org_memory` — Search OrgX organizational memory (decisions, initiatives, artifacts) for a query. USE WHEN: user asks about past decis… - `get_initiative_pulse` — Get health, milestones, blockers, and recent activity for a single initiative. USE WHEN: user asks how an initiative is… - `spawn_agent_task` — Assign work to a specialist OrgX agent. Automatically checks authorization, rate limits, and quality gates before spawn… - `handoff_task` — Hand a task to another agent, updating assignment and optionally spawning a new run. USE WHEN: a task needs to be reass… - `recommend_next_action` — Recommend the next best action based on progress gaps and templates. USE WHEN: user asks what to do next, or needs help… - `get_decision_history` — Search past OrgX decisions related to a topic. USE WHEN: older clients still call this tool directly. NEXT: Present res… - `score_next_up_queue` — Run the composite scoring engine and return ranked queue items with factor breakdowns. USE WHEN: older clients explicit… - `get_scoring_signals` — Show raw signal data (blocking decisions, stream conflicts, health, budget, critical path, quality) for scoring. USE WH… - `scoring_config` — Read or update scoring engine configuration. USE WHEN: user asks about scoring setup, wants to toggle scoring, adjust w… - `queue_action` — Pin, unpin, or skip a workstream in the Next Up queue. USE WHEN: user wants to force-prioritize or deprioritize a works… - `start_plan_session` — Start a new planning session to track your feature plan. USE WHEN: user begins planning a new feature or initiative. NE… - `get_active_sessions` — Check for any active planning sessions you have open. USE WHEN: resuming a conversation or checking if a plan session e… - `improve_plan` — Get AI suggestions to improve your plan based on past patterns and best practices. USE WHEN: user wants feedback on a p… - `record_plan_edit` — Record an edit made to a plan to learn planning patterns. USE WHEN: user modifies their plan during a session. NEXT: Co… - `complete_plan` — Mark a plan as complete and record implementation details. USE WHEN: user finishes building the planned feature. NEXT: … - `update_stream_progress` — Report progress and confidence on a stream with velocity tracking. USE WHEN: agent is actively working a stream and nee… - `get_initiative_stream_state` — Get aggregate stream state for an initiative including overall progress, blockers, and computed metrics. USE WHEN: chec… - `orgx_emit_activity` — Emit append-only run telemetry for OrgX control-plane reporting. USE WHEN: agent is executing and needs to report progr… - `orgx_apply_changeset` — Apply an idempotent transactional changeset for task/milestone/decision mutations. USE WHEN: agent needs to create/upda… - `sync_client_state` — Sync local memory with OrgX. Push decisions/logs, pull active context. USE WHEN: at session start and periodically duri… - `check_spawn_guard` — Check whether an agent spawn is allowed before executing. Returns model tier, rate limit status, quality gate, and task… - `record_quality_score` — Record a quality score (1-5) for a completed agent task. Scores feed into the quality gate — low-scoring domains get th… - `classify_task_model` — Classify a task and get the recommended model tier (opus for planning/architecture, sonnet for execution, local for rou… - `orgx_bootstrap` — Discover current profile, workspace scope, granted scopes, safe first calls, canonical ID forms, and recommended workfl… - `orgx_describe_tool` — Return the live input contract, auth expectations, and workflow guidance for a tool. USE WHEN: you need exact field nam… - `orgx_describe_action` — Describe lifecycle actions, aliases, and special payload requirements for entity_action. USE WHEN: you need the exact a… - `resume_plan_session` — Load a plan session using the canonical UUID or OrgX URI returned by OrgX tools. If no session_id is provided, returns … - `create_task` — Create a task without using the generic create_entity surface. USE WHEN: adding a single actionable task to a workstrea… - `create_milestone` — Create a milestone without using the generic create_entity surface. USE WHEN: adding a phase checkpoint under an initia… - `create_decision` — Create a decision without using generic power tools. USE WHEN: surfacing a new approval or judgment point for a workspa… - `validate_studio_content` — Validate a studio_content entity without composing entity_action manually. USE WHEN: checking a studio content spec bef… - `pin_workstream` — Pin a workstream to the top of the Next Up queue without composing queue_action manually. USE WHEN: forcing a workstrea… - `get_org_snapshot` — Fetch a compact organization snapshot. USE WHEN: user wants an org-wide overview of initiatives, progress, and health. … - `account_status` — Get the current OrgX account tier, billing status, and usage snapshot for the authenticated user. - `account_upgrade` — Create the next-step upgrade flow for the authenticated OrgX account. Enterprise requests return contact guidance inste… - `account_usage_report` — Get a detailed usage and billing report for the authenticated OrgX account, including quotas, period boundaries, and ov… - `list_entities` — List entities with filtering. Returns FULL UUIDs usable with entity_action/batch_action. Use fields=["id","title","stat… - `entity_action` — Execute a lifecycle action on a single entity. Accepts short ID prefix (8+ hex chars) — no need to look up full UUIDs. … - `verify_entity_completion` — Run pre-completion verification to confirm all child work is done. For tasks, this also checks proof-chain hard blocks … - `create_entity` — Create a new entity of any type. USE WHEN: adding a single task, milestone, workstream, or other entity to an existing … - `comment_on_entity` — Leave a threaded comment on an entity. USE WHEN: agent or user wants to annotate an entity with observations, concerns,… - `list_entity_comments` — List comments for an entity. USE WHEN: reviewing discussion thread on an entity. NEXT: Use comment_on_entity to add a r… - `batch_create_entities` — Create multiple entities in one call with ref-based dependency resolution. USE WHEN: creating several related entities … - `scaffold_initiative` — Create a complete initiative with workstreams, milestones, and tasks in one call. USE WHEN: user wants to plan a new in… - `get_task_with_context` — Fetch a task with hydrated context attachments (entities, artifacts, plan sessions). USE WHEN: agent needs full task co… - `batch_delete_entities` — Delete multiple entities in one call (hard delete). USE WHEN: user explicitly wants to remove entities permanently. NEX… --- *Response truncated. Use `npx -y @smithery/cli@latest` for complete data.*