conecto. Get started
Account

List teams

account_list_teams · Reads only · Markdown

The account's teams with their areas, budgets, this month's spend, ERP codes, keys and people.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

How much has each team spent on agents this month?

Your agent callsaccount_list_teamsFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{}
What comes back
{
  "teams": [
    {
      "team_id": 4101,
      "name": "Company",
      "company_wide": true,
      "areas": null,
      "read_only": false,
      "drafts_only": false,
      "sees_sensitive": true,
      "idp_groups": null,
      "mailboxes": null,
      "monthly_budget_usd": null,
      "budget_usd": null,
      "budget_period": "month",
      "budget_ends_on": null,
      "raise": null,
      "budget": "hard",
      "alert_percent": 80,
      "spent_this_period_usd": "$0.001",
      "spent_this_month_usd": "$0.001",
      "erp_code": null,
      "paused": false,
      "paused_at": null,
      "keys": [
        {
          "key_id": 4101,
          "bot_name": "Pip"
        }
      ],
      "people": []
    },
    {
      "team_id": 4102,
      "name": "Support",
      "company_wide": false,
      "areas": [
        "chat",
        "helpdesk"
      ],
      "read_only": false,
      "drafts_only": false,
      "sees_sensitive": false,
      "idp_groups": null,
      "mailboxes": null,
      "monthly_budget_usd": "$200.00",
      "budget_usd": "$200.00",
      "budget_period": "month",
      "budget_ends_on": null,
      "raise": null,
      "budget": "hard",
      "alert_percent": 80,
      "spent_this_period_usd": "$0.00",
      "spent_this_month_usd": "$0.00",
      "erp_code": "KST-4100",
      "paused": false,
      "paused_at": null,
      "keys": [
        {
          "key_id": 4102,
          "bot_name": "Support bot"
        }
      ],
      "people": []
    }
  ]
}

Use it when

Someone asks what each department's agents spent this month, how much budget is left, which agents belong to which team, or who is in a team and manages it.

What it does

The account's teams, the company-wide one first: each with its areas, whether it only reads, its budget (hard or soft, and its period) and alert line, this period's spend, its ERP code, whether it is paused, its keys, and its people with who manages it. A person's own assistant works within their teams.

What comes back

teams: each with its id, name, areas, whether it only reads, budget, spend this month, ERP code, whether it is paused, its keys, and its people (email, name, manager). The company-wide team comes first. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call account_list_teams on https://api.conecto.chat/mcp/account. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/account_list_teams \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More Account tools

All 28 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md