Skip to content
reaatechREAATECH

reaatech/mcp-schema-evolution

0Last commit: Jun 4, 2026GitHub →

These packages give you a diff engine and CI policy for MCP tool schemas, classifying every change between two `Tool[]` snapshots as breaking, non-breaking, or patch. You'd adopt them to prevent breaking MCP consumers when you add, remove, or rename tool fields, catching unintended changes before a release. The core library returns `Result<T>` objects instead of throwing, and the CI package enforces policy through a pipe-delimited acknowledgment file that lets you explicitly allow intentional breaking changes.

Packages

3 packages

@reaatech/mcp-schema-evolution

v0.0.0
A function that compares two MCP `Tool[]` snapshots and returns a classified list of schema changes (breaking, non-breaking, or patch) with migration guidance, including heuristic-based field rename detection.
status
published
published
21 days ago

@reaatech/mcp-schema-evolution-ci

v0.0.0
A CLI and programmatic API that validates MCP schema snapshots against a policy, failing CI on unacknowledged breaking changes and generating formatted reports for pull request comments.
status
published
published
21 days ago

@reaatech/mcp-schema-evolution-cli

v0.0.0
A CLI that compares two MCP tool snapshot JSON files, detects breaking and non-breaking schema changes, and outputs results as either human-readable text with migration suggestions or machine-readable JSON for CI pipelines.
status
published
published
21 days ago

Comments

Sign in with GitHub to comment and vote.

Loading comments…