Free X tools over MCP
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.
{ "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.
x_profile_report
Section titled “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” \ |
timezone |
string ≤ 80 chars | No | For analytics and best-time: IANA timezone for times of day. |
shadowban_check
Section titled “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
Section titled “x_trend_regions”X trend regions. The regions X trends are available for, with their region slugs for x_trends.
No input.
x_trends
Section titled “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
Section titled “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
Section titled “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
Section titled “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” |
x_username_check
Section titled “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
Section titled “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
Section titled “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
Section titled “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
Section titled “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 |
