# X ID converter

> Convert between an X username and its numeric user id, in either direction.

`free_tools.x_id_convert` · read

- **MCP tool:** `x_id_converter`. 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/x-id-convert`
- **CLI:** `xholic free-tools x-id-convert`
- **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 |
| --- | --- | --- | --- |
| `input` | string ≤ 120 chars | Yes | A username, user id or profile link. |
