Skip to main content
Create a key in the console under API keys. A key is shown once, when you create it: store it as SPIRAL_API_KEY and never commit it. Send it on every request:
A missing or invalid key answers 401 UNAUTHENTICATED. The key decides the organization and the key’s own spend cap and rate limits. GET /v1/me shows what the key can do. A key for agents or apps your own users reach can show only your own prices, never Spiral’s cost: see keys for your own users. The MCP server takes the same keys, as the same bearer token. Agents that support it can also connect to the MCP server with a browser sign-in instead: they register themselves, you sign in to Spiral and click Authorize, and Spiral gives that connection its own key. You can remove a connection under Settings › Connected apps.