Agent Quickstart

Establish an MCP connection and verify it with a safe, read-only call.

This guide gets you from zero to a working MCP connection with one safe, read-only verification call. It does not create or approve work.

Step 1: Connect

OpenClaw (Recommended)

Install the documented plugin, then complete browser pairing:

openclaw plugins install @useorgx/openclaw-plugin

Open the plugin’s local dashboard, choose Connect OrgX, and approve in the browser.

Full OpenClaw setup guide →

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "orgx": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.useorgx.com/mcp"]
    }
  }
}

Restart Cursor. On first use, mcp-remote opens your browser for OAuth sign-in automatically.

Claude

In Claude or Claude Desktop, open Settings → Connectors and add a custom remote MCP connector using:

https://mcp.useorgx.com/mcp

Then complete the OAuth flow in your browser.

Need client-specific instructions for ChatGPT, VS Code, or other MCP hosts? Use the full MCP Client Setup guide.

Step 2: Verify Connection

Run this safe, read-only call to confirm everything works:

{
  "tool": "workspace",
  "args": { "action": "get" }
}

The response should identify the active workspace. IDs, names, and additional fields vary by account; do not copy a response from this page as workspace state.

If you get workspace_not_set, list available workspaces and set one:

{ "tool": "workspace", "args": { "action": "list" } }

{
  "tool": "workspace",
  "args": { "action": "set", "workspace_id": "<workspace_id>" }
}

Step 3: Explore Your Org

{
  "tool": "orgx_recommend",
  "args": { "mode": "morning_brief", "period": "30d" }
}

The response contains the available brief or recommendation signals for the active workspace. Its contents depend on the workspace and reporting period.

Step 4: Check Pending Decisions

{
  "tool": "orgx_search",
  "args": {
    "type": "decision",
    "status": "pending",
    "limit": 5
  }
}

The response contains the matching decisions, if any. Review the returned record before taking a write action.

If you have pending decisions, approve one:

{
  "tool": "orgx_decide",
  "args": {
    "action": "approve",
    "decision_id": "<decision_id>",
    "note": "Approved after reviewing the artifact and evidence"
  }
}

What’s Next

Agent Recipes

Small, reviewable workflows with contract links.

Failure Playbooks

Error recovery for common issues.

Tool Profiles

Reduce schema overhead with role-based profiles.

Full Tool Reference

Complete documentation for the current MCP tool catalog.