---
title: "Create MCP Token"
method: POST
path: "/mcp/tokens/create"
---

# Create MCP Token

`POST /mcp/tokens/create`

## Request

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

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

## Request body

- object
  - `external_user_id` string, required: Your unique identifier for the user.
  - `expires_in` integer: Seconds until the token expires. Defaults to 1 day; maximum 30 days.
  - `phone_number` string: 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).

## Response `200`

Successful request.

- object
  - `token` string: The Supernova MCP token. Treat it as a secret.
  - `expires_at` string, date-time: When the token expires, in ISO 8601 UTC.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized request.
- `429`: Too many requests. Limited to 600 requests per minute per client.

## Changes

- **2026-11-03** `f10ecfa12c00`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/knotapi/apis/knot-api/changes/mcp/tokens/create/post.md)

---

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