SEP-3094: Granular Citations Format - #3094
Open
karth295 wants to merge 4 commits into
Open
Conversation
Proposes a standard for MCP servers and clients to exchange granular, verifiable citations using Web Annotation selectors, citationRefs, and schema.org metadata on citation targets. Co-authored-by: Cursor <cursoragent@cursor.com>
Replace the preamble code block with template bullet fields so render-seps places SEP-3094 under Draft instead of Unknown. Co-authored-by: Cursor <cursoragent@cursor.com>
…rences to old initialize handshake to _meta Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.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.
SEP: Granular citations format
Many popular MCP clients (e.g. ChatGPT, Copilot) have bespoke formats for MCP servers to return rich citations.
Other popular MCP clients (e.g. Claude) only render citation chips from first-party features such as public web
search, making responses from MCP servers appear less trustworthy. Citations are an important mechanism for
professionals and academic researchers to verify the accuracy of LLM-generated responses.
This SEP proposes standardizing a mechanism for MCP servers and clients to exchange granular, verifiable
citations to resources or portions of resources — sentences, HTML elements, image regions, table rows. It reuses
existing MCP and web standards for selectors and fragments, such as MCP resource URIs, a subset of the W3C Web Annotation Data Model, and schema.org citations. It explicitly tries to avoid creating bespoke formats that have not gone
through rigorous review and real world usage.
Next steps