Highlights
v0.5.0 is a major internal upgrade for MCP Adapter. The biggest change is the adoption of wordpress/php-mcp-schema across the plugin, so MCP responses now use typed protocol DTOs instead of hand-built arrays.
This gives us a more consistent and spec-aligned foundation for tools, resources, prompts, initialization, and error responses, while making future MCP spec updates easier to support.
For most users, this should be a seamless upgrade. Existing ability registration, create_server(), and WordPress hooks continue to work as before. If you have custom handlers, transports, or code that depends on internal component structures, review the migration guide for upgrade details.
Included in this release
- Full integration of
wordpress/php-mcp-schemathroughout the adapter - Typed DTO-based handling for MCP tools, resources, prompts, initialization, and JSON-RPC errors
- Protocol version negotiation support for
2025-11-25,2025-06-18, and2024-11-05 - Validation, encapsulation, and type-safety improvements across the core and domain layers
- Security hardening with stricter input validation and fail-closed permission handling
- Better observability for protocol errors and
isErrortool responses - Reduced
SessionManagerwrite amplification to lower lock contention - Packaging and dependency updates, including the
php-mcp-schemav0.1.1follow-up for cleaner Composer dist archives
Documentation
Documentation was expanded significantly for this release, including:
- A new
v0.5.0migration guide - Updated architecture documentation
- Improvements to the default server guide and troubleshooting docs
- README updates, including WordPress 6.9/7.0 notes
- Additional guidance for ability registration
Contributors
New Contributors
- @spenserhale made their first contribution in #44
- @karthikeya-io made their first contribution in #169
- @itsgajendraSingh made their first contribution in #165
Full Changelog: v0.4.1...v0.5.0
