list_organizations — List accessible organizations

The list_organizations tool returns every organization the current OAuth token is authorized to access. Your agent should call this first to discover valid organizationId values before calling any other tool. If exactly one organization is returned, the agent may proceed directly; otherwise it should ask the user which organization to use.

Scope

Required OAuth scope: organizations.read

Input

string

required

What the user asked for and why this call serves it, in 1 to 500 characters. Required on every tool call. See Common tool arguments.

This is the only tool that does not take an organizationId.

Output

Organization[]

required

Array of organizations the token can access and that the signed-in user is still a member of.

Show Organization

string

required

Always "organization".

string

required

Unique organization identifier. Use this value as organizationId in other tools.

string | null

required

Display name of the organization. May be null. For display only; do not treat as a stable identifier.

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_organizations",
    "arguments": {
      "intent": "User asked for their recent transactions; resolving which organization to query."
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "data": [
        {
          "object": "organization",
          "id": "org_1",
          "name": "Acme Inc"
        }
      ]
    }
  }
}

Notes

The name field is nullable and display-only. Always use id as the canonical organizationId.
If the array contains more than one organization, your agent should ask the user which to use rather than guessing.

Result conventions

Learn how structuredContent, pagination, and Money objects work across all tools.

list_accounts

Next: list the accounts within an organization.

Organizations

Transactions

Accounts

Cards

Statements

Contacts

Catalog items

Invoices

list_organizations — List accessible organizations

Scope

Input

Output

Example

Notes

Result conventions

list_accounts

​Scope

​Input

​Output

​Example

​Notes

Result conventions

list_accounts

Scope

Input

Output

Example

Notes