modelcontextprotocol / modelcontextprotocol/php-sdk
[2026-07-28] Schema modernization & error code standardization
Open
Nobody has claimed this yet.
2026-07-28
enhancement
improves spec compliance
Schema
- Dominant language
- PHP
- Stars
- 1.6k
- Forks
- 173
- Avg merge
- 2d 49m
- Merged PRs (30d)
- 23
Description
Tracking issue for the MCP Spec 2026-07-28 release — Schema & errors milestone.
SEPs covered
| SEP | Title | Spec PR |
|---|---|---|
| SEP-2106 | Tools inputSchema/outputSchema conform to JSON Schema 2020-12 |
#2106 |
| SEP-2164 | Standardize resource-not-found error code to -32602 |
#2164 |
Sub-issues
SEP-2106 (JSON Schema 2020-12):
- #356 — Vocabulary support (oneOf/anyOf/allOf/if-then-else/
$ref) - #357 — Allow non-object
outputSchemaandstructuredContent - #358 — Harden
SchemaValidatoragainst external$refSSRF and composition DoS
SEP-2164:
- #359 — Switch resource-not-found error code to
-32602with protocol-version-aware fallback
Notes
- Both SEPs are merged.
- SEP-2106 is the largest code-level lift this cycle for the schema layer: full JSON Schema 2020-12 vocabulary (composition, conditionals,
$ref), plus non-objectoutputSchema/structuredContent. Also requires hardening against external$refSSRF and composition DoS. - SEP-2164 is mechanically a one-constant flip in
src/Schema/JsonRpc/Error.phpwith a protocol-version-aware fallback.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with sub-issues #356–#359 and their SEP links. For the error-code work, inspect src/Schema/JsonRpc/Error.php and the protocol-version fallback described in the issue; for schema work, begin with the SchemaValidator and the listed JSON Schema vocabulary, outputSchema, structuredContent, SSRF, and DoS requirements. Done means all listed sub-issues are completed against the merged SEP requirements.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- php
- Domain
- api, backend
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100