# resolve_search_terms

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

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

Group: Events. 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

- `query` (string, body, required) A name or phrase to resolve, e.g. "Goldman Sachs", "Chief Financial Officer", "Departure".
- `limit` (integer, body) Max suggestions to return. Range 1 to 50. Default `20`.

## Example

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "resolve_search_terms",
    "arguments": {
      "query": "Chief Financial Officer",
      "limit": 3
    }
  }
}
```

Result (invented records):

```json
{
  "query": "Chief Financial Officer",
  "matches": [
    {
      "field": "Occupation",
      "value": "7d0e1f2a-b4c5-4d6e-9f8a-b9c0d1e2f3d1",
      "label": "Chief Financial Officer"
    }
  ],
  "note": "Pass `field` and `value` straight into a search_events condition."
}
```

## Errors

- `note: Nothing matched. Try a shorter or differently spelled phrase`: No suggestion matched. This is a normal result, not an error.

## Built on

- GET /v1/search/suggestions (https://chikaraintel.com/docs/api/reference/search/list-suggestions.md)