# Suggest @mentions

> X accounts matching a partial handle, from Xholic's data first. remote 1 allows a small live X search when few match.

`composer.mention_suggestions` · read

- **MCP tool:** `composer_mention_suggestions`. Catalog: reach it with `find_actions` and `run_read_action`, or turn on the full toolset.
- **REST:** `GET /v1/composer/mention-suggestions`
- **CLI:** `xholic composer mention-suggestions`
- **Scope:** `read`
- **Plan:** Every plan, including the trial
- **Cost:** Live X lookup: no credits, counts toward the plan's X data limits.
- **Rate limit bucket:** `live_x`

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | The handle typed so far, without @. |
| `remote` | "0" \\| "1" | No |  |
| `account` | string ≤ 64 chars | No | X account to act on, as @handle. Leave it out to use the connection's default account. |