X-Buddy documentation
X-Buddy runs your own personal X accounts in a real Chrome on your own Windows VPS. Start with the quick start, or search for your question.
For people using X-Buddy
Setup, X accounts, campaigns, inbox, limits and troubleshooting — step by step, with the exact words on screen.
For developers and AI agents
MCP, REST API, webhooks, error codes and a reference for every operation. Every page has a Markdown version for AI.
Popular questions
- How do I get started? — create a workspace, pair your VPS, add your first X account.
- Why is my job "held"? — every hold reason and how it clears.
- How do limits work? — account, workspace and platform layers; X's own rate limits.
- How do I import many X accounts? — any column order, every column kept, encrypted vault.
- How do I connect Claude, ChatGPT or Lovable? — the MCP endpoint and what the AI may do.
- What does an error code mean? — every API error and what to do.
What X-Buddy is — and isn't
- X-Buddy drives your own personal X accounts in a real Chrome on your own Windows VPS. Each X account keeps one browser profile that matches its proxy.
- It is an executor: it sends exactly the text you or your template wrote. It has no built-in AI writer. If you want AI, connect your own AI agent over MCP.
- It never solves captchas or X verification for you. When X asks for a check, the X account stops and you finish it yourself in Remote view.
Get started
Guides
Screen by screen
Developers & AI agents
API reference
AI agents: read /llms.txt, or add .md to the end of any page URL for its Markdown. Over MCP, use docs_search and docs_read.