Skip to main content
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

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.