Agent Quickstart

This guide gets you from zero to a working MCP connection with a successful tool call as fast as possible.

Questions This Page Answers

What is the fastest path to a verified OrgX MCP connection?
Which calls prove connectivity, workspace context, and decision readiness?
What does “healthy first run” look like before dispatching real work?

Step 1: Connect

OpenClaw (Recommended)
Cursor
Claude

The fastest path — handles auth and config automatically:

openclaw plugins install @useorgx/openclaw-plugin

Open http://127.0.0.1:18789/orgx/live, click Connect OrgX, approve in browser. Done.Full OpenClaw setup guide →

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.

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" }
}

Expected response:

{
  "workspace_id": "ws_abc123",
  "name": "My Startup",
  "plan": "team",
  "created_at": "2025-10-01T00:00:00Z"
}

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

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

{
  "tool": "workspace",
  "args": { "action": "set", "workspace_id": "ws_abc123" }
}

Step 3: Explore Your Org

{
  "tool": "orgx_recommend",
  "args": { "view": "summary" }
}

Expected response:

{
  "workspace": "My Startup",
  "initiatives": { "total": 3, "active": 2, "completed": 1 },
  "pending_decisions": 4,
  "active_agents": 2,
  "recent_artifacts": 7
}

Step 4: Check Pending Decisions

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

Expected response:

{
  "entities": [
    {
      "id": "dec_xyz789",
      "type": "decision",
      "title": "Campaign brief ready for Q1 launch",
      "status": "pending",
      "urgency": "high",
      "created_at": "2026-02-26T10:00:00Z"
    }
  ],
  "total": 4
}

orgx_decide still works as a compatibility alias, but new clients should prefer orgx_search. If you have pending decisions, approve one:

{
  "tool": "orgx_decide",
  "args": {
    "decision_id": "dec_xyz789",
    "note": "Looks good, ship it!"
  }
}

Expected response:

{
  "decision_id": "dec_xyz789",
  "status": "approved",
  "artifact_id": "art_abc456"
}

What’s Next

Agent Recipes

Common multi-tool workflows with exact sequences.

Failure Playbooks

Error recovery for common issues.

Tool Profiles

Reduce schema overhead with role-based profiles.

Full Tool Reference

Complete documentation for all 54 tools.

Getting Started

Connect Your Tools

Agent Ops

Platform

API Reference

Resources

Questions This Page Answers

Step 1: Connect

Step 2: Verify Connection

Step 3: Explore Your Org

Step 4: Check Pending Decisions

What’s Next

Agent Recipes

Failure Playbooks

Tool Profiles

Full Tool Reference

​Questions This Page Answers

​Step 1: Connect

​Step 2: Verify Connection

​Step 3: Explore Your Org

​Step 4: Check Pending Decisions

​What’s Next

Agent Recipes

Failure Playbooks

Tool Profiles

Full Tool Reference

Questions This Page Answers

Step 1: Connect

Step 2: Verify Connection

Step 3: Explore Your Org

Step 4: Check Pending Decisions

What’s Next