# Free X tools over MCP

> 12 free X tools over MCP with no account: profile reports, shadowban check, trends, thread reader and more.

Source: https://docs.xholic.ai/mcp/free/

`https://api.xholic.ai/mcp/free` serves Xholic's free X tools to anyone, with no sign-in. They are the same tools as on xholic.ai/tools. The AI writing tools stay on the website.

```json
{
  "mcpServers": {
    "xholic-free": {
      "url": "https://api.xholic.ai/mcp/free"
    }
  }
}
```

Without an account the tools share a limit of 10 requests per minute per IP address, with their own daily budget. Signed in, the same tools are in the catalog of `https://api.xholic.ai/mcp` under your plan's limits.

## Tools

### x_profile_report

**X profile report.** A free report on any public X account. report: analytics (followers, posting and engagement over recent posts), audit (profile and content checklist with fixes), best-time (when its posts do best; pass timezone), engagement-rate (average engagement rate with a benchmark), media (its profile picture and header image at full size).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string ≤ 120 chars | Yes | X username, with or without @. |
| `report` | "analytics" \\| "audit" \\| "best-time" \\| "engagement-rate" \\| "media" | Yes |  |
| `timezone` | string ≤ 80 chars | No | For analytics and best-time: IANA timezone for times of day. |

### shadowban_check

**Shadowban check.** Check whether a public X account looks shadowbanned or limited in search, replies and suggestions. A few fresh checks per day; recently checked handles come back from storage.

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

### x_trend_regions

**X trend regions.** The regions X trends are available for, with their region slugs for x_trends.

No input.

### x_trends

**X trends.** What is trending on X in a region right now (from Xholic's recent snapshot). Use worldwide or a slug from x_trend_regions such as united-states.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `region` | string | Yes | Region slug such as worldwide or united-states. |

### read_thread

**Read a thread.** Unroll an X thread from the link to any of its posts into one readable piece, with its media.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string ≤ 500 chars | Yes | Link to a post in the thread. |

### card_preview

**Link card preview.** Show how a link will look as a card on X (title, description, image, card type) and what is missing from its tags.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | string ≤ 2048 chars | Yes | The page link to check. |

### x_post_media

**Post media links.** Get download links for the video, GIF or images in a public X post.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `tweetUrl` | string ≤ 500 chars | Yes | Link to the X post. |
| `type` | "video" \\| "gif" \\| "image" | Yes |  |

### x_username_check

**Username check.** Whether an X username is available, with similar available suggestions when it is taken.

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

### x_id_converter

**X ID converter.** Convert between an X username and its numeric user id, in either direction.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `input` | string ≤ 120 chars | Yes | A username, user id or profile link. |

### x_follower_count

**Follower count.** The current follower and following counts of a public X account.

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

### x_account_worth

**Account worth.** An estimate of what a public X account is worth, from its followers, views and engagement on recent posts.

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

### engagement_calculator

**Engagement rate calculator.** Calculate engagement rates from numbers you already have (followers, impressions, likes, replies, reposts, quotes). No X lookup.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `followersCount` | integer 0–1000000000 | Yes |  |
| `impressions` | integer 0–10000000000 | Yes |  |
| `likes` | integer 0–1000000000 | Yes |  |
| `replies` | integer 0–1000000000 | Yes |  |
| `reposts` | integer 0–1000000000 | Yes |  |
| `quotes` | integer 0–1000000000 | Yes |  |
