The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Capx café listing page.
One MCP server. Your X token never touches the agent — and every post clears an enforced guardrail before it ships.
The guardrail, live — every verdict above is produced by the real chokepoint code (pnpm demo replays it).
capx café is an agent-native X poster that installs as one MCP server into any coding agent (Claude Code / Cursor / Codex / Windsurf). A whitelisted user connects their X account once; after that they create / schedule / post from inside their agent session. The whole product rests on one security thesis: the X token, the guardrail (casserole), and the send are one inseparable server-side unit — the agent on your laptop only ever holds a short-TTL session handle, never the token. That's why it structurally can't be prompt-injected into tweeting a scam. "The AI writes; casserole decides what ships."
Every other "let your AI post" tool has the same flaw: to let an agent post, you paste your X token into a plaintext config right next to an autonomous agent that reads untrusted web pages, issues, and code. One prompt-injection and your account tweets a scam. capx café is the only one that structurally can't be.
→ Full threat model, architecture & the "what we can/can't see" table: docs/SECURITY.md
The token, the guardrail, and the send live together behind a trust boundary; your agent can only ask.
Six deterministic layers on every post. Worst result wins — pass / rewrite / hold / block — and a blocked post never even decrypts the token.
Then, inside your agent:
Set CAPX_EMAIL (your whitelisted email) and, for the BYO lane, X_CLIENT_ID (your own X app) in
~/.capx/config.json or your agent's MCP env. A guided setup page hands you the exact callback URL to paste.
| Agent | How |
|---|---|
| Claude Code | /plugin marketplace add vb-tyagi/capx-cafe → /plugin install capx-cafe (MCP + slash commands + skills) |
| Cursor | add to .cursor/mcp.json; skill rules in plugins/capx-cafe/adapters/cursor/ |
| Codex | add to your MCP config; prompt pack in plugins/capx-cafe/adapters/codex/ |
| Windsurf | add to MCP config; workflows in plugins/capx-cafe/adapters/windsurf/ |
| Any MCP agent | point it at npx -y capx-cafe |
| Docker Desktop | docker mcp catalog pull ghcr.io/vb-tyagi/capx-catalog:latest → MCP Toolkit → enable capx café |
| Tool | What it does |
|---|---|
connect_x | One-time browser OAuth — the token lands in the server vault, never on your machine |
post_now | Post now (clears casserole first). Supports reply-chains and media |
preview | Dry-run a draft through the guardrail without sending — pass / hold / block + why |
audit | The durable record of what capx posted or attempted on your behalf, and its state |
create_loop · list_loops · … | Scheduled posting — a queue you wrote, sent on a schedule, laptop-off |
upload_media | Stream a local image/video to X and attach it (media you made with your own tools) |
whoami | The connected account + its status |
capx lives inside a coding agent, so it has what no social scheduler does: your repo, commits, PRs, releases. Skills turn that into posts — automatically, and always through the guardrail.
The self-refilling content engine: you code → commits accrue → the loop drains as it posts → gap-alert tops it up from the new commits. Your normal work is the pipeline.
image-director, video-director, prompt-engine, model-guide: capx runs no models;
it guides your image/video tools (higgsfield, fal, kling, …) and uploads the result. casserole guards your
caption; you own the media.One canonical SKILL.md per skill, generated for all four agents. capx never writes the content — it makes
good content easy and stops bad content regardless of which skill produced it.
Short $5 / Tall $15 / Grande $35 monthly tiers + top-up packs, quotas enforced
server-side at the gate. Full sheet + the math: docs/ECONOMICS.md · policy
posture: docs/X-COMPLIANCE.md.The chokepoint is open source (AGPL-3.0). Run the identical image with your own X app, keys, database, and
domain — CAPX_DEPLOY_MODE=self-host, zero telemetry to capx. See the self-host-guide skill and
docs/HANDOFF.md.
MIT for the client and everything it bundles (apps/capx-mcp, core, config, platform-client) plus
skills & docs. AGPL-3.0 for the server half (the chokepoint + casserole/captain/counter/canteen/
chef). Full map: LICENSING.md.
Private alpha, whitelist-only. The first real post shipped 2026-07-19 — guardrail-cleared, token never on the machine. Not yet open for public signups.
Node ≥ 22.6 (TypeScript runs natively via --experimental-strip-types — no build step). pnpm run verify =
unit tests across packages / services / apps + tsc. Contributions accepted under the project CLA.