--- title: "Social Media API for AI Agents: MCP, CLI, REST" description: "Give Claude, ChatGPT, Grok Bot or your own agent 21 tools to schedule posts, make images and read results on 30+ networks, over MCP, the CLI or REST." canonical_url: "https://postqueen.ai/api/ai-agents" markdown_url: "https://postqueen.ai/api/ai-agents.md" last_updated: "2026-09-25" llms_txt: "https://postqueen.ai/llms.txt" --- # Give your AI agent a publish button. Social media API for AI agents One MCP address, the CLI or the REST API gives Grok Bot, Muse, Claude or your own agent 21 tools to find channels, schedule posts, make images and read results. Every post lands on one calendar you can check before it goes out. [Start 7-day trial for $0](https://app.postqueen.ai/auth?utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=ai-agents-hero) [Read the MCP docs](https://docs.postqueen.ai/mcp/introduction) $0 due today. Cancel in one click. Works with any agent that speaks MCP or runs a command - NEW Grok Bot - NEW Muse - ChatGPT - Claude - OpenClaw - Hermes - Claude Code - Codex - Cursor - Gemini CLI - Paperclip - Any MCP app Three ways in ## Three ways in. One calendar. Whatever your agent speaks, it reaches the same channels, the same network rules and the same calendar your team uses. ### MCP server For agents that speak MCP. Paste one address and the agent finds 21 tools on its own. Hosted, with nothing to run. ``` https://api.postqueen.ai/mcp/YOUR_API_KEY ``` [How the MCP server works](https://postqueen.ai/mcp) ### CLI and skill For agents that run commands. The skill teaches them the right order: channels, the network’s rules, media, then the post. ``` npm install -g postqueen npx skills add GkhanKINAY/postqueen-agent ``` [The PostQueen CLI](https://postqueen.ai/cli) ### REST API For your own agent’s code. Plain HTTPS and JSON with the same key, or an OAuth token when other workspaces sign in. ``` POST /public/v1/posts Authorization: YOUR_API_KEY ``` [The social media API](https://postqueen.ai/api) MCP CLI API One calendar, one set of rules One calendar 30+ networks Connect your agent ## One step. Any agent. Pick your agent to see exactly what to paste. Every agent uses the same key and reaches the same 21 tools. **Claude Code** In your terminal Set up from the maker’s docs ``` claude mcp add --transport http postqueen \ https://api.postqueen.ai/mcp/YOUR_API_KEY ``` Add --scope user to use PostQueen in every project. **Codex** In your terminal Set up from the maker’s docs ``` codex mcp add postqueen \ --url https://api.postqueen.ai/mcp/YOUR_API_KEY ``` Saved in ~/.codex/config.toml, which the CLI, the IDE extension and the ChatGPT desktop app all read. **Gemini CLI** In your terminal Set up from the maker’s docs ``` gemini mcp add --transport http --scope user \ postqueen https://api.postqueen.ai/mcp/YOUR_API_KEY ``` Gemini CLI takes the key. --scope user makes PostQueen work in every folder. **Cursor** ~/.cursor/mcp.json Set up from the maker’s docs ``` { "mcpServers": { "postqueen": { "url": "https://api.postqueen.ai/mcp/YOUR_API_KEY" } } } ``` Then open Customize > MCPs and check that PostQueen is on. **Hermes Agent** ~/.hermes/config.yaml Set up from the maker’s docs ``` mcp_servers: postqueen: url: "https://api.postqueen.ai/mcp/YOUR_API_KEY" ``` Start a new hermes chat, or type /reload-mcp, then run hermes mcp test postqueen. **OpenClaw** Where the gateway runs Set up from the maker’s docs ``` npm install -g postqueen npx skills add GkhanKINAY/postqueen-agent -g -a openclaw ``` The skill teaches OpenClaw the PostQueen commands, and the CLI runs them. **Claude** Customize > Connectors Key address tested ``` 1 + > Add custom connector 2 Name it PostQueen and paste: https://api.postqueen.ai/mcp/YOUR_API_KEY 3 Switch it on in a chat ``` Or use the sign-in address, and a workspace admin approves it. **ChatGPT** Developer mode Key address tested ``` 1 Settings > Security and login > Developer mode 2 chatgpt.com/plugins > +, Connection: https://api.postqueen.ai/mcp/YOUR_API_KEY 3 Authentication: No Authentication ``` Then pick PostQueen from the + menu under Developer mode. **Grok Bot** In a Grok Bot chat Tested end to end ``` Connect PostQueen as an MCP server at https://api.postqueen.ai/mcp ``` Choose Connect, then paste your key into the secure prompt, never into the chat. PostQueen tested Grok Bot end to end, and Claude and ChatGPT with the key address, on 19 September 2026. The other guides follow each maker’s own docs. [Every agent’s full guide](https://postqueen.ai/mcp#clients) Compare every agent ## Every agent, side by side. Every agent here connects to the same PostQueen account and gets the same tools. What changes is how you connect it and where it runs. Pick one to see its setup. | Agent | How you connect | Where it runs | Sign-in | Uploads | Images, video | | --- | --- | --- | --- | --- | --- | | [Grok Bot](https://postqueen.ai/grok-bot) NEW | Ask the Bot in chat to connect PostQueen, then paste your key in its secure card. Marketplace plugin soon | Grok Bot desktop app and mobile, running in the cloud | Key | Upload panel No | Yes | | [Muse](https://postqueen.ai/muse) NEW | Ask Muse in chat to build a custom connector, then paste your key in its secure prompt | Muse app (iOS, Android), muse.ai and WhatsApp, in the US | Key | Upload panel No | Yes | | [OpenClaw](https://postqueen.ai/openclaw) | PostQueen skill and CLI on your gateway, or MCP with a header | Your OpenClaw gateway, chatting from WhatsApp, Telegram, Slack and more | Key or sign-in | Upload panel No | Yes | | [Hermes Agent](https://postqueen.ai/hermes-agent) | One mcp_servers entry in ~/.hermes/config.yaml | Your computer, a server or Hermes Cloud, chatting from Telegram, Discord and more | Key or sign-in | Upload panel No | Yes | | [Claude](https://postqueen.ai/claude) | Custom connector under Customize > Connectors | claude.ai, Claude Desktop, iOS and Android | Sign-in or key | Upload panel Yes | Yes | | [ChatGPT](https://postqueen.ai/chatgpt) | Developer mode app at chatgpt.com/plugins | ChatGPT on the web | Sign-in or key | Upload panel Yes | Yes | | [Claude Cowork](https://postqueen.ai/claude-cowork) | The same custom connector as Claude, on in a Cowork task | Claude Desktop | Sign-in or key | Upload panel Yes | Yes | | [Grok](https://postqueen.ai/grok) | Custom connector at grok.com/connectors | grok.com and the Grok iOS and Android apps | Key | Upload panel No | Yes | | [Perplexity Computer](https://postqueen.ai/perplexity-computer) | Custom remote connector in Perplexity settings | Web, iOS, Android, Comet, Slack and email | Key | Upload panel No | Yes | | [NanoClaw](https://postqueen.ai/nanoclaw) | Three commands: key in the OneCLI vault, server in your agent group | Your Mac or Linux machine with Docker, chatting from WhatsApp, Telegram and more | Key | Upload panel No | Yes | | [Claude Code](https://postqueen.ai/claude-code) | One command: claude mcp add | Terminal on macOS, Linux and Windows, plus IDEs | Key or sign-in | Upload panel No | Yes | | [Codex](https://postqueen.ai/codex) | One command: codex mcp add | Codex CLI, IDE extension and desktop app | Key or sign-in | Upload panel No | Yes | | [Cursor](https://postqueen.ai/cursor) | One entry in mcp.json | Cursor on macOS, Windows and Linux, and the Cursor CLI | Key or sign-in | Upload panel No | Yes | | [Gemini CLI](https://postqueen.ai/gemini-cli) | One command: gemini mcp add | Terminal on macOS, Windows and Linux | Key | Upload panel No | Yes | | [Grok Build](https://postqueen.ai/grok-build) | One command: grok mcp add | Terminal on macOS, Linux and Windows | Key or sign-in | Upload panel No | Yes | | [Paperclip](https://postqueen.ai/paperclip) | Apps > Connect your own MCP server | Your own server, for its Claude Code and Codex agents | Key or sign-in | Upload panel No | Yes | | [Other MCP apps](https://postqueen.ai/mcp) | VS Code, Devin Desktop, Zed, Muse Code and more: one entry with the MCP address | Your editor or terminal | Key or sign-in | Upload panel No | Yes | Sign-in means PostQueen’s sign-in page approves the agent, and an API key goes in the address or a header. The upload panel lets you add files from your device in the chat. Every agent can make AI images and video through PostQueen. The tools ## 21 tools, grouped by the job. Your agent never needs a list. It reads the tools when it connects and picks the ones your request needs. ### Channels 4 tools List channels and customers, read each network’s rules and settings, and look up values a setting needs. - integrationList - groupList - integrationSchema - triggerTool ### Posts 4 tools Save a draft, schedule a post or publish now, list and read posts, and change the settings of one that has not gone out. - integrationSchedulePostTool - postsListTool - postReadTool - postSettingsTool ### Analytics 3 tools Totals over 7, 30 or 90 days, your best posts ranked, and the numbers for one post. - analyticsSummaryTool - analyticsPostsTool - analyticsPostTool ### Uploads 4 tools Bring media in from a link, or open an upload panel in Claude, ChatGPT and Claude Cowork. - uploadFromUrlTool - uploadWidgetTool - uploadWidgetTicketTool - uploadWidgetStatusTool ### Images and video 5 tools Make an image for a post, or start a video job and follow it, with your plan’s AI credits. - generateImageTool - generateVideoOptions - videoFunctionTool - generateVideoTool - videoStatusTool ### Agent 1 tool Hand over a whole request, and PostQueen’s own agent runs the other tools. It asks before it schedules. - ask_postqueen **Left to you on purpose:** deleting a post, and changing its text or time. Do those in the app, the CLI or the API. [Every tool, in the docs](https://docs.postqueen.ai/mcp/tools) What agents run ## Ask like you would ask a person. Real requests, and the tools an agent calls to answer them. Every result lands on the calendar. - Write a launch thread about our new feature for X and Bluesky, for 9:00 tomorrow. 1. integrationList 2. integrationSchema 3. integrationSchedulePostTool A thread scheduled on two channels - Write three posts for next week, each with an image. Keep them as drafts. 1. generateImageTool 2. integrationSchedulePostTool Three drafts with images - Which post did best this month? Write two more like it. 1. analyticsPostsTool 2. integrationSchedulePostTool Two drafts in the winning style - Post the video at this link to our channels on Friday at 18:00. 1. uploadFromUrlTool 2. integrationSchedulePostTool Video uploaded and scheduled - Make a narrated slideshow about our new feature. 1. generateVideoOptions 2. generateVideoTool 3. videoStatusTool A vertical video in your library - What is on the calendar for Northside Coffee next week? 1. groupList 2. postsListTool That customer’s week, listed Guardrails ## Autonomous, not unsupervised. Your agent does the busywork. The decisions that matter stay with a person. - Drafts wait for a person Ask for drafts and nothing publishes until someone schedules it. - No deleting over MCP An agent can create, schedule and read. It cannot delete a post or change its text or time. - Checked like the app Every post passes the network’s rules first. One that breaks a rule is refused with the reason, and nothing is saved. - Keys stay with admins Only a workspace Admin or Super Admin can reveal or rotate the key. Rotating ends the old key at once. - Sign-in needs an admin Agents that sign in never see a key. An admin approves them and can revoke them in Connections, under Approved Apps. - Built for your product too Register an OAuth app, and each workspace that approves it gives you a pos\_ token of its own. On a schedule ## Put your agent on a schedule. Agents like Hermes and OpenClaw run jobs on their own clock. Give one a standing job, and read its drafts with your morning coffee. ### The weekly loop 1. 1 Read what worked analyticsPostsTool ranks last month’s posts. 2. 2 Draft more of it integrationSchedulePostTool saves new drafts. 3. 3 A person schedules You pick the best on the calendar. Hermes Agent, a cron job ``` hermes cron create "weekdays at 9am" \ "Save a PostQueen draft from my notes" ``` OpenClaw, an automation ``` openclaw automations create "0 9 * * 1-5" \ "Save a PostQueen draft from today's notes." \ --name "Daily draft" --session isolated ``` Or build the loop in n8n with the PostQueen node, or in your own agent with the REST API. Pricing ## Four plans. Unlimited posts on every one. Every plan has the MCP server, the CLI and the REST API, with no charge per agent or per call. Plans differ in channels, team seats and AI credits. save 4 months on Pro ### Creator For solo creators $20 a month billed monthly, or $11 a month billed yearly ($132 a year, you save $108) [Start 7-day free trial](https://app.postqueen.ai/auth?plan=CREATOR&period=MONTHLY&utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=pricing-creator) [Start 7-day free trial](https://app.postqueen.ai/auth?plan=CREATOR&period=YEARLY&utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=pricing-creator) - **5** social accounts - **Unlimited** posts - Not included No team members - **150** AI credits a month - **60 min** video clipping SOON - **2** webhook endpoints - **AI agent** connection over MCP - AI Copilot in the app - Design editor - CLI, REST API and Node SDK - Analytics - Auto reposts and comments - Threads and first comments - Repeating posts - RSS auto-post - Link shortening ### Growth For small teams $33 a month billed monthly, or $22 a month billed yearly ($264 a year, you save $132) [Start 7-day free trial](https://app.postqueen.ai/auth?plan=GROWTH&period=MONTHLY&utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=pricing-growth) [Start 7-day free trial](https://app.postqueen.ai/auth?plan=GROWTH&period=YEARLY&utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=pricing-growth) - **10** social accounts - **Unlimited** posts - **Unlimited** team members - **300** AI credits a month - **120 min** video clipping SOON - **10** webhook endpoints - **AI agent** connection over MCP - AI Copilot in the app - Design editor - CLI, REST API and Node SDK - Analytics - Auto reposts and comments - Threads and first comments - Repeating posts - RSS auto-post - Link shortening Most popular ### Pro For growing brands $49 a month billed monthly, or $33 a month billed yearly ($396 a year, you save $192) [Start 7-day free trial](https://app.postqueen.ai/auth?plan=PRO&period=MONTHLY&utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=pricing-pro) [Start 7-day free trial](https://app.postqueen.ai/auth?plan=PRO&period=YEARLY&utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=pricing-pro) - **30** social accounts - **Unlimited** posts - **Unlimited** team members - **500** AI credits a month - **300 min** video clipping SOON - **30** webhook endpoints - **AI agent** connection over MCP - AI Copilot in the app - Design editor - CLI, REST API and Node SDK - Analytics - Auto reposts and comments - Threads and first comments - Repeating posts - RSS auto-post - Link shortening ### Ultimate For agencies $99 a month billed monthly, or $66 a month billed yearly ($792 a year, you save $396) [Start 7-day free trial](https://app.postqueen.ai/auth?plan=ULTIMATE&period=MONTHLY&utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=pricing-ultimate) [Start 7-day free trial](https://app.postqueen.ai/auth?plan=ULTIMATE&period=YEARLY&utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=pricing-ultimate) - **Unlimited** social accounts - **Unlimited** posts - **Unlimited** team members - **1,000** AI credits a month - **600 min** video clipping SOON - **Unlimited** webhook endpoints - **AI agent** connection over MCP - AI Copilot in the app - Design editor - CLI, REST API and Node SDK - Analytics - Auto reposts and comments - Threads and first comments - Repeating posts - RSS auto-post - Link shortening - $0 due today. Cancel in one click. - Change plans anytime - Unlimited posts on every plan - Prices in USD, VAT added where it applies ## Agent questions, answered. ### API key or sign-in? The key address gives your agent all 21 tools. The sign-in address gives 20, everything except ask_postqueen, and a workspace Admin or Super Admin approves it. Grok Bot, Grok, Perplexity Computer, NanoClaw and Gemini CLI cannot sign in, so they take the key. ### Will my agent post without asking me? Only when you ask it to schedule or publish. Ask for drafts and they wait on your calendar until someone schedules them. An agent cannot delete a post over MCP. ### Which agents have you tested? Grok Bot end to end, and Claude and ChatGPT with the key address, on 19 September 2026. The guides for every other agent follow its maker’s docs. ### MCP or the CLI? MCP when your agent supports it, because it finds the tools on its own. The CLI for agents that run commands, for scripts and CI jobs, and for what MCP leaves out, like deleting a post or moving it between draft and scheduled. ### Does it cost extra per agent or per call? No. The MCP server, the CLI and the REST API come with every plan, for as many agents as you connect. Images and videos use your plan’s monthly AI credits. ### Are there limits? The REST API allows 30 POST /posts requests an hour per workspace, shared by the key, OAuth apps, the CLI and the SDK. One request can carry many channels and a whole thread. Each upload endpoint allows 300 an hour. Nothing else is limited, and no plan caps posts. ### Can I build a product on it? Yes. Register an OAuth app in Connections, under Developers. People approve it on a PostQueen consent screen, and you get a pos\_ token for their workspace that works on the REST API and the MCP server. ### Which networks can it post to? 30+, including X, Bluesky, Threads, Instagram, TikTok, LinkedIn, YouTube, WordPress, DEV and Hashnode, through each network’s official API wherever it has one. Anything else? Write to [support@postqueen.ai](mailto:support@postqueen.ai) and a person answers. ## More ways people use PostQueen - [Social media API Schedule posts from your own code with one request. Learn more](https://postqueen.ai/api) - [MCP server Set up PostQueen in your agent, step by step. Learn more](https://postqueen.ai/mcp) - [App developers Let your coding agent market the app you built. Learn more](https://postqueen.ai/for/app-developers) - [Founders Launch posts, demo videos and a post a day about your product. Learn more](https://postqueen.ai/for/founders) ### Your agent writes it. PostQueen posts it. Connect your agent in a minute. Its posts land on your calendar, and you decide when they go out. [Start 7-day trial for $0](https://app.postqueen.ai/auth?utm_source=postqueen.ai&utm_medium=landing&utm_campaign=trial&utm_content=band-ai-agents) $0 due today. Cancel in one click.