Skip to content

CHANGELOG.md

Latest commit

 

History

History
82 lines (65 loc) · 4.54 KB

CHANGELOG.md

File metadata and controls

82 lines (65 loc) · 4.54 KB
Raw

Changelog

All notable changes to the MCP Java SDK are documented in the GitHub Releases, which serve as the canonical, detailed changelog for every version. This file summarizes the release history and the currently maintained release lines.

Versioning follows Semantic Versioning; see VERSIONING.md for the breaking-change policy and SECURITY.md for the supported-versions security policy.

Release lines

Line Latest Spec revision Status
2.0.x 2.0.1 (2026-08-19) 2025-11-25 Active development
1.1.x 1.1.4 (2026-08-19) 2025-06-18 Security patches only
0.18.x 0.18.4 (2026-08-19) 2025-06-18 Security patches only

Unreleased (2.2.0)

  • Add McpTransportContext.putAll(Map), returning a context that combines an existing context with additional entries, which take precedence.
  • McpTransportContext no longer compares contexts by their contents in equals and hashCode. With putAll, transports can layer their own entries over the context a user's extractor returns, and comparing contexts was never a goal; read entries via get(String) instead.

2.0.1 — 2026-08-19

  • Bound STDIO and HTTP client/server reads to a configurable maximum size

Full notes: v2.0.1 release

2.0.0 — 2026-06-11

First major release since 1.x, tracking the 2025-11-25 MCP specification. Upgrading from 1.x? See the v2 migration guide.

  • New JSON compatibility foundation for forward/backward wire compatibility, with pluggable Jackson 2 / Jackson 3 serialization modules
  • Spec-accurate schema: enforced required fields, lenient wire deserialization
  • End-to-end validation of tool inputs and embedded JSON Schema documents (JSON Schema 2020-12, SEP-1613)
  • Richer elicitation: client-side schema defaults (SEP-1034), URL elicitation (SEP-1036), form-based elicitation schemas
  • Icons and metadata support (SEP-973)
  • Streamable HTTP first: SSE transports deprecated in favor of Streamable HTTP
  • Module restructuring: mcp-core, mcp-json-jackson2, mcp-json-jackson3, mcp-bom

Full notes: v2.0.0 release (preceded by milestones M1, M2, M3, RC1).

1.x

  • 1.1.4 — 2026-08-19: bound HTTP client/server reads (backport)
  • 1.1.3 / 1.0.2 — 2026-05-21: SSE client transport message-endpoint validation (backports)
  • 1.1.2 — 2026-04-25
  • 1.1.1 / 1.0.1 — 2026-03-27
  • 1.1.0 — 2026-03-13
  • 1.0.0 — 2026-02-23: first stable release; see the 1.0 migration guide

0.x