# speakers_merge_preview

Canonical HTML page: https://bitterclip.com/docs/assistants/tools/speakers_merge_preview

Surface: app-only

Product release: 185ad8f4adfa21ae055b5bd6f97968d9044480d1
Public contract commit: d2ab41fab4088c07c0f6b924fa4f3c63481b936a
Public contract SHA-256: 2365c73c2aef7b9f85e8434d8e29ea29f40824bc3a46a72a356155ea328757fc
Descriptor SHA-256: ef560141873b318181e4a3e6c2c93c1bbe9d49fc3c3fd417cce2e079ef1c4bee
Captured: 2026-10-29T03:35:56.855Z
Source: https://app.bitterclip.com/api/v1/mcp_descriptors.json

Previews a proposed duplicate-speaker merge before any profile is changed. Returns the recommended survivor, what would move, and the artifacts that will not be rewritten.

The JSON blocks below are the exact MCP descriptor projections served by Rails for the named profiles at capture time. Security schemes and resource URIs may vary by connected host.

## App descriptor

```json
{
  "name": "speakers_merge_preview",
  "title": "Preview speaker merge",
  "description": "Previews a proposed duplicate-speaker merge before any profile is changed. Returns the recommended survivor, what would move, and the artifacts that will not be rewritten.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "survivor_profile_id": {
        "type": "string",
        "description": "SpeakerProfile public ID, slug, or UUID to keep if the user confirms this merge direction."
      },
      "merged_profile_id": {
        "type": "string",
        "description": "SpeakerProfile public ID, slug, or UUID to merge into the survivor."
      }
    },
    "required": [
      "survivor_profile_id",
      "merged_profile_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Preview speaker merge",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "app"
      ]
    },
    "openai/widgetAccessible": true,
    "openai/visibility": "private"
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "state_sentence": {
        "type": "string"
      },
      "survivor_profile_id": {
        "type": "string"
      },
      "merged_profile_id": {
        "type": "string"
      },
      "recommended_survivor_profile_id": {
        "type": "string"
      },
      "recommendation_reason": {
        "type": "string"
      },
      "profiles": {
        "type": "array",
        "items": {
          "type": "object"
        }
      },
      "effects": {
        "type": "object"
      },
      "unchanged_artifacts": {
        "type": "array",
        "items": {
          "type": "object"
        }
      }
    },
    "required": [],
    "additionalProperties": false
  }
}
```

## Errors

```json
[
  "speaker_not_found",
  "invalid_input"
]
```

## Examples

```json
[]
```
