Generate an API token

Connect your AI agent to Umtri with a personal access token (PAT).

Generate a token

Sign in to app.umtri.io.
Select your profile at the bottom of the sidebar and go to Settings in the submenu.
Select API Tokens.
1. Enter any label (e.g. claude-desktop) that helps you tell tokens apart and remember what each one is for.
2. Choose a scope. The default is Write.
  - Read : a read-only token. Authenticated with it, a client can read your Umtri data but cannot edit it.
  - Write : a token that can read and write. It also grants edit access. You can keep up to 3 active Write tokens — revoke one to issue another. Read tokens have no limit.
3. Click Generate token to create the token.
4. Once the token is generated, ADD UMTRI MCP appears right below it. Copy the command for the AI agent you use — it already contains the token you just generated. Clicking Dismiss hides it along with the token for good, so copy it first.
  - Connecting through MCP is covered in more detail in Connect via MCP.

In a team, a token acts with your role there — a viewer’s Write token still can’t edit the team’s grounds. See Teams.

For security, tokens are stored only as a SHA-256 hash and can be seen just once, when they are created. Be sure to copy the token and keep it somewhere safe. If a token is lost, exposed, or no longer in use, Revoke it from the list to invalidate it, and generate a new one if you need to.