cd /news/agent-protocols/mcp-events-becomes-an-official-beta-… · home › topics › agent-protocols › article
[ARTICLE · art-173917] src=modelcontextprotocol.io ↗ pub= topic=agent-protocols verified=true sentiment=↑ positive

MCP Events becomes an official Beta extension

The Model Context Protocol project has published an official Events extension, `io.modelcontextprotocol/events`, now in Beta with its specification finalized as SEP-3415 and maintained by the Tasks and Events Working Group. The extension adds parameterized, payload-carrying event subscriptions with opaque cursors for resumption, `truncated: true` signaling when events were skipped, stable `eventId` deduplication, and three optional delivery modes (webhook, push, poll) that client SDKs select by preference. It targets reacting to upstream activity, waking unattended background agents, and filtered streams such as "P1 incidents for service X," while long-running operations the client itself started remain the domain of the Tasks extension.

key takeaway

MCP clients can now subscribe to typed events with arguments and payloads, store the returned cursor after each delivery, and resubscribe from it after a disconnect — treating `truncated: true` as a signal that events were skipped.

read5 min views3 publishedNov 19, 2026
MCP Events becomes an official Beta extension
Image: Modelcontextprotocol (auto-discovered)
[ext-events repository](https://github.com/modelcontextprotocol/ext-events)contains the full specification for the official Events extension (

`io.modelcontextprotocol/events`). [SEP-3415](https://modelcontextprotocol.io/seps/3415-events-extension)is Final, and the extension is in Beta. The

[Tasks and Events Working Group](https://modelcontextprotocol.io/community/working-groups/tasks-events)maintains it.

modelcontextprotocol/ext-events #

Full specification and documentation for MCP Events.

#

MCP already has notifications such as notifications/resources/updated and the list_changed family. They don’t cover this use case:

  • No parameters or payload. A notification says that a URI or a list changed. It can’t express “a P1 incident was created for service X”, because there are no subscription arguments, no payload schema and no payload.
  • A live connection is required. Notifications arrive only on an opensubscriptions/listen stream. A client that isn’t connected receives nothing.
  • No resumption. There is no cursor, so anything that happens during a disconnect is lost, and the client can’t tell that it missed anything.

#

Capability negotiation. The server advertisesio.modelcontextprotocol/events in itsserver/discover capabilities. The client may declare the same identifier in its per-request capabilities. 2. Discovery. The client callsevents/list . Each event type has aname , aninputSchema for subscription arguments, apayloadSchema for the data it delivers, and thedelivery modes it supports. 3. Subscription. The client subscribes with an event name and arguments,

using one of the modes the event type lists. A`null` cursor means “start
from now”.

Delivery. Each event arrives as an occurrence:{eventId, name, timestamp, data, cursor} . The client stores the cursor after each delivery. 5. Resumption. After a disconnect or a restart, the client resubscribes with its stored cursor. If the server can’t serve from that position, it says so withtruncated: true , so the client knows that events were skipped. 6. Reaction. The client SDK hands each event to the agent runtime, which decides how to react, for example by starting a new agent turn.

#

None of the three modes is mandatory. An event type lists any non-empty subset of them, and the client SDK picks one it can use. SDKs typically prefer webhook when the client has a callback endpoint, then push, then poll. A client can override the choice per subscription.

#

Events are a good fit when your use case involves: Reacting to upstream activity. New messages, repository pushes, payments, incidents or calendar changes that an agent should act on.

Unattended agents. Background agents that run when no user is present and need to be woken by something happening.

Filtered streams. Subscriptions that narrow a large stream with arguments, such as “P1 incidents for service X” or “email from this sender”. If the client is waiting for the result of a long-running operation it started itself, use

Tasksinstead.

#

Cursors are opaque, server-defined positions in the event stream. They make delivery at-least-once when the upstream is durable and the client resumes from its last cursor.

  • Replay is optional per event type. A server returnscursor: null for an event type that has no addressable history. The client then always starts from now, and accepts that events during a gap can’t be recovered.
  • Bounded replay. A client can passmaxAgeMs with a stale cursor, so that a host that was offline for a week gets at most, say, the last five minutes.
  • Deduplication.eventId is stable for an upstream event, so a client can discard duplicates within a subscription.
  • Ordering. Poll and push deliver events in order within a subscription. Webhook ordering is best-effort, and thetimestamp field orders events.

#

  • Payloads are untrusted data. Event payloads come from external systems and can carry prompt injection. Treat them like tool results, and sanitize or sandbox them before they reach a model.
  • Minimal payloads. Servers should send enough to identify and triage an event, such as a sender, subject and ID, and let the client fetch full content with tools.
  • Authorization at every step. The server checks permission at subscribe time, re-checks at delivery time, and terminates the subscription if access is revoked. Receiving an event never authorizes the agent to act: its follow-up tool calls go through normal MCP authorization.
  • Webhook hardening. Deliveries are signed withStandard Webhooks HMAC signatures. Callback URLs must behttps , the server verifies an endpoint before it delivers to it, and it validates destination IPs to prevent SSRF.

#

1

Declare support

Include the extension in the per-request capabilities you send:Don’t send

events/* requests to a server that hasn’t advertised the extension. 2

Discover and subscribe

Call

events/list, validate subscription arguments against each event type’s inputSchema, and pick a delivery mode from its delivery list. 3

Persist cursors

Store the latest cursor for each subscription durably, and resume from it after a restart. Treat

truncated: true as a possible gap, and re-read authoritative state with tools if it matters. 4

Deliver events safely

Deduplicate by

eventId, and treat payloads as untrusted before passing them to a model.

1

Advertise support

Include the extension in your

server/discover capabilities. Set listChanged if you send notifications/events/list_changed: 2

Describe event types

Return each event type from events/list with its inputSchema, payloadSchema and supported delivery modes. Evolve schemas additively, and publish a breaking change under a new event name. 3

Use upstream identifiers

Use the upstream system’s stable event ID as 

eventId, and encode the upstream position in the cursor, so that clients can resume and deduplicate. 4

Check authorization

Verify that the principal may subscribe with the given arguments, and terminate subscriptions when access is revoked.

#

MCP Events is an extension to the

core MCP specification. It requires protocol revision2026-07-28 or later. client matrixfor extension support across clients. Events requires explicit opt-in from both client and server.

#

The Events extension is specified in the

ext-events repository. It uses the standard MCP extension negotiationmechanism. For the design rationale, see

SEP-3415.

── more in #agent-protocols 4 stories · sorted by recency
── more on @model context protocol 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/mcp-events-becomes-a…] indexed:0 read:5min 2026-11-19 · —