Repository navigation
Add Events extension spec at Beta (SEP-3415) - #24
Merged
Merged
Conversation
Publishes the Events extension (io.modelcontextprotocol/events) under specification/beta/events/, derived from the Specification and Security Implications sections of SEP-3415 (Final, merged in modelcontextprotocol/modelcontextprotocol@8a18b4b). Rationale, open questions and SDK guidance stay in the SEP and are linked. Also lists the extension in the README and updates Peter's handle to @poita. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QK1G3u2wRAfNHvu3jTy2nB
Matches docs/community/working-groups/tasks-events.mdx in the main repo: the WG is now Tasks and Events, with Luca Chang and Caitie McCaffrey as additional leads. Updates the charter links to the new page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QK1G3u2wRAfNHvu3jTy2nB
poita
marked this pull request as ready for review
November 19, 2026 15:43
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QK1G3u2wRAfNHvu3jTy2nB
poita
added a commit
to modelcontextprotocol/modelcontextprotocol
that referenced
this pull request
Nov 20, 2026
<!-- claude-projects-attribution: {"github_login":"poita"} -->
_Requested by **Peter** · [project
thread](https://claude.ai/code/project/chan_013VZyPu2nt8YAcwA65s6UqV?thread=cmsg_013VZyPu2nt8YAcwA65s6UqVJyt1MeecHy1rTFjH8sxiG5)_
## Summary
Registers the Events extension (`io.modelcontextprotocol/events`) now
that
[SEP-3415](#3415)
is Final. The specification itself lives in
[ext-events](https://github.com/modelcontextprotocol/ext-events) and is
not duplicated here.
- `docs/extensions/overview.mdx`: new **MCP Events** section with the
ext-events card and a table listing Events as *Beta, destination not yet
stated* (the SEP does not state Stable or Core).
- `docs/extensions/events/overview.mdx`: new overview page at the same
depth as the Tasks and Apps pages: motivation, how it works (with a
sequence diagram), delivery modes, when to use it, cursors and
guarantees, security model, and a client and server implementation
guide. Normative detail stays in ext-events.
- `docs/docs.json`: adds an **Events** group to the Extensions tab.
- `docs/extensions/client-matrix.mdx`: adds Events to the extension
overview table and an Events column to the support matrix (evidence
below).
- `docs/community/working-groups/tasks-events.mdx`: links ext-events and
SEP-3415 under Resources, and marks the Events SEP work item Final.
- `seps/3415-events-extension.md` (and the generated MDX): names the
Tasks and Events Working Group and lists all four leads (@clareliguori,
@poita, @LucaButBoring, @CaitieM20) as Extension Maintainers, and says
the spec is published in ext-events under `specification/beta/events/`
([ext-events#24](modelcontextprotocol/ext-events#24)).
## Events client support evidence
Checked 2026-11-19. "Partial" means webhook delivery only. Most
implementations target the pre-Final draft.
| Client | Marked | Evidence |
| --- | --- | --- |
| ChatGPT | Partial | [OpenAI MCP Events
guide](https://developers.openai.com/plugins/build/mcp-events): "ChatGPT
supports webhook delivery and callback verification from the draft MCP
Events specification." Polling and streaming are not supported. Work
chats and dots only. |
| MCPJam | ✓ | Source on `main`
([`sdk/src/mcp-client-manager/events-ext.ts`](https://github.com/MCPJam/inspector/blob/main/sdk/src/mcp-client-manager/events-ext.ts),
[CLI
docs](https://github.com/MCPJam/inspector/blob/main/docs/cli/events.mdx)):
poll, push and webhook. |
| Mastra | Not listed (no existing row; supports poll, push, webhook) |
`@mastra/mcp` 2.10.0 on npm ships client poll, push and webhook drivers
(`dist/client/events/`). |
| Hermes Agent | Not listed (no existing row; supports webhook only) |
[`tools/mcp_tool_events.py`](https://github.com/NousResearch/hermes-agent/blob/main/tools/mcp_tool_events.py):
`events/subscribe` only. |
| Vercel AI SDK | Not listed (no existing row; supports webhook only) |
`@ai-sdk/mcp` 2.0.101 on npm (`src/tool/mcp-events.ts`):
`events/subscribe` only. |
| TanStack AI | Not listed (no existing row; supports webhook only) |
`@tanstack/ai-mcp` 1.3.0 on npm (`src/events/wire.ts`):
`events/subscribe` only. |
Cross-checked against the [field report in
experimental-ext-triggers-events#17](modelcontextprotocol/ext-events#17)
and [Hookdeck's support
table](https://hookdeck.com/webhooks/guides/what-are-mcp-events). No
support found in the source of fast-agent, Goose, mcpc or MCP Inspector.
Claude Code has an [open feature
request](anthropics/claude-code#101434).
## Checks
- `npm run check:docs` passes (format, MDX comments, no broken links).
https://claude.ai/code/session_01QK1G3sQVer24zRNwffmicu
---
_Generated by [Claude Code](https://claude.ai/code)_
---------
Co-authored-by: Claude <noreply@anthropic.com>
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
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Peter · project thread
Summary
SEP-3415 (Events Extension, Extensions Track) is Final, merged in modelcontextprotocol/modelcontextprotocol#3415. Per SEP-3392, the accepted extension moves to
specification/beta/<name>. This PR adds it there.specification/beta/events/events.mdx: the normative spec. It is the SEP's Specification section verbatim, plus its Security Implications as "Security Considerations", with a short introduction. Rationale, open questions, the reference implementation notes and the non-normative SDK guidance stay in the SEP and are linked from the spec. SEP-relative links now point to the merged SEPs, and wording that referred to "this SEP" is adjusted.ext-auth(.mdxwith Mintlify frontmatter). A directory is used so a schema and, at Stable, revision folders can live alongside it.README.md,CONTRIBUTING.md: list the extension and its stage, and bring the WG name, charter link and leads in line with the Tasks and Events WG page (adds Luca Chang and Caitie McCaffrey, and usespoitafor Peter). The spec's maintainer list matches.Not in this PR
schema.ts/schema.jsonyet; the SEP defines the wire format in prose and JSON examples only. Follow-up.subscriptions/listenoverlap with SEP-3371 is left as is, as agreed.docs/design-sketch-proposal.mdis untouched. Open PRs Support long polling in events/poll via waitMs #5, Require event subscriptions to be read-only and non-destructive #13 and Discuss model-facing event subscription tools #14 edit the sketch and Draft: Task Event Sources #2 and Resource Events: keep copies of resources current #19 add separate proposals, so none conflict at the file level. Require event subscriptions to be read-only and non-destructive #13 (read-only, non-destructive subscriptions) and Support long polling in events/poll via waitMs #5 (waitMslong polling) propose normative changes that would now need to target this spec instead. Make the working group leads the code owners #12 also touches maintainer handles (CODEOWNERS).https://claude.ai/code/session_01QK1G3u2wRAfNHvu3jTy2nB
Generated by Claude Code