---
title: "Revoke MCP Tokens"
method: POST
path: "/mcp/tokens/revoke"
---

# Revoke MCP Tokens

`POST /mcp/tokens/revoke`

## Request

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

Revoke all of a user's Supernova MCP tokens and the sign-in links created with them (see [Knot Zero links](/api-reference/products/card-switcher/create-knot-zero-link)).

## Request body

- object
  - `external_user_id` string, required: Your unique identifier for the user.

## Response `200`

Successful request.

- object
  - `revoked` integer: The number of Supernova MCP tokens revoked. `0` if the user had no active tokens.
  - `revoked_links` integer: The number of sign-in links ([Knot Zero links](/api-reference/products/card-switcher/create-knot-zero-link)) created with those tokens that were revoked. Links you created directly are not affected.

## 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/revoke/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)