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

# Usage Policy & Pricing

> Authentication, pricing, and rate limits for the REST API, MCP, and CLI.

This page covers how the REST API, MCP, and CLI authenticate, what they cost, and their rate limits.

## Authentication

The REST API, MCP, and CLI all share the same credential scheme.

* **API Key**: a Bearer token in the form `{id}.{secret}`. Works across REST, MCP, and the CLI.
* **JWT**: MCP also accepts a JWT issued through OAuth (for conversational AI clients).

You can authenticate with a valid API Key or token regardless of the sign-in method you registered with.

For details on issuing and using keys, see [Authentication](https://docs.tiro.ooo/en/developers/fundamentals/authentication.md).

### Who issues keys

You can issue an account API key from [platform.tiro.ooo/me/api-keys](https://platform.tiro.ooo/me/api-keys) on **any plan**. It acts with your permissions in the workspaces you selected when you created it (every workspace you can currently access if you didn't select any). Only an admin of the relevant workspace or organization can issue a workspace or organization API key.

## What's free and what's paid

Reading notes, folders, share links, document templates, transcripts, and word memory costs no credits.

> [!NOTE]
>
> Wiki endpoints require a paid plan. A personal workspace needs **Pro or higher**, and a team workspace needs **Team or higher**. Calling them on a plan without access returns `402 Payment Required`.

The wiki gate applies the same way to REST and MCP (MCP `search_wiki`, `get_wiki_page`, `list_wiki_mentions`, `get_wiki_graph`).

| Response code | When it happens | How to resolve |
| - | - | - |
| `402` `WIKI_PLAN_REQUIRED` | The workspace plan can't use the wiki (Free, Lite, no subscription, or inactive) | Upgrade to Pro or higher for personal, Team or higher for teams |
| `402` `WIKI_NOT_ACTIVATED` | The plan qualifies, but an admin hasn't turned the wiki on | Have a workspace admin activate the wiki feature |

> [!NOTE]
>
> Charges for speech recognition (STT) and bulk LLM processing don't yet apply through the API or MCP.

## Rate limit

A single API Key can send up to **600 requests per 60 seconds**. Go over that and you get `429 Too Many Requests`, with `Retry-After` and `X-RateLimit-*` headers in the response telling you when to try again.

For the full response format, see [Error handling](https://docs.tiro.ooo/en/developers/fundamentals/error-handling.md).


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