FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

SEP-3415: Events Extension by pja-ant · Pull Request #3415 · modelcontextprotocol/modelcontextprotocol · GitHub

Repository navigation

SEP-3415: Events Extension - #3415

Draft
pja-ant wants to merge 2 commits into
modelcontextprotocol:mainfrom
pja-ant:pja/sep-events-extension
Draft

pja-ant wants to merge 2 commits into
modelcontextprotocol:mainfrom
pja-ant:pja/sep-events-extension

Conversation

pja-ant commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

Defines Events, an extension (io.modelcontextprotocol/events) that lets an MCP client subscribe to things that happen in an upstream system, such as a Slack message, a repository push or a PagerDuty incident, and have an agent react without the user being present.

  • A server lists event types with events/list: a name, an inputSchema for subscription arguments, a payloadSchema, and the delivery modes it supports.
  • Three delivery modes, none mandatory: poll (events/poll), push (a long-lived events/stream), and webhook (events/subscribe, signed per Standard Webhooks, with a refreshed TTL).
  • Opaque cursors let a client resume after a disconnect. Replay is optional per event type, and truncated: true signals skipped events.

This is the design sketch from the Triggers & Events Working Group, discussed in its weekly meetings, written in SEP format. To fit the 2026-07-28 protocol, the capability moves under extensions, list_changed rides on a subscriptions/listen filter field, and results carry resultType.

For reviewers:

  • The SEP requests five general-purpose error codes. The numbers (-32023 to -32027) are provisional.
  • The reference implementation in an official SDK is outstanding.
  • Open Questions lists eight items, including whether to fold these errors into InvalidParams.

Verified with prettier --check, and every in-page link resolves to a heading. The file keeps its 0000- name, so render-seps skips it.

AI assistance: an AI coding assistant restructured the design sketch into SEP format and aligned it with the current protocol. The design, design decisions and review are by @pja-ant.

Adds an Extensions Track SEP for Events, an extension that lets a client
subscribe to things that happen in an upstream system and have an agent
react to them without the user being present.

The SEP is the Triggers & Events Working Group's design sketch written in
SEP format and aligned with the 2026-07-28 protocol. A server lists event
types with events/list, and delivers occurrences by poll, push or webhook,
with opaque cursors for resuming after a disconnect.
pja-ant changed the title SEP-0000: Events Extension SEP-3415: Events Extension Oct 5, 2026

This branch has not been deployed

No deployments
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant


Back | FazBrowse Home | New Git URL