FOfocusbear
mcp-auth

Issue a new MCP access token

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.

post/mcp/auth/tokens

Request

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

Request body

scopesstring[] required

Scopes granted to this token

labelstring

Human-readable label for this token (e.g. "My MCP Client")

agent_namestring

Name of the AI agent this token belongs to (e.g. "Captain Codebeard")

Example request

{
  "scopes": [
    "tasks:read",
    "tasks:write"
  ],
  "label": "My MCP Client",
  "agent_name": "Captain Codebeard"
}

Response

idstring required

Token UUID

labelstring

Human-readable label

agent_namestring

Name of the AI agent this token belongs to

scopesstring[] required

Scopes granted to this token

last_used_atstring date-time

When the token was last used

expires_atstring date-time

When the token expires (null = never)

created_atstring required

When the token was created

tokenstring required

The raw token — shown ONCE at issuance, never retrievable again. Store it securely.

Changes

No recorded changes to this operation across all 1 revision of this API.