MCP tool · Events

resolve_search_terms

Turn a company name, job title or event word into the exact value a filter needs.

Read only

When to use

Call it before search_events whenever a condition names a company or a job title. Those fields take a reference, never a name. It also returns the exact spelling of move types, event types and deal statuses.

Parameters

querystring·bodyrequired
A name or phrase to resolve, e.g. "Goldman Sachs", "Chief Financial Officer", "Departure".
limitinteger·body
Max suggestions to return. Range 1 to 50.Default 20

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.

Resolve Halberd and Chief Financial Officer so I can filter on them.

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.

  • note: Nothing matched. Try a shorter or differently spelled phraseNo suggestion matched. This is a normal result, not an error.

Built on

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

Related