Connect

Connect your AI assistant

Connect Claude, ChatGPT, Cursor, or any MCP client to your SuperOrgs organization. About a minute, no API keys.

MCP endpoint
https://app.superorgs.com/mcp

Add the connector

Pick your client and follow the steps. The endpoint is the same everywhere.

  1. 1

    Open connector settings

    In Claude, go to Settings, then Connectors.
  2. 2

    Add a custom connector

    Choose Add custom connector and paste the endpoint.
    https://app.superorgs.com/mcp
  3. 3

    Connect and pick your org

    Click Connect, sign in to SuperOrgs, and choose your organization on the consent screen.
  4. 4

    Ask something

    Try “What did my agents do today?” Claude will call the right tools.

What you can ask

Ask in plain language. SuperOrgs picks the right tools and answers from your real workforce.

Tools reference

Every tool the server exposes, grouped by what it answers. Names are stable; descriptions come straight from the product.

ToolWhat it returns
Activity
activity_org_feedRecent runs across every agent in the org, newest first, each with its Orion summary, status, and cost.
activity_statsOrg-wide activity headline for the last 7 days: runs, active agents, errors, spend.
activity_agent_runsOne agent's recent runs (including its linked deployments), newest first, with Orion summaries and cost.
activity_run_eventsThe full event timeline for one run (messages, tool calls, cost), oldest first.
activity_summarize_agentA digest of what one agent recently did: its latest runs with Orion summaries plus 24h stats.
Workforce
agents_listEvery agent in the org: name, type, platform, status, owner, department, monthly cost.
agents_getOne agent by id, with full detail.
org_chart_departmentsDepartments with their human headcount, agent count, human-to-agent ratio, and monthly AI spend.
Costs
costs_summaryMonthly AI spend, human-equivalent cost, savings, and ROI across the org.
cost_top_agentsThe biggest-spend agents over the window, each with its real run cost in cents and its share of total spend.
cost_anomaliesAgents whose run cost in the trailing window is at least 2x the equal-length window before it (a rate comparison, not a projection). New spenders with no prior baseline are flagged.
Health
agents_healthPer-agent run count, error count and rate, average duration, and idle time over the window, ranked worst-first to surface failing or stale agents.
agent_errors_recentThe most recent failed runs across the org, newest first, each with the agent name, error message, cost, and time.
run_forensicsOne run's full story for debugging why it failed or what it did: the run header (status, error, cost, tokens, duration, summary) plus its complete event timeline.
Discovery
agent_searchFind agents by a substring of their name, title, description, or department.
automation_gapsDepartments with active employees but little to no agent coverage, ranked by the widest gap, to show where deploying agents would help most.

Two prompts ship with the tools: workforce_review for a weekly review and investigate_cost_spike for a spend spike. Three resources attach from your client's attachment menu: the org chart snapshot, an agent profile, and a run report.

Permissions and safety

  • Your token is scoped to your organization. The org comes from the verified token, never from anything you type.
  • Every tool runs the same permission checks as the app. Your role and owner scope are respected.
  • Version 1 is read-only. Tools answer questions; actions come later.

Troubleshooting

Tools list is empty or stale
Remove the connector and add it again so your client refreshes the tool list.
401 or an auth loop
Your session expired. Reconnect and sign in again.
Connected but no data
Check you picked the right organization on the consent screen.
Connect your AI assistant (MCP) | SuperOrgs