Changelog

All notable changes to the Raku MCP SDK are documented in this file.

[0.32.0] - 2026-01-29

Added

• End-to-end integration test over stdio (t/17-integration-stdio.rakutest): spawns MCP server subprocess, tests full protocol lifecycle

Fixed

• Fez publish in release workflow: use jq instead of raku -MJSON::Fast for config patching (JSON::Fast not in default lib path on CI runners)

[0.31.0] - 2026-01-29

Added

• Fuzz testing for JSON-RPC parsing (t/16-fuzz-jsonrpc.rakutest): invalid JSON, type confusion, adversarial values, 100 randomized payloads

• Stress tests for concurrent operations (make stress)

• Project governance: SECURITY.md, CODE_OF_CONDUCT.md, issue/PR templates, README badges

• ARCHITECTURE.md prose walkthrough of module structure, data flow, and concurrency model

• Expanded perldoc on all 15 public API modules

• CHANGELOG.md

Fixed

• Fez publish in release workflow: inject Fez::Util::Curl requestor into fez config when missing

[0.29.0] - 2026-01-29

Added

• Performance benchmarks: JSON-RPC parsing/serialization throughput, dispatch latency, concurrent scaling (make benchmark)

• Configurable scheme on SSE transport (no longer hardcoded to HTTP)

Fixed

• Race conditions in Client %!pending-requests (added $!request-lock)

• Race conditions in Server %!in-flight-requests and %!tasks (added $!flight-lock, $!task-lock)

• Flaky SSE endpoint test replaced start { react { whenever } } with synchronous .tap()

• Handler exceptions sanitized before sending to clients (no longer leaks internal details)

• PKCE verifier cleared from memory immediately after token exchange (single-use per RFC 7636)

• Bumped Rakudo from 2024.01 to 2024.12 in CI and release workflows

Changed

• CI now includes coverage job with 70% threshold

• README rewritten quality section as implemented features rather than task list

[0.28.0] - 2026-01-29

Added

• Icons and title metadata on Tool, Resource, Prompt, ResourceTemplate, and Implementation (SEP-973)

• Expanded test coverage for progress tracking, error edge cases, and concurrent operations

• IconDefinition type with src, mimeType, and sizes fields

• .title() and .icon() builder methods on all primitive builders

Changed

• Gap analysis and status docs updated to reflect full specification coverage

[0.27.0] - 2026-01-28

Added

• Legacy SSE transport for backwards compatibility with MCP spec 2024-11-05

• Enterprise IdP policy controls (SEP-990)

• OAuth client credentials for machine-to-machine authentication (SEP-1046)

• Dynamic client registration for OAuth

Changed

• Documentation cleanup: corrected completeness claims, added SSE references

[0.26.0] - 2025-12-15

Added

• Progress token support with $*MCP-PROGRESS-TOKEN dynamic variable

• Client-side progress Supply for typed Progress objects

• Logging level setting via logging/setLevel and client set-log-level

• Protocol version negotiation across 2024-11-05, 2025-03-26, and 2025-11-25

[0.25.0] - 2025-12-01

Added

• Tool name validation per SEP-986 (1-64 chars, [a-zA-Z0-9_-])

• Resource templates with URI template pattern matching and builder API

• Prompt and resource list-changed notifications

[0.24.0] - 2025-11-15

Added

• Extensions framework with capability negotiation and method dispatch

• Extension registration, experimental capabilities advertising

[0.23.0] - 2025-11-01

Added

• Sampling with tools (SEP-1577): tools, toolChoice, includeContext in createMessage

• Tasks framework for long-running async tool execution with status polling and cancellation

[0.22.0] - 2025-10-15

Added

• OAuth 2.1 authorization: PKCE, token management, server validation, metadata discovery

[0.21.0] - 2025-10-01

Added

• Tool output schemas with outputSchema and structuredContent for structured results

• Completion/autocomplete support with prompt and resource completers

• Elicitation support (form and URL modes) with handler callbacks

[0.20.0] - 2025-09-15

Added

• Streamable HTTP transport with session management, SSE streaming, and resumption

• Roots support: client roots configuration, server list-roots, set-roots

• Resource subscriptions: subscribe, unsubscribe, update notifications

[0.19.0] - 2025-09-01

Added

• Request cancellation with notifications/cancelled

• Pagination support for all list endpoints (tools, resources, prompts)

• Tool and resource annotations with builder API

Changed

• Updated to MCP protocol version 2025-11-25

[0.1.0] - 2025-07-01

Added

• Initial implementation

• JSON-RPC 2.0 message handling

• Stdio transport

• Tools, Resources, Prompts with builder API

• Server and Client initialization

• MCP protocol types and capabilities