MCP tool · Events

search_events

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

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 to get the reference this tool needs.

Parameters

conditionsobject[]·bodyrequired
Filter conditions, applied left to right. Range 1 to 20 items.
conditions[].fieldstring·bodyrequired
Which dimension to filter on.OrganisationProfileOccupationMoveTypeEventTypeCompensationTypePublishedDateIndustryDealStatusDealTypeJurisdiction
conditions[].operatorstring·body
Comparison. Only PublishedDate accepts > < >= <=.Default "EQUAL"EQUALNOT EQUAL><>=<=
conditions[].valuestring·bodyrequired
The value to match. UUID fields need a reference from resolve_search_terms.
conditions[].joinstring·body
How this condition joins the ones before it. Defaults to AND. Ignored on the first condition.ANDOR
limitinteger·body
Events per page (default 15, max 50). Keep it small — event payloads are large. Range 1 to 50.Default 15
pageinteger·body
1-based page number.Default 1
detailstring·body
Summary returns the scannable projection; full returns whole event payloads and consumes far more context.Default "summary"summaryfull

The filtering guide covers joins, precedence and date ranges with worked examples.

Example

Ask your assistant something like this, and it makes the call below. The result is shown as the JSON the tool returns, which reaches the assistant as a text content item.

Which CFOs moved at UK industrials in August 2026?

Example records are invented.

Errors

These come back as a tool result with isError: true, so the assistant can read the reason and try again.

  • 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

The tool calls these endpoints with your own token. Use the API directly to get the same data into your own systems.

Related