---
title: "Issue a new MCP access token"
method: POST
path: "/mcp/auth/tokens"
tags: ["mcp-auth"]
---

# Issue a new MCP access token

`POST /mcp/auth/tokens`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/mcp/auth/tokens`
- Auth: HTTP bearer

Generates a scoped access token for an MCP client to access this Focus Bear account. The raw token is returned ONCE and cannot be retrieved again — store it securely in your MCP client settings.

## Request body

- CreateExternalApiTokenDto
  - `scopes` string[], required: Scopes granted to this token
  - `label` string: Human-readable label for this token (e.g. "My MCP Client")
  - `agent_name` string: Name of the AI agent this token belongs to (e.g. "Captain Codebeard")

## Response `201`

- ExternalApiTokenIssuedResponseDto
  - `id` string, required: Token UUID
  - `label` string: Human-readable label
  - `agent_name` string: Name of the AI agent this token belongs to
  - `scopes` string[], required: Scopes granted to this token
  - `last_used_at` string, date-time: When the token was last used
  - `expires_at` string, date-time: When the token expires (null = never)
  - `created_at` string, required: When the token was created
  - `token` string, required: The raw token — shown ONCE at issuance, never retrievable again. Store it securely.

---

[API](https://skmtc.dev/focusbear/apis/focusbear-api.md) - [All operations](https://skmtc.dev/focusbear/apis/focusbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/focusbear/apis/focusbear-api/revisions/3a83a3b9a811?raw)