xpost

xpost for your assistant

Post all your social media with your AI agent: X, Instagram, LinkedIn, Facebook, TikTok, YouTube, Threads, Bluesky and Pinterest, from Claude, ChatGPT, Cursor, Gemini CLI or any MCP client. Want a say first? Switch on approvals and nothing goes out until a person says yes.

This repo is the open-source skill (the workflow an agent should follow) plus the plugin manifests that install it together with the hosted MCP server at https://xpost.to/api/mcp. You sign in once in a browser window; nothing to paste.

You need an xpost account — the first post is free, no card: https://xpost.to/signup

Install

Any agent — as a skill

npx skills add xpost-to/xpost-agent

This installs the skill only. Add the MCP server in your client as below, or let the skill's REST fallback use XPOST_API_KEY.

Claude Code — plugin (skill + MCP server)

/plugin marketplace add xpost-to/xpost-agent
/plugin install xpost@xpost-agent

Nothing prompts you to sign in: type /mcp, choose xpost, then Authenticate — your browser opens on the sign-in page. Or without the plugin:

claude mcp add --transport http xpost https://xpost.to/api/mcp

Gemini CLI — extension (skill + MCP server)

gemini extensions install https://github.com/xpost-to/xpost-agent

Gemini opens a browser to sign in to xpost on first use; /mcp auth xpost signs in again.

Cursor

One click: Add xpost to Cursor

Or add it by hand in Settings → Tools & Integrations → New MCP Server:

{ "mcpServers": { "xpost": { "type": "http", "url": "https://xpost.to/api/mcp" } } }

Then npx skills add xpost-to/xpost-agent for the skill. The repo also carries a Cursor plugin manifest (.cursor-plugin/plugin.json).

Grok Build

The repo carries a Grok Build plugin manifest (.grok-plugin/plugin.json, skill + hosted MCP server) and its own marketplace catalog (.grok-plugin/marketplace.json). Inside Grok Build, /marketplace browses the catalog; from a shell, grok plugin install xpost --trust once the source is known to it. Not yet in the official xAI index.

Muse Code (Meta)

Add the hosted server to ~/.config/muse/settings.json; Muse Code asks you to sign in on the first tool call:

{
  "schema_version": 1,
  "mcp_servers": {
    "xpost": { "transport": "streamable_http", "url": "https://xpost.to/api/mcp" }
  }
}

Grok, Muse and other chat assistants with no MCP settings

Paste this into the chat. The assistant sets itself up and asks you for an API key (Project → AI agent → Keys on xpost):

Set up xpost so you can post to my social accounts. The REST API is https://xpost.to/api/v1 (spec at https://xpost.to/api/v1/openapi.json), authenticated with an Authorization: Bearer YOUR_KEY header. If you can run commands, npx xpost wraps it and npx skills add xpost-to/xpost-agent installs the workflow. Ask me for my xpost API key and set it as XPOST_API_KEY before doing anything. Start with the accounts list. Creating a post sends it, unless my project holds posts for approval — never say a post is published until the receipt says so.

ChatGPT, Claude.ai, Claude Desktop

ChatGPT: xpost is in the plugin directory — find it, add it, sign in. Claude with the xpost plugin installed: Customize → Connectors, find xpost, press Connect, sign in — the plugin brings the connector, signed out. Without the plugin: Customize → Connectors → Add → custom connector, paste https://xpost.to/api/mcp, sign in.

No MCP client at all — the CLI

npx xpost login
npx xpost posts create -c "Shipped it." -a x:yourhandle

The xpost package on npm is the CLI, the local MCP server (npx xpost mcp) and the skill's fallback in one. Docs: https://xpost.to/docs/cli

What the skill teaches

• Accounts first: list_accounts names every destination and what it can carry.
• get_posting_rules is the option catalog per account; a key that is not there cannot be used.
• Creating a post sends it; a project in copilot mode holds it (pending_approval) instead. Either is a normal outcome — say which, print the link.
• A guardrail refusal names the rule. Rewrite once. Never evade.
• list_posts before assuming a post is still waiting — the person may have rejected it with a reason.
• Receipts are per account: "delivered to X, failed on Instagram: reason".

Full text: skills/xpost/SKILL.md.

Docs

• Every MCP tool: https://xpost.to/docs/mcp
• REST API (OpenAPI): https://xpost.to/api/v1/openapi.json
• Set-up guides per client: https://xpost.to/docs

Self-hosting a client against your own instance

Replace https://xpost.to with your instance in the MCP address. For the REST fallback set XPOST_URL and XPOST_API_KEY.

License

MIT. The skill and manifests here are free to copy and adapt; xpost itself is a hosted service.