# Xholic > Xholic is the part of your AI that knows X, and knows you on X: the account's voice, what works for it and its niche, who matters, memory, and the actions to post, schedule, run agents and send DMs. Connect any agent to it over MCP (Claude, ChatGPT, Claude Code, Cursor, OpenClaw, Hermes and others), or call the REST API and CLI. A quickstart that needs no key: https://api.xholic.ai/v1/docs. - MCP server: https://api.xholic.ai/mcp (OAuth or an API key); free tools without an account: https://api.xholic.ai/mcp/free - REST API: https://api.xholic.ai/v1 (Authorization: Bearer xhk_…); OpenAPI: https://docs.xholic.ai/openapi.json - CLI: npm i -g xholic, then xholic login - 298 actions, the same on every surface. Your own AI does the writing at no Xholic cost; Xholic AI actions quote credits first. Every page below is Markdown. The HTML version is the same path without `.md`. ## Start here - [Xholic for your AI](https://docs.xholic.ai/index.md): Xholic is the part of your AI that knows X, and knows you on X. Connect Claude, ChatGPT, any MCP agent or your own code over MCP, REST or the CLI. - [Quickstart](https://docs.xholic.ai/quickstart.md): Connect Claude, ChatGPT, Claude Code, Cursor, OpenClaw, Hermes or any MCP agent to Xholic in a minute, or make your first API call with an API key. - [Authentication](https://docs.xholic.ai/api/authentication.md): API keys and OAuth for the Xholic API, MCP server and CLI: least access by default, scopes, accounts, the login code and what happens when a subscription lapses. ## Concepts - [Responses and errors](https://docs.xholic.ai/api/responses.md): The summary and data envelope every Xholic surface returns, the stable error codes, control fields and headers. - [Rate limits](https://docs.xholic.ai/api/rate-limits.md): Per-minute request limits for the Xholic API and MCP server by plan, in separate read, write and live X buckets. - [Credits](https://docs.xholic.ai/api/credits.md): What costs Xholic credits over the API and MCP, and the quote then confirmCredits flow that runs before any Xholic AI spend. - [Idempotency keys and dry runs](https://docs.xholic.ai/api/idempotency.md): Make retries safe with idempotencyKey, and preview any change with dryRun before it happens. - [Activity log and undo](https://docs.xholic.ai/api/activity.md): Every change made through the Xholic API, MCP server or CLI is logged with the connection that made it, and can be undone where X allows. - [App-only actions](https://docs.xholic.ai/api/app-only.md): Billing, X account connections, sharing and roles, sessions and security can be read over the API but only changed in the Xholic app. ## MCP - [MCP server](https://docs.xholic.ai/mcp.md): Connect Claude, ChatGPT, Claude Code, Cursor or any MCP client to Xholic at api.xholic.ai/mcp. - [MCP tools](https://docs.xholic.ai/mcp/tools.md): The 58 tools Xholic loads into your AI client, with inputs, scopes and costs. - [MCP action catalog](https://docs.xholic.ai/mcp/catalog.md): Every one of Xholic's 298 actions by area, with its MCP tool name and what it does. - [Free X tools over MCP](https://docs.xholic.ai/mcp/free.md): 12 free X tools over MCP with no account: profile reports, shadowban check, trends, thread reader and more. - [Prompts](https://docs.xholic.ai/mcp/prompts.md): 39 ready-made prompts from Ask Xholic's skills, available in any MCP client that lists prompts. ## CLI - [CLI](https://docs.xholic.ai/cli.md): The xholic command line: every Xholic action from your terminal, scripts, CI and coding agents, with browser login or an API key. - [CLI commands](https://docs.xholic.ai/cli/commands.md): All 298 xholic CLI commands by area, with their flags: post, schedule, run Workers and Signals, send DMs and read analytics from your terminal. ## Webhooks - [Webhooks](https://docs.xholic.ai/webhooks.md): Get Xholic events (posts published, leads found, DMs, Worker drafts ready) pushed to your HTTPS endpoint, signed with Standard Webhooks. - [Webhook events](https://docs.xholic.ai/webhooks/events.md): The 18 Xholic event types sent to webhooks and the events feed: posts published, leads found, DMs received, Worker drafts ready and more. - [Verify signatures](https://docs.xholic.ai/webhooks/verify.md): Check that a webhook came from Xholic: Standard Webhooks HMAC-SHA256 signatures with your whsec_ secret, with Node.js and Python examples. - [Events feed](https://docs.xholic.ai/webhooks/events-feed.md): Poll Xholic events with GET /v1/events, xholic events updates or get_updates on MCP, with a cursor so nothing is missed or repeated. ## Agent skill - [Agent skill](https://docs.xholic.ai/agent-skill.md): Install the Xholic agent skill in Claude Code and other agents with npx skills add xholic/xholic-agent: recipes for X growth on top of the xholic CLI. ## Formats - [Post automations](https://docs.xholic.ai/api/automations.md): The automation object for schedule_post, publish_now and queue edits: auto-repost, auto-plug, auto-DM, auto-delete, audience and reply settings. - [Article documents](https://docs.xholic.ai/api/articles.md): The Tiptap JSON body that create_article, update_article and the other X Article actions read and write, and how versions prevent lost edits. ## Actions reference - [Actions](https://docs.xholic.ai/actions.md): All 298 things Xholic can do, with the MCP tool, REST endpoint and CLI command for each. - [Your profile actions](https://docs.xholic.ai/actions/me.md): Your profile: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Accounts actions](https://docs.xholic.ai/actions/accounts.md): Accounts: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Context and voice actions](https://docs.xholic.ai/actions/context.md): Context and voice: 10 Xholic actions (3 read, 7 change), each with its MCP tool, REST endpoint and CLI command. - [Profile check actions](https://docs.xholic.ai/actions/profile.md): Profile check: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Updates actions](https://docs.xholic.ai/actions/events.md): Updates: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Insights actions](https://docs.xholic.ai/actions/insights.md): Insights: 2 Xholic actions (2 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Niche actions](https://docs.xholic.ai/actions/niche.md): Niche: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Engage actions](https://docs.xholic.ai/actions/engage.md): Engage: 12 Xholic actions (5 read, 7 change), each with its MCP tool, REST endpoint and CLI command. - [Mentions actions](https://docs.xholic.ai/actions/mentions.md): Mentions: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Replies actions](https://docs.xholic.ai/actions/replies.md): Replies: 5 Xholic actions (3 read, 2 change), each with its MCP tool, REST endpoint and CLI command. - [People actions](https://docs.xholic.ai/actions/people.md): People: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Posts actions](https://docs.xholic.ai/actions/posts.md): Posts: 4 Xholic actions (2 read, 2 change), each with its MCP tool, REST endpoint and CLI command. - [X search actions](https://docs.xholic.ai/actions/x.md): X search: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Inspiration actions](https://docs.xholic.ai/actions/inspiration.md): Inspiration: 2 Xholic actions (1 read, 1 change), each with its MCP tool, REST endpoint and CLI command. - [Library actions](https://docs.xholic.ai/actions/library.md): Library: 4 Xholic actions (1 read, 3 change), each with its MCP tool, REST endpoint and CLI command. - [Creators actions](https://docs.xholic.ai/actions/creators.md): Creators: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Drafts actions](https://docs.xholic.ai/actions/drafts.md): Drafts: 4 Xholic actions (1 read, 3 change), each with its MCP tool, REST endpoint and CLI command. - [Queue actions](https://docs.xholic.ai/actions/queue.md): Queue: 14 Xholic actions (3 read, 11 change), each with its MCP tool, REST endpoint and CLI command. - [Media actions](https://docs.xholic.ai/actions/media.md): Media: 7 Xholic actions (3 read, 4 change), each with its MCP tool, REST endpoint and CLI command. - [Content export actions](https://docs.xholic.ai/actions/content.md): Content export: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Analytics actions](https://docs.xholic.ai/actions/analytics.md): Analytics: 9 Xholic actions (7 read, 2 change), each with its MCP tool, REST endpoint and CLI command. - [Memory actions](https://docs.xholic.ai/actions/memory.md): Memory: 3 Xholic actions (1 read, 2 change), each with its MCP tool, REST endpoint and CLI command. - [Workers actions](https://docs.xholic.ai/actions/workers.md): Workers: 21 Xholic actions (6 read, 15 change), each with its MCP tool, REST endpoint and CLI command. - [Leads actions](https://docs.xholic.ai/actions/leads.md): Leads: 3 Xholic actions (1 read, 2 change), each with its MCP tool, REST endpoint and CLI command. - [Signals actions](https://docs.xholic.ai/actions/signals.md): Signals: 22 Xholic actions (12 read, 10 change), each with its MCP tool, REST endpoint and CLI command. - [Competitors actions](https://docs.xholic.ai/actions/competitors.md): Competitors: 4 Xholic actions (1 read, 3 change), each with its MCP tool, REST endpoint and CLI command. - [Contacts actions](https://docs.xholic.ai/actions/contacts.md): Contacts: 15 Xholic actions (6 read, 9 change), each with its MCP tool, REST endpoint and CLI command. - [Audience actions](https://docs.xholic.ai/actions/audience.md): Audience: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Ask Xholic actions](https://docs.xholic.ai/actions/ask.md): Ask Xholic: 8 Xholic actions (4 read, 4 change), each with its MCP tool, REST endpoint and CLI command. - [Action catalog](https://docs.xholic.ai/actions/actions.md): Action catalog: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Docs actions](https://docs.xholic.ai/actions/docs.md): Docs: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Scheduler actions](https://docs.xholic.ai/actions/scheduler.md): Scheduler: 12 Xholic actions (7 read, 5 change), each with its MCP tool, REST endpoint and CLI command. - [Tags actions](https://docs.xholic.ai/actions/tags.md): Tags: 5 Xholic actions (1 read, 4 change), each with its MCP tool, REST endpoint and CLI command. - [Composer actions](https://docs.xholic.ai/actions/composer.md): Composer: 3 Xholic actions (1 read, 2 change), each with its MCP tool, REST endpoint and CLI command. - [Remix actions](https://docs.xholic.ai/actions/remix.md): Remix: 8 Xholic actions (2 read, 6 change), each with its MCP tool, REST endpoint and CLI command. - [Collections actions](https://docs.xholic.ai/actions/collections.md): Collections: 7 Xholic actions (1 read, 6 change), each with its MCP tool, REST endpoint and CLI command. - [Articles actions](https://docs.xholic.ai/actions/articles.md): Articles: 16 Xholic actions (4 read, 12 change), each with its MCP tool, REST endpoint and CLI command. - [Contact lists actions](https://docs.xholic.ai/actions/contact-lists.md): Contact lists: 5 Xholic actions (1 read, 4 change), each with its MCP tool, REST endpoint and CLI command. - [Direct messages actions](https://docs.xholic.ai/actions/dm.md): Direct messages: 44 Xholic actions (16 read, 28 change), each with its MCP tool, REST endpoint and CLI command. - [Home actions](https://docs.xholic.ai/actions/home.md): Home: 3 Xholic actions (1 read, 2 change), each with its MCP tool, REST endpoint and CLI command. - [Settings actions](https://docs.xholic.ai/actions/settings.md): Settings: 15 Xholic actions (8 read, 7 change), each with its MCP tool, REST endpoint and CLI command. - [Billing actions](https://docs.xholic.ai/actions/billing.md): Billing: 5 Xholic actions (5 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Sharing actions](https://docs.xholic.ai/actions/sharing.md): Sharing: 1 Xholic action (1 read, 0 change), each with its MCP tool, REST endpoint and CLI command. - [Free tools actions](https://docs.xholic.ai/actions/free-tools.md): Free tools: 12 Xholic actions (12 read, 0 change), each with its MCP tool, REST endpoint and CLI command. ## Optional - [The guides in one file](https://docs.xholic.ai/llms-full.txt): every guide above in one Markdown file (about 20k tokens). The per-action reference stays on its own pages so it never floods a context window: read the area you need. - [OpenAPI document](https://docs.xholic.ai/openapi.json): the REST API as OpenAPI 3.0 - [REST API reference](https://docs.xholic.ai/api/reference/): one page per operation (Markdown twins under https://docs.xholic.ai/api/reference/operations/.md) - [API playground](https://docs.xholic.ai/api/playground/): for people, try any call in the browser with an API key (changes start as dry runs)