The MCP subscriptions listen stream and notification delivery

See also

Sources

1. 1
   The 2026-07-28 message flow diagram shows the server answering a subscriptions listen request with a notification named notifications slash subscriptions slash acknowledged.

   Model Context Protocol specification 2026-07-28, Server Features: Tools · Tools > Message Flow diagram · Checked 2026-09-05
2. 2
   The 2026-07-28 Resources page Message Flow section is a mermaid sequenceDiagram with no prose, and it shows subscriptions/listen (resourceSubscriptions) followed by notifications/subscriptions/acknowledged and then notifications/resources/updated.

   Model Context Protocol specification 2026-07-28, Resources · Message Flow · Checked 2026-09-30
3. 3
   The Subscriptions page states in prose that the server MUST send notifications/subscriptions/acknowledged as the first message for a subscription and MUST NOT send any notification on that subscription before it.

   Model Context Protocol specification 2026-07-28, Subscriptions · Acknowledgment, first paragraph · Checked 2026-09-30
4. 4
   The repository source file for the 2026-07-28 Subscriptions page was reported to contain no mermaid block and four JSON code blocks, the same inventory as the published page.

   docs/specification/2026-07-28/basic/patterns/subscriptions.mdx · whole file · Checked 2026-09-30
5. 5
   The MCP 2026-07-28 Subscriptions page, as served, contains four json code blocks and one table and contains no mermaid block and no image.

   Model Context Protocol specification 2026-07-28, Subscriptions · whole page · Checked 2026-09-30
6. 6
   The 2026-07-28 Tools Message Flow diagram places the update steps inside an 'opt listChanged' block in which the client first sends subscriptions/listen (toolsListChanged: true) and the server sends notifications/subscriptions/acknowledged before notifications/tools/list_changed.

   Model Context Protocol specification 2026-07-28, Server Features: Tools · Message Flow, mermaid block, 'opt listChanged' group · Checked 2026-09-30
7. 7
   On the 2026-07-28 Tools page the string notifications/subscriptions/acknowledged appears only inside the Message Flow mermaid block; the page's prose does not mention the acknowledgement.

   Model Context Protocol specification 2026-07-28, Server Features: Tools · whole page; sole occurrence under Message Flow · Checked 2026-09-30
8. 8
   MCP revision 2026-07-28 replaced the Streamable HTTP GET endpoint and the resources/subscribe and resources/unsubscribe methods with subscriptions/listen, a single long-lived POST-response stream for opted-in server-to-client change notifications.

   Model Context Protocol specification 2026-07-28, Key Changes · section Major changes, item 4 · Checked 2026-09-30
9. 9
   In Streamable HTTP under MCP revision 2026-07-28, long-lived change notifications are delivered on the SSE response stream of a subscriptions/listen POST, while request-scoped notifications such as notifications/progress and notifications/message flow only on the response stream of the request they relate to.

   Model Context Protocol specification 2026-07-28, Streamable HTTP · section Receiving Messages, paragraph beginning Long-lived notification streams · Checked 2026-09-30
10. 10
    In MCP revision 2026-07-28 a client cancels a subscriptions/listen subscription by closing the SSE stream on Streamable HTTP, or by sending notifications/cancelled referencing the subscriptions/listen request ID on stdio.

    Model Context Protocol specification 2026-07-28, Subscriptions · section Cancellation, first bullet · Checked 2026-09-30
11. 11
    In MCP revision 2026-07-28 the server MUST send notifications/subscriptions/acknowledged before any other notification on a subscription; on stdio this ordering is defined per subscription ID rather than per channel, so messages belonging to other subscriptions MAY be interleaved before it.

    Model Context Protocol specification 2026-07-28, Subscriptions · section Acknowledgment, first paragraph · Checked 2026-09-30
12. 12
    On stdio in MCP revision 2026-07-28, if the connection is terminated and then re-established the client MUST re-send subscriptions/listen to re-establish its subscriptions, because the server holds no subscription state across reconnections.

    Model Context Protocol specification 2026-07-28, Subscriptions · section Cancellation, subsection Graceful Closure, paragraph beginning On stdio · Checked 2026-09-30
13. 13
    On stdio in MCP revision 2026-07-28 clients MUST correlate notifications delivered for an active subscriptions/listen request using the io.modelcontextprotocol/subscriptionId field in _meta.

    stdio · section Receiving Messages, numbered item 3 · Checked 2026-09-30
14. 14
    The MCP 2026-07-28 Cancellation page says a server MUST send notifications/cancelled referencing a subscriptions/listen request ID when it tears down that subscription stream, and MUST NOT send notifications/cancelled for any other purpose.disputed

    Cancellation - MCP specification revision 2026-07-28 · introduction, second paragraph; section Behavior Requirements item 2 · Checked 2026-09-30
15. 15
    The MCP 2026-07-28 Subscriptions page says that a server ending a subscription on its own initiative SHOULD send a successful subscriptions/listen response (resultType complete) before closing the stream, and describes no server-sent notifications/cancelled.disputed

    Model Context Protocol specification 2026-07-28, Subscriptions · section Cancellation, second bullet, and subsection Graceful Closure · Checked 2026-09-30
16. 16
    A client whose requested toolsListChanged filter is silently dropped from the subscription acknowledgment receives no notification, so the caching page's invalidation scenario never applies to it even though the server advertised listChanged.inferred

    Model Context Protocol specification 2026-07-28, Subscriptions · Acknowledgment section combined with the caching page's Interaction with Notifications · Checked 2026-09-05
17. 17
    The subscriptions listen stream replaces the former resources subscribe request, so resource subscriptions and tool list notifications now share one filter-based mechanism rather than running in parallel.

    Model Context Protocol specification 2026-07-28, Subscriptions · Subscriptions · Checked 2026-09-05
18. 18
    The subscriptions page states that a server MUST NOT send notification types the client has not explicitly requested.

    Model Context Protocol specification 2026-07-28, Subscriptions · Subscriptions · Checked 2026-09-05
19. 19
    The Resources page does not state what becomes of a notifiable event that occurs while no client holds a matching subscription; no queueing, retention or replay language appears in its prose, its code samples or its diagram.

    Model Context Protocol specification 2026-07-28, Resources · whole page · Checked 2026-09-05
20. 20
    The Tools page depicts a client re-issuing the tools list request after a notification inside an optional fragment of its message flow diagram rather than requiring it.inferred

    Model Context Protocol specification 2026-07-28, Server Features: Tools · Tools > Message Flow diagram · Checked 2026-09-05
21. 21
    Delivery of a tool list changed notification to a subscribed client is a SHOULD rather than a MUST.

    Model Context Protocol specification 2026-07-28, Server Features: Tools · Tools > List Changed Notification · Checked 2026-09-05
22. 22
    A subscription filter type the server does not support is omitted from the acknowledgment rather than raising an error and the client side check that would catch the omission is a SHOULD.

    Model Context Protocol specification 2026-07-28, Subscriptions · Subscriptions, filter negotiation · Checked 2026-09-05
23. 23
    The Model Context Protocol defines a subscriptions listen stream that a client opens to receive server notifications.

    Model Context Protocol specification 2026-07-28, Subscriptions · Subscriptions · Checked 2026-09-05
24. 24
    Resumable server-sent event streams via the Last-Event-ID header are not supported in the 2026-07-28 revision.

    Model Context Protocol specification 2026-07-28, Streamable HTTP · Streamable HTTP · Checked 2026-09-05
25. 25
    Client reconnection after a dropped stream is graded MAY and the specification publishes no backoff schedule no retry cap and no way to learn what was missed.

    Model Context Protocol specification 2026-07-28, Streamable HTTP · Streamable HTTP · Checked 2026-09-05
26. 26
    The subscriptions page states a client obligation for the standard input and output transport: a client MUST demultiplex incoming notifications by subscription identifier.

    Model Context Protocol specification 2026-07-28, Subscriptions · Subscriptions, stdio transport · Checked 2026-09-05
27. 27
    In the 2026-07-28 revision a server that declared the list changed capability SHOULD send the tool list changed notification to clients that have opened a subscriptions listen stream with the tools list changed filter set to true.

    Model Context Protocol specification 2026-07-28, Server Features: Tools · Tools > List Changed Notification · Checked 2026-09-05
28. 28
    The specification does not state what becomes of a notifiable event that occurs while no client holds a matching subscription; neither the subscriptions page the streamable transport page the tools page nor the changelog addresses retention queueing or replay.

    Model Context Protocol specification 2026-07-28, Subscriptions · Subscriptions, whole page · Checked 2026-09-05
29. 29
    Multi Round-Trip Requests do not share the long-lived connection machinery that subscriptions use.inferred

    Model Context Protocol specification 2026-07-28, Multi Round-Trip Requests · Multi Round-Trip Requests · Checked 2026-09-05

Documents

Cite this page

WarmTransfer. (2026, September 30). The MCP subscriptions listen stream and notification delivery. WarmTransfer. https://warmtransfer.net/knowledge/mcp-subscriptions-listen

@misc{warmtransfer-mcp-subscriptions-listen,
  title  = {The MCP subscriptions listen stream and notification delivery},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/mcp-subscriptions-listen},
  note   = {Verified 2026-09-30}
}