> ## Documentation Index
> Fetch the complete documentation index at: https://mcp.docs.relayfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# list_organizations — List accessible organizations

> Reference for the list_organizations MCP tool. Returns the organizations your token can access so your agent knows which organizationId to use for subsequent calls.

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

**intent** `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](https://mcp.docs.relayfi.com/concepts/transport.md#common-tool-arguments).

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

## Output

**data** `Organization[]` *required*

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

**Organization**

**object** `string` *required*

Always `"organization"`.

**id** `string` *required*

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

**name** `string | null` *required*

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

## Example

```json Request theme={null}
{
  "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."
    }
  }
}
```

```json Response theme={null}
{
  "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.

> [card] [Result conventions](https://mcp.docs.relayfi.com/concepts/results.md)
>
> Learn how structuredContent, pagination, and Money objects work across all tools.

> [card] [list\_accounts](https://mcp.docs.relayfi.com/tools/list-accounts.md)
>
> Next: list the accounts within an organization.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.