# get_similar_moves

Count comparable moves over the same period, to tell a one-off from a pattern.

Canonical: https://chikaraintel.com/docs/mcp/tools/get_similar_moves

Group: Events. Read only.

## When to use

Use it after finding a move that matters. It counts other moves into the same job title over the chosen period, or into the same organisation when the move has no job title recorded. Moves only: other event types return an error.

Call `search_events` first.

## Parameters

- `reference` (uuid, body, required) Reference UUID of a `move` event.
- `period` (string, body) Bucket size for the comparison window (default month) Default `"month"`. Values: `week`, `month`, `quarter`, `year`.

`months` lists only months with at least one move, so a quiet month is absent from the arrays, not zero.

## Example

Prompt: "Is Elena Marchetti's move part of a wider wave of CFO changes?"

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_similar_moves",
    "arguments": {
      "reference": "e5f6a7b8-c9d0-4e1f-8a3b-c4d5e6f7a881",
      "period": "quarter"
    }
  }
}
```

Result (invented records):

```json
{
  "event_reference": "e5f6a7b8-c9d0-4e1f-8a3b-c4d5e6f7a881",
  "period": "quarter",
  "statistics": {
    "total": 41,
    "months": [
      "2026-06",
      "2026-07",
      "2026-08"
    ],
    "counts": [
      11,
      12,
      18
    ]
  }
}
```

## Errors

- `Event … is a merger_and_acquisition event, not a move`: The reference is not a move.
- `Not found.`: No event has that reference.

## Built on

- GET /v1/events/{eventReference}/statistics/{statisticReference}/similarmoves (https://chikaraintel.com/docs/api/reference/events/get-similar-moves.md)
- GET /v1/events/{eventReference} (https://chikaraintel.com/docs/api/reference/events/get-event.md)