# Admin tools

Only owners and admins get these tools. Members do not see them.
For how to use them, see [Manage Ototo from your assistant](../assistant/manage-ototo-from-your-assistant.md).

| Tool | What it does | Changes data |
| --- | --- | --- |
| `ototo_list_organizations` | List the organizations that you manage as owner or admin. | No |
| `ototo_list_people` | List the people, their roles, the access level of each person on each company, and the pending invitations. | No |
| `ototo_list_companies` | List the connected companies, their status, and if writes and deletes are allowed. | No |
| `ototo_activity` | Get an activity report: tool use by person and company, and the changes that people made. | No |
| `ototo_billing_status` | Show the trial or subscription status and the monthly charges. | No |
| `ototo_payment_link` | Get a Stripe link to add or manage a payment method. | No. Changes occur on the Stripe page only. |
| `ototo_invite_person` | Invite a person by email, with a role and an access level. | Yes, after you confirm |
| `ototo_set_access` | Set the access level of a person on one company or on all companies. | Yes, after you confirm |
| `ototo_set_role` | Make a person an admin or a member. | Yes, after you confirm |
| `ototo_remove_person` | Remove a person from the organization. Their access stops immediately. | Yes, after you confirm |

## Parameters

All tools have the parameter `organization`: the name or ID of the organization.
You must give it only if you manage more than one organization.

The tools that change data also have the parameter `confirmation`.
The assistant leaves it empty to get a preview. Then it sends the code from the preview.

### `ototo_invite_person`

- `email`: the email address of the person.
- `role`: `member` or `admin`. The default is `member`.
- `access`: `none`, `read`, `bookkeeper` or `full`. The default is the starting access of the organization.

### `ototo_set_access`

- `person`: the email address (best) or the name of the person.
- `access`: `none`, `read`, `bookkeeper` or `full`.
- `company`: the name or ID of a company, or `all`.

The level replaces the custom settings of the person on those companies.

### `ototo_set_role`

- `person`: the email address (best) or the name of the person.
- `role`: `admin` or `member`.

### `ototo_remove_person`

- `person`: the email address (best) or the name of the person.

You cannot remove yourself with this tool. To leave an organization, use the web app.

### `ototo_activity`

This tool only reads. It never returns tool arguments, tool results or accounting data.

- `person`: an email address or a name. The report shows the activity of the person and the changes made to them.
- `company`: the name or ID of a company.
- `kind`: `all`, `tools`, `changes` or `sign_ins`. The default is `all`.
  - `tools`: tool use from assistants.
  - `changes`: changes to access, roles, names, invitations, companies and company policy.
  - `sign_ins`: sign-ins to the web app and connections from assistants.
- `since`: the start date, for example `2026-11-01`. The default is 30 days before today.
- `until`: the end date. The report does not include this date. The default is now.
- `failed_only`: if `true`, the report shows only the events that failed.
- `view`: `summary` or `events`. The default is `summary`. A summary gives counts. `events` gives the list of events, with the newest first.
- `limit`: the number of events for `events`. The default is 50. The maximum is 200.

## Access levels in the tools

| Value | Level |
| --- | --- |
| `none` | **No access** |
| `read` | **Read only** |
| `bookkeeper` | **Bookkeeper** |
| `full` | **Full access** |
