# Username check

> Whether an X username is available, with similar available suggestions when it is taken.

`free_tools.username_check` · read

- **MCP tool:** `x_username_check`. Free tool: loaded on `/mcp/free` with no account; signed in, reach it with `find_actions` and `run_read_action`.
- **REST:** `GET /v1/free-tools/username-check`
- **CLI:** `xholic free-tools username-check`
- **Scope:** `read`
- **Plan:** Free tool: no account or plan needed
- **Cost:** Live X lookup: no credits, counts toward the plan's X data limits.
- **Rate limit bucket:** `live_x`

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string ≤ 120 chars | Yes | X username, with or without @. |