From 11d3eaf74277c27c50d65e60305a4e5c891bc804 Mon Sep 17 00:00:00 2001 From: john-the-dev <52230987+john-the-dev@users.noreply.github.com> Date: Mon, 31 Aug 2026 02:57:14 -0700 Subject: [PATCH] =?UTF-8?q?grade(mcp):=20B=20=E2=80=94=20structure=20verif?= =?UTF-8?q?ied,=20citations=20one=20spec=20revision=20behind?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit First evidence-graded review of entries/mcp.md, following the invitation in #22. Verified against the primary source the entry itself cites (modelcontextprotocol.io/docs/learn/architecture, checked 2026-08-31): three participants, two layers, JSON-RPC 2.0 data layer, stdio + Streamable HTTP. All four hold, so nothing here is wrong. B rather than A, because the citations have aged past the content: - the entry links specification/2025-06-18 twice; the live spec is 2026-07-28 - its own last_verified said 2026-07-29 — one day AFTER that revision — so the date asserted a freshness the body did not have - 2026-07-28 makes MCP stateless with a mandatory server/discover and deprecates sampling and logging; this entry frames the data layer around lifecycle messages and mentions neither server/discover nor elicitation That is the rubric's "accurate-but-aging, note the caveat in evidence", not "partially superseded" — the structure is current, the references are not. The revision itself is already covered by the sibling entry mcp-stateless, so this entry does not need to absorb it; it needs its citations refreshed, which is a separate change from grading it. validate.mjs: 59 entries valid, warnings 48 -> 47. Co-Authored-By: Claude Opus 5 (1M context) --- entries/mcp.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/entries/mcp.md b/entries/mcp.md index 50a49c5..1e0345f 100644 --- a/entries/mcp.md +++ b/entries/mcp.md @@ -5,11 +5,15 @@ url: https://modelcontextprotocol.io/docs/learn/architecture category: tools source_type: docs status: current -grade: unrated # seeded baseline — pending first evidence-graded review (see GRADING.md) +grade: B added: 2026-07-14 -last_verified: 2026-07-29 +last_verified: 2026-08-31 superseded_by: null -evidence: [] +evidence: + - "Structural claims re-checked against the cited primary source and all hold: three participants (host/client/server), two layers, JSON-RPC 2.0 data layer, stdio + Streamable HTTP transports — modelcontextprotocol.io/docs/learn/architecture (checked 2026-08-31)" + - "B not A: the entry cites specification/2025-06-18 in two places while the live spec is 2026-07-28, and its own last_verified (2026-07-29) post-dates that revision (checked 2026-08-31)" + - "The 2026-07-28 revision makes MCP stateless with a mandatory server/discover, and deprecates sampling and logging; this entry frames the data layer around lifecycle messages and mentions neither server/discover nor elicitation (checked 2026-08-31)" + - "Actively maintained — the deprecations and the stateless model are dated 2026-07-28, three weeks before this check; the revision itself is covered by the sibling entry mcp-stateless (checked 2026-08-31)" tags: [model, context, protocol, open, standard] ---