Skip to content

Add Events extension spec at Beta (SEP-3415) - #24

Merged
poita merged 3 commits into
mainfrom
events-beta-spec
Nov 20, 2026
Merged

poita merged 3 commits into
mainfrom
events-beta-spec

Conversation

@poita

@poita poita commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

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.
  • Layout follows ext-auth (.mdx with 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 uses poita for Peter). The spec's maintainer list matches.

Not in this PR

https://claude.ai/code/session_01QK1G3u2wRAfNHvu3jTy2nB


Generated by Claude Code

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
@poita poita self-assigned this Nov 19, 2026
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
poita marked this pull request as ready for review November 19, 2026 15:43
@poita
poita requested a review from a team as a code owner November 19, 2026 15:43
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QK1G3u2wRAfNHvu3jTy2nB
@poita
poita requested a review from clareliguori November 19, 2026 21:05
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>

@CaitieM20 CaitieM20 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved by Core Maintainers Vote

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.

3 participants