Skip to content

Return structured citations to clients that advertise citation rendering capability, following draft SEP-3094 format - #148

Draft
karth295 wants to merge 1 commit into
perplexityai:mainfrom
karth295:sep-3094-granular-citations
Draft

karth295 wants to merge 1 commit into
perplexityai:mainfrom
karth295:sep-3094-granular-citations

Conversation

@karth295

@karth295 karth295 commented Oct 5, 2026 •

Copy link
Copy Markdown

What changed

Clients that advertise that they support rendering structured citations will get back structured citations, rather than having citation metadata dumped into the markdown response. There is no change for clients that do not opt in.

See modelcontextprotocol/modelcontextprotocol#3094 for more details on the draft spec.

Before:

{
  "content": [
    {
      "type": "text",
      "text": "Supported claim[1].\n\nCitations:\n[1] https://example.com/source\n"
    }
  ]
}

After:

{
  "content": [
    {
      "type": "text",
      "text": "Supported claim[1]."
    }
  ],
  "citations": [
    {
      "id": "1",
      "name": "Source",
      "url": "https://example.com/source#:~:text=Supporting%20passage",
      "text": "Supporting passage"
    }
  ]
}

@karth295 karth295 changed the title feat: return SEP-3094 citations from all four tools Return structured citations to clients that advertise citation rendering capability, following draft SEP-3094 format Oct 5, 2026
Clients that declare citation support get a top-level citations array while answer text stays unchanged. Clients that do not keep the existing footer and search list.

Co-authored-by: Cursor <cursoragent@cursor.com>
@karth295
karth295 force-pushed the sep-3094-granular-citations branch from 49fadac to 8d52ff3 Compare October 5, 2026 05:58

This branch has not been deployed

No deployments
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