> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postqueen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents Overview

> Give any assistant that can run a command or call a tool hands on your calendar: install her skill, connect over MCP or call the public API.

## Just talk to her

Message her the way you would message a colleague. She answers inside ChatGPT and the Claude app, reads your WhatsApp and Telegram messages through OpenClaw or Hermes, and she is one command away in your terminal. Tell her what you want the world to see, and she takes care of the rest: the words, the visual and the schedule.

<Frame>
  <img src="https://mintcdn.com/forceplay/3MbWAJB4xKJ_Rxe0/images/brand/open-agents.svg?fit=max&auto=format&n=3MbWAJB4xKJ_Rxe0&q=85&s=bd3577e8169cbf2f5400a1ae3c6efbd9" alt="Chat apps feed OpenClaw, a one-line brief feeds Hermes, both drive the postqueen CLI and posts land on the calendar" width="660" height="380" data-path="images/brand/open-agents.svg" />
</Frame>

## She runs on your terms

Leave her alone and she is a true autopilot: whatever lands on the calendar goes out on time without another word from you. Want a closer look first? Everything is visible on the calendar before it publishes, so you can edit or delete it, and a post created as a draft is saved but never scheduled, so it sits there until you publish it.

## Three ways in

Any assistant that can run a shell command or call a tool can run your socials. Pick the one your assistant already speaks:

<CardGroup cols={3}>
  <Card title="Agent skill + CLI" icon="terminal" href="/cli/introduction">
    Install the skill and your agent drives the postqueen CLI, with clean JSON on every command
  </Card>

  <Card title="MCP" icon="plug" href="/mcp/setup">
    Point Claude, ChatGPT or any MCP client at her hosted server and its 11 tools
  </Card>

  <Card title="Public API" icon="code" href="/public-api/introduction">
    REST for your own scripts and automations, with your API key as the only setup
  </Card>
</CardGroup>

## 👑 Pick your agent

Whichever one you already use, you can be scheduling posts from it in a few minutes.

<CardGroup cols={3}>
  <Card title="OpenClaw" icon="https://mintcdn.com/forceplay/3MbWAJB4xKJ_Rxe0/images/brand/icon-openclaw.svg?fit=max&auto=format&n=3MbWAJB4xKJ_Rxe0&q=85&s=fbaf0ea2f618f90c7b1bc9158e8848b8" href="/agents/openclaw" width="30" height="30" data-path="images/brand/icon-openclaw.svg">
    Lives on your machine and turns WhatsApp and Telegram into her front door
  </Card>

  <Card title="Hermes" icon="https://mintcdn.com/forceplay/3MbWAJB4xKJ_Rxe0/images/brand/icon-hermes.svg?fit=max&auto=format&n=3MbWAJB4xKJ_Rxe0&q=85&s=84776d6fc9d3839dde16ad7645bb819d" href="/agents/hermes" width="30" height="30" data-path="images/brand/icon-hermes.svg">
    Hand it one brief and it plans, writes and schedules your week over the CLI
  </Card>

  <Card title="Claude Code" icon="https://mintcdn.com/forceplay/3MbWAJB4xKJ_Rxe0/images/brand/icon-claude-code.svg?fit=max&auto=format&n=3MbWAJB4xKJ_Rxe0&q=85&s=624b5ccf64e6c7059b2798bb3d9a5fbd" href="/agents/claude-code" width="30" height="30" data-path="images/brand/icon-claude-code.svg">
    One MCP command or the skill, and your coding sessions can post too
  </Card>

  <Card title="ChatGPT" icon="https://mintcdn.com/forceplay/3MbWAJB4xKJ_Rxe0/images/brand/icon-chatgpt.svg?fit=max&auto=format&n=3MbWAJB4xKJ_Rxe0&q=85&s=2e4e28580778d19f3e5f8a885eca4603" href="/agents/chatgpt" width="30" height="30" data-path="images/brand/icon-chatgpt.svg">
    Add her as an MCP connector and schedule posts from a chat
  </Card>

  <Card title="Codex" icon="https://mintcdn.com/forceplay/3MbWAJB4xKJ_Rxe0/images/brand/icon-codex.svg?fit=max&auto=format&n=3MbWAJB4xKJ_Rxe0&q=85&s=7531906176cea7df45d5b6da9c1e8162" href="/agents/codex" width="30" height="30" data-path="images/brand/icon-codex.svg">
    Teach Codex her CLI so it ships the announcement along with the code
  </Card>

  <Card title="Cursor" icon="https://mintcdn.com/forceplay/3MbWAJB4xKJ_Rxe0/images/brand/icon-cursor.svg?fit=max&auto=format&n=3MbWAJB4xKJ_Rxe0&q=85&s=5c67bafd9e5b9681232c0ba784fac6d5" href="/agents/cursor" width="30" height="30" data-path="images/brand/icon-cursor.svg">
    Bring her into your editor and post without leaving it
  </Card>
</CardGroup>

Talking to her in a chat app instead? She answers in
[WhatsApp, Telegram and the rest](/agents/chat-channels), and
[Claude on the web and your phone](/agents/claude-apps) is a connector away.

Using something else? These reach her over MCP instead of the agent skill, so their setup lives
with the MCP client guides:

<CardGroup cols={2}>
  <Card title="Gemini CLI" icon="https://mintcdn.com/forceplay/3MbWAJB4xKJ_Rxe0/images/brand/icon-gemini-cli.svg?fit=max&auto=format&n=3MbWAJB4xKJ_Rxe0&q=85&s=1a8e58041a86b8c765f3e545f9412eaf" href="/agents/gemini-cli" width="30" height="30" data-path="images/brand/icon-gemini-cli.svg">
    One command in the terminal, and the release notes write themselves
  </Card>

  <Card title="Any MCP client" icon="https://mintcdn.com/forceplay/MPQUZu1_FMpoCr-W/images/brand/icon-other-clients.svg?fit=max&auto=format&n=MPQUZu1_FMpoCr-W&q=85&s=ae713744a00edb7f6c20f7f898c78f8a" href="/mcp/clients/other-clients" width="30" height="30" data-path="images/brand/icon-other-clients.svg">
    One URL, one header, and she is a tool the agent can call
  </Card>
</CardGroup>

<Info>
  **Anything that runs a shell command.** A tool that can execute `postqueen` drives her without MCP
  and without anything to connect: install the skill, export your key, and it can schedule while you
  work. A cron job or a CI step qualifies on the same terms.
</Info>

Curious what makes her easy for an agent to drive? Read [Why agents love her](/agents/why-agents).

## Install the skill

One command installs her skill into any coding agent that supports the `skills` registry:

```bash theme={"system"}
npx skills add GkhanKINAY/postqueen-agent
```

What lands is her `SKILL.md`, a playbook that teaches your agent how she works before it runs a
single command. After reading it, the agent knows how to find your channels, ask each platform
what it accepts, fetch things that cannot be hardcoded like subreddit flairs, and upload media
the way she requires.

<Card title="Install the skill, step by step" icon="download" href="/agents/skill-install">
  The API key, the CLI, self-hosted setup, and a table of what goes wrong with each fix
</Card>

Every agent session then runs the same loop: authenticate, find your channels, prepare media,
post, check the numbers. All seven steps with the command each one runs:
[Why agents love her](/agents/why-agents).

## Connect over MCP

Prefer tool calls over shell commands? PostQueen speaks MCP at one URL she hosts, so an MCP client gets 11 tools to list your channels, upload media and schedule posts without installing anything.

There is one URL and every client takes it a slightly different way: a single command in Claude
Code, one JSON entry in Cursor, a connector form on claude.ai, a bridge in Claude Desktop.

<CardGroup cols={2}>
  <Card title="Connect your client" icon="plug" href="/mcp/setup">
    The URL, both auth forms, and the steps for each client
  </Card>

  <Card title="Every tool" icon="wrench" href="/mcp/tools">
    All 11, with the parameters each one takes
  </Card>
</CardGroup>

## From your chat apps

Message her on WhatsApp or Telegram through OpenClaw or Hermes, and the same route brings her into Slack and Discord. Prefer the browser? [app.postqueen.ai](https://app.postqueen.ai) runs your whole calendar from your phone too. Setup: [OpenClaw](/agents/openclaw) and [Hermes](/agents/hermes).

<Frame>
  <img src="https://mintcdn.com/forceplay/MPQUZu1_FMpoCr-W/images/brand/phone-agent.svg?fit=max&auto=format&n=MPQUZu1_FMpoCr-W&q=85&s=0d25a7d6f4897fc6a99a127049871bea" alt="A phone chat: you ask her to push today's podcast to X and LinkedIn at 5pm and she answers that two posts are scheduled and waiting on your calendar" width="300" height="560" data-path="images/brand/phone-agent.svg" />
</Frame>

## Try saying

Once she is connected, talk to her in plain words:

> *"Plan a month of content for our coffee shop and fill the calendar."*

> *"Take this photo of today's special and put it on Instagram at lunchtime."*

> *"We just hit 10k followers, write a warm thank-you post for all our channels."*

> *"Turn my latest YouTube video into posts for X, LinkedIn and Threads."*

She turns any of those into scheduled posts across your channels, and the calendar stays yours to review.

## Next steps

<CardGroup cols={2}>
  <Card title="Install the skill" icon="download" href="/agents/skill-install">
    One command teaches your assistant the whole CLI.
  </Card>

  <Card title="Connect over MCP" icon="network-wired" href="/mcp/setup">
    Copy-paste configuration for Claude, ChatGPT, Cursor and the rest.
  </Card>

  <Card title="Chat from your phone" icon="mobile" href="/agents/openclaw">
    WhatsApp and Telegram, through OpenClaw.
  </Card>

  <Card title="Why she suits agents" icon="lightbulb" href="/agents/why-agents">
    What makes the calendar easy for an assistant to drive.
  </Card>
</CardGroup>

<CardGroup cols={1}>
  <Card title="No channel connected yet?" icon="rocket" href="/quickstart">
    Start here. An agent needs somewhere to post before any of this helps.
  </Card>
</CardGroup>
