ivermin1123/mcp-cassette contract gate
Health-check a live MCP server and gate schema drift against a committed contract snapshot, with one self-updating pull-request comment.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| server-command | Command that starts the MCP server on stdio, e.g. "node dist/server.js". Run any build step yourself before this action. | yes | — |
| snapshot-file | Path to the committed contract snapshot. | no | mcp-contract.snapshot.json |
| mode | What to run: "check" (health + safety lint), "snapshot" (contract drift), or "both". | no | both |
| fail-on | Lowest drift tier that fails the job: "breaking", or "dangerous" to also gate enum widening, default-value drift and added optional parameters. | no | breaking |
| comment | Post (and afterwards update in place) a single results comment on the pull request. Ignored outside pull-request events. | no | true |
| version | Version of mcp-cassette to run from npm. The special value "local" runs the CLI built in this action's own checkout, which is how this repository dogfoods the action against itself; it is not useful to consumers. | no | 0.3.0 |
| github-token | Token used to write the pull-request comment. Needs `pull-requests: write`. | no | ${{ github.token }} |
Outputs
no outputs