KNknotapi

Create MCP Token

Changed on

Create a short-lived token to connect your agent to the Supernova MCP for a given user.

post/mcp/tokens/create

Request

  • Base URL
    https://production.knotapi.com
  • URL
    https://production.knotapi.com/mcp/tokens/create
  • Auth
    HTTP basic

Request body

external_user_idstring required

Your unique identifier for the user.

expires_ininteger

Seconds until the token expires. Defaults to 1 day; maximum 30 days.

phone_numberstring

User's phone number in E.164 format. Strongly recommended and required for the Supernova MCP to create sign-in links, necessary for running authenticated actions (i.e. those behind a login).

Example request

{
  "external_user_id": "123abc",
  "expires_in": 3600,
  "phone_number": "+12025550123"
}

Response

Successful request.

tokenstring

The Supernova MCP token. Treat it as a secret.

expires_atstring date-time

When the token expires, in ISO 8601 UTC.

Example response

{
  "token": "sn_prod_wyLZTDc3_HzXo5lcRkkbZpnmFfg5DU63nHnUsyPQbi0",
  "expires_at": "2026-10-21T15:30:00Z"
}

Changes