Skip to content

docs(spec): MCP 2026-07-28 protocol upgrade (spec 058, blocked on mcp-go)#533

Open
Dumbris wants to merge 2 commits into
mainfrom
057-mcp-2026-upgrade
Open

docs(spec): MCP 2026-07-28 protocol upgrade (spec 058, blocked on mcp-go)#533
Dumbris wants to merge 2 commits into
mainfrom
057-mcp-2026-upgrade

Conversation

@Dumbris
Copy link
Copy Markdown
Member

@Dumbris Dumbris commented May 28, 2026

Summary

Adds spec 057 capturing the scope of upgrading mcpproxy to the MCP 2026-07-28 protocol revision. This is a spec-only PR — no code changes. Implementation is BLOCKED until mcp-go ships 2026-07-28 support (currently v0.54.x → 2025-11-25).

Tracking issue: #532

What's in the spec

  • 5 prioritized user stories (P1: negotiation/handshake, required headers, stateless+per-identity curation; P2: MRTR, additive features)
  • 27 functional requirements, 8 measurable success criteria
  • Breaking changes: stateless sessions, server/discover + per-request _meta, required Mcp-Method/Mcp-Name/MCP-Protocol-Version headers, MRTR, subscriptions/listen, -32002→-32602
  • Additive adoption: CacheableResult, deterministic ordering, JSON Schema 2020-12, trace context in activity log
  • Prominent Dependency Gate + Assumptions (dual-version support) + Out of Scope

Why merge a blocked spec

Locks the analysis while it's fresh and gives a stable reference for the tracking issue and the scheduled mcp-go watcher. Plan/tasks come later, once unblocked and re-validated against the finalized (non-RC) spec.

Test plan

  • N/A — documentation only; no code paths touched
  • Re-validate against finalized 2026-07-28 spec before /speckit.plan

@Dumbris
docs(spec): add spec 057 — MCP 2026-07-28 protocol upgrade
8837828 
Related #532

Captures the full scope of upgrading mcpproxy to the MCP 2026-07-28
spec revision. Status is BLOCKED on mcp-go shipping 2026-07-28 support
(currently v0.54.x targets 2025-11-25 only).

## Changes
- specs/057-mcp-2026-upgrade/spec.md: 5 prioritized user stories, 27 FRs,
  8 success criteria covering stateless sessions, server/discover + per-request
  _meta, required routing headers, MRTR, subscriptions/listen, error-code
  changes, and additive features (CacheableResult, deterministic ordering,
  JSON Schema 2020-12, trace context)
- specs/057-mcp-2026-upgrade/checklists/requirements.md: spec quality checklist
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 28, 2026 •
edited
Loading

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 8837828
Status: ✅  Deploy successful!
Preview URL: https://d3b39f94.mcpproxy-docs.pages.dev
Branch Preview URL: https://058-mcp-2026-upgrade.mcpproxy-docs.pages.dev

View logs

@codecov-commenter
Copy link
Copy Markdown

codecov-commenter commented May 28, 2026

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 28, 2026 •
edited
Loading

📦 Build Artifacts

Workflow Run: View Run
Branch: 057-mcp-2026-upgrade

Available Artifacts

  • archive-darwin-amd64 (27 MB)
  • archive-darwin-arm64 (25 MB)
  • archive-linux-amd64 (16 MB)
  • archive-linux-arm64 (14 MB)
  • archive-windows-amd64 (27 MB)
  • archive-windows-arm64 (24 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (21 MB)
  • installer-dmg-darwin-arm64 (18 MB)

How to Download

Option 1: GitHub Web UI (easiest)

  1. Go to the workflow run page linked above
  2. Scroll to the bottom "Artifacts" section
  3. Click on the artifact you want to download

Option 2: GitHub CLI

gh run download 26558739048 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

@Dumbris
docs(spec): renumber MCP 2026-07-28 upgrade spec 057 -> 058
88c86df 
Resolves spec-number collision with PR #531 (in-proxy profiles),
which keeps 057.
@Dumbris Dumbris closed this May 28, 2026
@Dumbris Dumbris deleted the 057-mcp-2026-upgrade branch May 28, 2026 06:29
@Dumbris Dumbris changed the title docs(spec): MCP 2026-07-28 protocol upgrade (spec 057, blocked on mcp-go) docs(spec): MCP 2026-07-28 protocol upgrade (spec 058, blocked on mcp-go) May 28, 2026
@Dumbris Dumbris reopened this May 28, 2026
@Dumbris Dumbris mentioned this pull request Jun 1, 2026
Open
@Dumbris
Copy link
Copy Markdown
Member Author

Dumbris commented Jun 1, 2026

Critic (Codex) review — Dumbris's PR #533
Verdict: request_changes
Strengths: The PR is scoped to the Spec 058 MCP 2026-07-28 upgrade documentation and checklist.
Findings:

@Dumbris
Copy link
Copy Markdown
Member Author

Dumbris commented Jun 1, 2026

Critic (Codex) review — Dumbris's PR #533
Verdict: accept
Head: 88c86df50885809ab1b8e705f8baa81e4ae7296d

Strengths: Spec-only scope is clear, the dependency gate is explicit, the spec calls out backward compatibility and proxy-specific header/stateless risks, and current mcp-go release data still supports the blocked-on-library premise (go list -m -versions and GitHub latest release both show v0.54.1). CI is green for all non-skipped checks.

Findings: none

Provenance check: ok

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@Dumbris @codecov-commenter