PostAxis MCP server

PostAxis has a remote Model Context Protocol (MCP) server. Connect it to Claude, ChatGPT, Cursor, Codex, Gemini, Grok or your own agent and ask it to write, schedule and publish posts to your connected X, Instagram, TikTok, LinkedIn, YouTube, Threads, Facebook Page and Telegram accounts. MCP is included in every PostAxis subscription.

Server URL

https://postaxis.io/api/mcp

Transport: Streamable HTTP (stateless). Connect your social accounts in the PostAxis dashboard first.

Sign-in

• OAuth (recommended, every plan): your AI app opens the PostAxis sign-in page; you approve access once. Supported by Claude, ChatGPT, Claude Code, Cursor, Codex, Gemini CLI and most MCP clients.
• API key (API add-on): for clients without OAuth, send Authorization: Bearer px_live_…, or append ?key=px_live_… to the URL for clients that only take a URL (Grok). API-key access covers your own workspaces and accounts.

Set up your client

Claude (web, desktop, mobile): Settings → Connectors → Add custom connector → paste the server URL → Connect → sign in to PostAxis and approve.

Claude Code:

claude mcp add --transport http postaxis https://postaxis.io/api/mcp

Then run /mcp, choose postaxis and sign in.

ChatGPT: Settings → Apps & Connectors → Advanced → turn on Developer mode → create a connector with the server URL and OAuth.

Cursor, Windsurf, Hermes and other config-based clients:

{
  "mcpServers": {
    "postaxis": {
      "type": "http",
      "url": "https://postaxis.io/api/mcp"
    }
  }
}

Codex: codex mcp add postaxis --url https://postaxis.io/api/mcp, then codex mcp login postaxis.

Gemini CLI: add {"mcpServers":{"postaxis":{"httpUrl":"https://postaxis.io/api/mcp"}}} to ~/.gemini/settings.json, then /mcp auth postaxis.

Grok: add a connector with https://postaxis.io/api/mcp?key=YOUR_API_KEY. Treat that URL like a password.

stdio-only clients: bridge with npx mcp-remote https://postaxis.io/api/mcp.

Step-by-step guides for each client are in the dashboard under Settings → API keys → Connect an AI agent.

Plugin and skill

The PostAxis plugin bundles this server with a postaxis skill that teaches agents the safe workflow (accounts first, platform rules before copy, media through PostAxis, no success claims without a confirmed post) and how to design carousels for render_images.

• postaxis-plugin.zip: for Claude Code, Cowork, Cursor, Gemini CLI and Grok.
• postaxis-skill.zip: the skill alone, for Claude on the web or desktop (Settings → Capabilities → Skills → upload), alongside the connector above.

Images and files

• Images the agent designs (carousels, slides, quote cards): render_images. The agent sends SVG and PostAxis renders the PNGs, so it works even where the agent's code sandbox has no internet access, such as Claude and ChatGPT.
• Your own photos and videos (for example an image you attach in the chat): the agent calls request_media_upload. Claude and ChatGPT show an upload box right in the chat (other apps get a postaxis.io link). Drop the file in and the agent picks it up with get_uploaded_media. Nothing to configure. To skip this step in Claude, see Let Claude upload your files directly.
• Agents running on your computer (Claude Code, Cursor, Codex) can also upload files directly with create_upload_link.
• Images already online: upload_media_from_url copies them from a public link.

Let Claude upload your files directly

By default Claude's code sandbox can't reach other websites, so when you give Claude a photo or video it shows a PostAxis upload box (or link) and you drop the file in. If you'd rather Claude upload attachments by itself every time, allow postaxis.io once:

Claude Pro or Max

1. Open Settings → Capabilities.
2. Make sure “Code execution and file creation” is on.
3. Turn on “Allow network egress”.
4. If you see a domain allowlist, add postaxis.io. If adding single domains isn't offered, choose “All domains”.
5. Start a new chat. Chats that were already open keep the old setting.

Claude Team or Enterprise (an Owner changes this for everyone)

1. Open Organization settings → Capabilities.
2. Under “Code execution and file creation”, choose “Allow network egress to package managers and specific domains”.
3. Add postaxis.io and save.
4. Everyone starts a new chat.

Claude's settings change from time to time; if a label looks different, look for the network or domain options under code execution. ChatGPT's code sandbox has no internet access at all, so there the upload box is the way to add files.

Tools

• list_workspaces (read-only): Your personal and team workspaces, and whether each one has an active subscription.
• list_accounts (read-only): Connected social accounts in a workspace (platform, handle, id).
• get_platform_rules (read-only): Caption limits and media rules per platform, so the agent writes posts that fit.
• render_images (writes): Turns up to 10 SVG designs (carousels, slides, quote cards) into PNG images on the PostAxis server, so the agent never has to upload a file.
• request_media_upload (writes): One-hour upload page on postaxis.io where you drop the photos or videos you want posted; works in every AI app with no settings.
• get_uploaded_media (read-only): Media you added on an upload page, in order, ready for a post.
• upload_media_from_url (writes): Copies an image (≤ 8 MB) or video (≤ 250 MB) from a public https URL into PostAxis.
• create_upload_link (writes): Upload link on postaxis.io for a file on your computer or phone, with a ready-to-run curl command.
• create_post (writes): One post to one or more accounts: publish now, schedule, or save as a draft, with per-platform captions.
• create_posts_bulk (writes): Up to 50 scheduled or draft posts at once (e.g. a 30-day calendar), with a validate-only preview.
• list_posts (read-only): Drafts, scheduled and published posts, filtered by date range.
• get_post (read-only): Per-platform publish status, links and errors for one post.
• update_post (writes): Edit a draft or scheduled post: caption, media, accounts or time.
• delete_post (destructive): Delete a draft or scheduled post. Agents are told to confirm with you first.

Things to try

• “List my PostAxis accounts.”
• “Post ‘hello from my agent’ to my connected accounts tomorrow at 9am Asia/Tashkent.”
• “Plan 30 days of posts about our launch for X and LinkedIn, show me the plan, then schedule it.”
• “Turn this blog post into a LinkedIn post and a 280-character X post and schedule both for Monday 10:00.”
• “Design a 7-slide carousel about our new feature and post it to my Telegram channel tonight at 19:00.”

Rules and limits

• Captions longer than a platform allows are rejected rather than cut off; the agent is told the limit to fix it.
• Times need a timezone (or a UTC offset); posts can be scheduled from 1 minute to 366 days ahead.
• Up to 300 new posts per account per 24 hours and 50 posts per bulk call.
• Only draft and scheduled posts can be edited or deleted; posts that are publishing or published can't.

Privacy and revoking access

Connected agents act only on workspaces and accounts you can access in PostAxis, using your permissions. PostAxis does not see your conversations with the AI app. Disconnect any agent at any time in Settings → API keys → Connected agents (API keys can be revoked on the same page). Details are in our Privacy Policy.

Support

Questions or problems: postaxis.io@gmail.com.