# search_events

Filter moves, deals, funding rounds and other events with AND/OR conditions.

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

Group: Events. Read only.

## When to use

Use it for any question about what happened: who left, who was hired, which deals completed. Resolve company and job title names first. Keep `limit` small and open the few events that matter with get_event.

Call `resolve_search_terms` first.

## Parameters

- `conditions` (object[], body, required) Filter conditions, applied left to right. Range 1 to 20 items.
- `conditions[].field` (string, body, required) Which dimension to filter on. Values: `Organisation`, `Profile`, `Occupation`, `MoveType`, `EventType`, `CompensationType`, `PublishedDate`, `Industry`, `DealStatus`, `DealType`, `Jurisdiction`.
- `conditions[].operator` (string, body) Comparison. Only PublishedDate accepts > < >= <=. Default `"EQUAL"`. Values: `EQUAL`, `NOT EQUAL`, `>`, `<`, `>=`, `<=`.
- `conditions[].value` (string, body, required) The value to match. UUID fields need a reference from resolve_search_terms.
- `conditions[].join` (string, body) How this condition joins the ones before it. Defaults to AND. Ignored on the first condition. Values: `AND`, `OR`.
- `limit` (integer, body) Events per page (default 15, max 50). Keep it small — event payloads are large. Range 1 to 50. Default `15`.
- `page` (integer, body) 1-based page number. Default `1`.
- `detail` (string, body) Summary returns the scannable projection; full returns whole event payloads and consumes far more context. Default `"summary"`. Values: `summary`, `full`.

The [filtering guide](/docs/mcp/guides/filtering-events) covers joins, precedence and date ranges with worked examples.

## Example

Prompt: "Which CFOs moved at UK industrials in August 2026?"

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_events",
    "arguments": {
      "conditions": [
        {
          "field": "EventType",
          "operator": "EQUAL",
          "value": "move"
        },
        {
          "field": "Occupation",
          "operator": "EQUAL",
          "value": "7d0e1f2a-b4c5-4d6e-9f8a-b9c0d1e2f3d1",
          "join": "AND"
        },
        {
          "field": "PublishedDate",
          "operator": ">=",
          "value": "2026-08-01",
          "join": "AND"
        },
        {
          "field": "PublishedDate",
          "operator": "<=",
          "value": "2026-08-31",
          "join": "AND"
        }
      ],
      "limit": 15
    }
  }
}
```

Result (invented records):

```json
{
  "events": [
    {
      "reference": "e5f6a7b8-c9d0-4e1f-8a3b-c4d5e6f7a881",
      "event_type": "move",
      "publish_date": "2026-08-04T07:00:00+00:00",
      "summary": "Halberd Industrial Group appoints Elena Marchetti as Chief Financial Officer",
      "organisation": "Halberd Industrial Group",
      "organisation_reference": "3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
      "profile": "Elena Marchetti",
      "profile_reference": "a1b2c3d4-e5f6-4a7b-9c8d-e9f0a1b2c341",
      "move_type": "Appointment",
      "occupation": "Chief Financial Officer",
      "annotation_counts": {
        "speech": 1,
        "feedback": 1,
        "recommendation": 0,
        "review": 0
      }
    }
  ],
  "pagination": {
    "total": 1,
    "rows_per_page": 15,
    "page": 1,
    "total_pages": 1
  },
  "applied": {
    "conditions": "…as sent…",
    "detail": "summary",
    "date_window": "No plan-imposed date restriction applied."
  }
}
```

## Errors

- `condition 2 (Occupation) needs a UUID, got "CFO". Use resolve_search_terms…`: A reference field was given a name.
- `condition 3 (MoveType) uses ">", but ordering comparisons are only meaningful on PublishedDate.`: An ordering operator on a field other than PublishedDate.
- `… has value "Exit", which is not one of: Hire, Appointment, …`: A value outside the field's allowed list.

## Built on

- POST /v1/search/events (https://chikaraintel.com/docs/api/reference/search/create-event-search.md)
- GET /v1/events (https://chikaraintel.com/docs/api/reference/events/list-events.md)