---
title: "Unsubscribe (MCP Events)"
method: POST
path: "/tenants/{tenant_id}/mcp/events/unsubscribe"
tags: ["Destinations"]
---

# Unsubscribe (MCP Events)

`POST /tenants/{tenant_id}/mcp/events/unsubscribe`

## Request

- Base URL: `https://api.outpost.hookdeck.com/2025-07-01`
- URL: `https://api.outpost.hookdeck.com/2025-07-01/tenants/{tenant_id}/mcp/events/unsubscribe`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

**Experimental.** Serves the MCP Events `events/unsubscribe` method: deletes the tenant's
subscription for the event, arguments and callback URL in the request body, the `events/unsubscribe` params. Answers `422` with a
`NotFound` `mcp_error` when there is none, including when the tenant does not exist.
Admin API key only; answers `404` while MCP is not enabled (`EXPERIMENTAL_MCP_ENABLED`).

## Request body

- object: The `events/unsubscribe` params, forwarded as received.

## Response `200`

The subscription was deleted. The `events/unsubscribe` result.

- object
  - `resultType` 'complete', required

## Other responses

- `401`: Missing or invalid authentication credentials.
- `403`: The credentials are valid but not allowed to perform the request.
- `404`: Requested resource not found.
- `413`: Request body is larger than 1 MiB.
- `422`: The MCP request failed. `mcp_error` is a JSON-RPC error object with `data` only where the MCP Events spec defines it: `-32602` invalid params (a malformed request body also answers this) has no `data`, `-32023` not found (`data.kind` is `event` or `subscription`), `-32025` resource exhausted (`data.limit`, and `data.max` when there is one), `-32026` unsupported (`data.feature` and `data.value`, such as a delivery mode other than `webhook`), `-32027` callback endpoint error (`data.reason` names the failure category).
- `500`: Unexpected server error.
- `503`: A subscription's callback verification could not run (`data.code` is `verification_unavailable`), the subscription is being changed by concurrent requests (retry), or the MCP event definitions are invalid (the reason is in the server log).

## Changes

- **2026-11-12** `74708d21de8c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hookdeck/apis/outpost-api/changes/tenants/:tenant_id/mcp/events/unsubscribe/post.md)

---

[API](https://skmtc.dev/hookdeck/apis/outpost-api.md) - [All operations](https://skmtc.dev/hookdeck/apis/outpost-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hookdeck/apis/outpost-api/revisions/74708d21de8c?raw)