showbranch-webmcp.vercel.app

{
  "name": "list_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "List ShowBranch products from main or the effective active preview branch. Use this to inspect classification fields before proposing changes.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "scope": {
        "type": "string",
        "enum": [
          "main",
          "active_branch"
        ],
        "default": "main"
      },
      "query": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "default": 50
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

{
  "name": "get_activity",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read recent human UI product updates with immutable full before/after snapshots. latest_seq and scope_latest_seq describe the requested scope; global_latest_seq and has_newer_activity_outside_scope prevent newer demonstrations in another scope from being missed. Agent and branch lifecycle activity is intentionally excluded.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "scope": {
        "type": "string",
        "enum": [
          "main",
          "branch",
          "any"
        ],
        "default": "any"
      },
      "branch_id": {
        "type": "string",
        "pattern": "^BR-[0-9]{3}$"
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "default": 20
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

{
  "name": "create_preview_branch",
  "kind": "act",
  "impl": "imperative",
  "description": "Create the single isolated preview branch from the current main revision. This does not change main products.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "rationale": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      }
    },
    "required": [
      "name"
    ],
    "additionalProperties": false
  }
}

{
  "name": "apply_branch_updates",
  "kind": "act",
  "impl": "imperative",
  "description": "Atomically apply agent classification proposals to a preview branch. Main is never changed; duplicate products or any invalid item reject the whole batch.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "branch_id": {
        "type": "string",
        "pattern": "^BR-[0-9]{3}$"
      },
      "updates": {
        "type": "array",
        "minItems": 1,
        "maxItems": 50,
        "items": {
          "type": "object",
          "properties": {
            "product_id": {
              "type": "string",
              "pattern": "^P[0-9]{3}$"
            },
            "category": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            },
            "tags": {
              "type": "array",
              "maxItems": 10,
              "uniqueItems": true,
              "items": {
                "type": "string",
                "minLength": 1,
                "maxLength": 30
              }
            },
            "rationale": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500
            },
            "confidence": {
              "type": "number",
              "minimum": 0,
              "maximum": 1
            }
          },
          "required": [
            "product_id"
          ],
          "anyOf": [
            {
              "required": [
                "category"
              ]
            },
            {
              "required": [
                "tags"
              ]
            }
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "branch_id",
      "updates"
    ],
    "additionalProperties": false
  }
}

{
  "name": "get_branch_diff",
  "kind": "answer",
  "impl": "imperative",
  "description": "Inspect current versus preview product values and aggregate change counts before a human decides whether to merge.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "branch_id": {
        "type": "string",
        "pattern": "^BR-[0-9]{3}$"
      }
    },
    "required": [
      "branch_id"
    ],
    "additionalProperties": false
  }
}