AI-2315: Release 1.37.0 version

[vita-stejskal]

Release Notes

Version: 1.37.0

Key Changes

• Configuration Diff Preview Endpoint: Added new POST /preview/configuration endpoint that allows previewing configuration changes before applying them. Supports update_sql_transformation, update_flow, and modify_data_app tools (PR AI-2201 config diff preview #345, AI-2201)
• Tool Parameter Validation: Configuration diff preview validates tool parameters against the tool's input schema before processing
• Scheduler API Client: Added new SchedulerClient for interacting with the Keboola Scheduler API service to manage scheduled flow executions (PR Ai 981 add flow scheduling #340, AI-981)
• Read-only Mode for API Clients: Added readonly flag to API clients enabling safer operations during preview without risk of accidental modifications
• Custom Exception Handlers: Added custom exception handlers to the Starlette app for improved error responses
• PR Template Updates: Added release notes template and updated PR template with testing checkpoints (PR feat: Add PR template with deployment testing part before deployment #314, AI-1950)

Plans for Customer Communication

• Communication channels: No active notification required
• Timeline: Deployment will occur automatically via CI/CD pipeline
• Customer action: No action required from customers
• Transparency: This is a transparent update that maintains backward compatibility. The configuration diff preview is a new internal API endpoint for supporting UI features

Impact Analysis

• Affected Users: All MCP server users, primarily internal platform components
• Customer Action Required: None - backward compatible changes
• Service Interruption: No downtime expected during deployment
• Risk Level: Low - new features are additive and don't modify existing functionality

Change Type

Minor - New features and enhancements, backward compatible

• New configuration diff preview endpoint
• New Scheduler API client
• New read-only mode for API clients

Justification

• The configuration diff preview endpoint enables UI components to show users what changes will be made before confirming, improving user experience and reducing errors
• The Scheduler API client prepares the foundation for flow scheduling features
• Read-only mode improves safety when performing preview operations

Testing

This section is to be filled by the release testers.

• Tested with Cursor AI desktop (all transports)
• Tested with claude.ai web and canary-orion MCP (SSE and Streamable-HTTP)
• Tested with In Platform Agent on canary-orion
• Tested with RO chat on canary-orion

Deployment Plan

• Method: Automated CI/CD pipeline triggered from the release branch.
• Channels: Both the public MCP instances and the internal MCP instances for the agents will be updated in all Keboola stacks. The version will be published to PYPI and Anthropic's MCP registry as well as released on GitHub.
• Coordination: No coordination needed.

Rollback Plan

Revert to previous 1.36.5 version if critical issues arise. Standard deployment pipeline can be used for rollback. Estimated rollback time: < 15 minutes.

Post-Release Support Plan

• Monitor application logs for errors in new preview endpoint and scheduler client
• Standard on-call coverage
• Timeline for post-release monitoring: 24-48 hours
• Monitor for issues and provide support via GitHub Issues

[linear]

AI-2315 [MCP] Release version 1.37.0