github-action/action.yml at main · mcp-contracts/github-action · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
name: "MCP Contract Diff"
description: "Diff MCP server tool schemas against a baseline contract"
branding:
  icon: "shield"
  color: "blue"

inputs:
  baseline:
    description: "Path to baseline snapshot (.mcpc.json)"
    required: true
  command:
    description: "Server command to run via stdio (e.g., 'node dist/index.js')"
    required: false
  args:
    description: "Arguments for the server command (space-separated)"
    required: false
  url:
    description: "Server URL for streamable-http transport"
    required: false
  sse:
    description: "Use SSE transport instead of streamable-http (requires url)"
    required: false
    default: "false"
  headers:
    description: "Custom HTTP headers, one per line as 'Key: Value'"
    required: false
  fail-on:
    description: "Severity threshold for failure: safe | warning | breaking"
    required: false
    default: "breaking"
  verify-signature:
    description: "Require valid signature on baseline before diffing (true/false)"
    required: false
    default: "false"
  signature-key:
    description: "Public key PEM content or file path for signature verification"
    required: false
  comment-on-pr:
    description: "Post diff as a PR comment (true/false)"
    required: false
    default: "true"
  github-token:
    description: "GitHub token for PR comments (defaults to GITHUB_TOKEN)"
    required: false
    default: ${{ github.token }}

outputs:
  has-changes:
    description: "Whether any changes were detected (true/false)"
  has-breaking:
    description: "Whether breaking changes were detected (true/false)"
  summary:
    description: "JSON summary object with change counts"
  exit-code:
    description: "The exit code (0 = pass, 1 = fail)"

runs:
  using: "node20"
  main: "dist/index.js"