--- title: "Post with AI agents | Posty" description: "Through Posty's MCP server, REST API or posty-cli, ChatGPT, Claude, Codex and any AI agent of yours can schedule into your calendar." canonical: https://posty.hu/en/ai source: https://posty.hu/en/ai.md --- AI agent + Posty # Your agent schedules the posts for you Your agent writes the post, uploads the image and finds a time for it. You review and approve it in the Posty calendar before it goes out. [Get started](https://posty.hu/regisztracio)[How it works](#igy-mukodik) Paste this to your AI agent: Install the Posty CLI: npm install -g posty-cli, then log in: posty auth:login. The package SKILL.md file describes every command, details: https://posty.hu/ai ![ChatGPT](https://posty.hu/icons/ai/chatgpt.svg) ![Claude](https://posty.hu/icons/ai/claude.svg) ![Codex](https://posty.hu/icons/ai/codex.svg) ![OpenClaw](https://posty.hu/icons/ai/openclaw.svg) ![Hermes Agent](https://posty.hu/icons/ai/hermes.svg) ![Muse](https://posty.hu/icons/ai/muse.svg) Getting started ## Four commands, and it runs You install, sign in, list the connected accounts, then schedule the first post. Your agent runs the same commands. terminal ``` # The Posty command-line tool $ npm install -g posty-cli # Sign in: approve in the browser $ posty auth:login # Which social accounts are connected? $ posty integrations:list [{ "id": "cmf3k7…", "name": "Cafe · Instagram" }] # The first scheduled post $ posty posts:create \ $ -c "New brunch menu this Saturday." \ $ -i "cmf3k7…" \ $ -s "2026-08-16 09:00" --timezone Europe/Budapest ✅ Post created successfully! { "id": "cmf7p2…", "state": "QUEUE" } ``` The CLI writes the JSON response to stdout, and status and errors to stderr. On failure it exits with a non-zero code. That way the agent knows whether it worked. What you get ## Three ways in, one Posty account Want to chat? MCP. Want to script? CLI. Want to integrate? REST API. All three work today. ### Live MCP server Your agent connects to https://api.posty.hu/mcp, and from then on it sees the same Posty account you do. You create the key on the Settings → Developers page. ### Published command-line tool Install with: npm install -g posty-cli. The command name is posty. ### Public REST API The REST API is at api.posty.hu. It handles the same account as MCP and the CLI, just from your own code. ### No training needed SKILL.md ships in the npm package. The agent reads the real commands and flags from it, so you do not have to explain them. ### The calendar is where you approve The agent prepares and schedules. You have the last word before anything publishes. In the calendar you edit, reschedule or delete what you do not want. ### You keep your own model Posty has no built-in AI writer, on purpose. You work with the model you already use. Posty handles the publishing. How it works ## From accounts to approval You set up the connection once. After that your agent does the work, and you decide in the calendar. 1 ### Connect your accounts On the Posty web app, you connect your social accounts with the usual OAuth flow. The agent later works with those accounts and refers to them by id. Ids of the connected accounts terminal ``` $ posty integrations:list [ { "id": "cmf3k7…", "name": "Cafe · Instagram" }, { "id": "cmf3k9…", "name": "Cafe · Facebook" } ] ``` 2 ### Create a key Settings → Developers. Chat clients need an MCP key. The CLI and the REST API need an API key. We show the key once, when you create it. Settings → Developers .env ``` # Settings → Developers → New key # We show the key once, when you create it. # For the command line and the REST API: POSTY_API_KEY=AZ_API_KULCSOD # MCP clients get a separate key: # psty_mcp_… ``` 3 ### Hand it to the agent Chat clients only need a URL. Terminal clients need a command or a config block. On the Developers page you pick the client and copy the ready-made setup. Ready-made setup for every client MCP setup ``` # Browser assistant (ChatGPT, Claude app): # it only asks for this one address: https://api.posty.hu/mcp/AZ_API_KULCSOD # Claude Code: claude mcp add posty --transport http \ "https://api.posty.hu/mcp/AZ_API_KULCSOD" # Codex, ~/.codex/config.toml: [mcp_servers.posty] url = "https://api.posty.hu/mcp/AZ_API_KULCSOD" ``` 4 ### Review it, then it can go The agent puts the posts in the calendar. You go through them, fix what needs fixing, and only leave what can actually go out. Scheduled, but not published yet terminal ``` $ posty posts:list [ { "id": "cmf7p2…", "state": "QUEUE", "publishDate": "2026-08-16T07:00:00Z" }, { "id": "cmf7q8…", "state": "DRAFT", "publishDate": "2026-08-18T06:30:00Z" } ] ``` Built for agents ## Predictable input, a clear response The agent does not have to fuss with the web UI. It gets a structured response, and it reaches the same account three ways. - Machine-readable JSON Every command writes the JSON response to stdout, so the agent can parse it directly. - An error is really an error The CLI writes status and errors to stderr. On failure it exits with a non-zero code. - Skill file in the package SKILL.md shows the available commands, the flags and the two rules you cannot skip. - A flat command set No hidden state, and no step to guess: the agent works from a clear list. - Three ways to the same place MCP for the conversation, CLI for scripts, REST API for your own code: the same account. SKILL.md ``` --- name: posty description: Posty schedules and publishes social posts from the command line. homepage: https://posty.hu --- # Output contract Every command prints its JSON result — and nothing else — to stdout; status lines, warnings and errors go to stderr, and every failure exits 1. # Two Hard Rules (Read First) Rule 1 — Authenticate before anything. Rule 2 — Every file passed to `-m` MUST first go through `posty upload`. ``` SKILL.md is part of the npm package. The agent reads the exact CLI usage from it: no extra training, and no invented flags. Supported clients ## The same Posty, several agents Each one has its own page with the exact setup. If yours is not among them, that is fine: Posty uses a standard MCP server. [![ChatGPT](https://posty.hu/icons/ai/chatgpt.svg) — ChatGPT — You add Posty as a connector, then you ask it to schedule from the conversation. — Így kötöd össze](https://posty.hu/en/ai/chatgpt)[![Claude](https://posty.hu/icons/ai/claude.svg) — Claude and Claude Code — From the app with a connector, from the terminal with a single command. The same account in both places. — Így kötöd össze](https://posty.hu/en/ai/claude)[![OpenClaw](https://posty.hu/icons/ai/openclaw.svg) — OpenClaw — Your background agents upload media, write posts and schedule them while you are away. — Így kötöd össze](https://posty.hu/en/ai/openclaw)[![Hermes Agent](https://posty.hu/icons/ai/hermes.svg) — Hermes — It connects as an MCP client. You do not need a local MCP server: a URL and a key in the config.yaml file are enough. — Így kötöd össze](https://posty.hu/en/ai/hermes)[![Muse](https://posty.hu/icons/ai/muse.svg) — Muse — Meta Muse Code schedules the announcement in the same session where the code was finished. — Így kötöd össze](https://posty.hu/en/ai/muse) ![Codex](https://posty.hu/icons/ai/codex.svg)Codex Cursor VS Code / Copilot Windsurf Amp Gemini CLI Warp These clients also need an MCP URL and a key. On the Developers page you get a copy-ready setup for each of them. Commands ## What your agent can run This is the full list: posts, social accounts, media, analytics, login, and the posts:create flags. Posts `posty posts:create`New post: scheduled, as a draft, or published right away. `posty posts:list`Posts in the given period. You can filter by client group too. `posty posts:delete `Delete a post by id. `posty posts:find-slot `The next free publishing time for a social account. `posty posts:status `Switch a post between draft and scheduled. `posty posts:missing `Content already on the platform for a post with a missing id. `posty posts:connect `Connect a post to content that is already published. Social accounts `posty integrations:list`Connected social accounts and their ids. This is what the -i flag needs. `posty integrations:groups`The list of client groups, if you work with more than one brand. `posty integrations:settings `An account's settings schema, rules, length limit, and tools. `posty integrations:trigger `Call a platform tool for extra data, for example to search for music. Media and analytics `posty upload `Upload a media file. The URL you get back goes into the posts:create -m flag. `posty analytics:platform `A social account's stats going back the given number of days. `posty analytics:post `Performance of a single post. Login and settings `posty auth:login`Log in with OAuth2 device authorization: the browser opens, you approve. `posty auth:logout`Clear stored login data. `posty auth:status`Shows whether you're logged in, and checks access too. `posty config:set <érték>`Save a CLI setting, for example the default timezone. `posty config:get [kulcs]`Print the saved settings. posts:create flags `-c, --content`The post text. Repeat it to make a thread: the first is the post, the rest are comments. `-m, --media`Media for the -c that comes before it. The URL has to come from posty upload. `-i, --integrations`Ids of the target social accounts, comma-separated. `--date, -s`When to publish. Either with an explicit offset, or together with the --timezone flag. `--timezone`IANA timezone name, for example Europe/Budapest. Only pass a date with no offset together with this. `-t, --type`schedule (default), draft, or now. `-d, --delay`Delay in MINUTES between items in the thread. `--json`The full post description from a JSON file, when the flags are not enough. `--settings`Platform-specific settings as JSON. The schema comes from integrations:settings. The full help is printed by posty --help. An unknown flag is not ignored: it errors. If it rejects a flag, that flag does not exist. Supported platforms ## One account, every channel Connect your accounts in a few clicks, then post to every channel from Posty. ![TikTok](https://posty.hu/icons/brand/tiktok-app.svg) ### TikTok ![Instagram](https://posty.hu/icons/brand/instagram-app.svg) ### Instagram ![Facebook](https://posty.hu/icons/brand/facebook-app.svg) ### Facebook ![Threads](https://posty.hu/icons/brand/threads-app.svg) ### Threads ![LinkedIn](https://posty.hu/icons/brand/linkedin-app.svg) ### LinkedIn YouTube ### YouTube ![X](https://posty.hu/icons/brand/x-app.svg) ### X ![Pinterest](https://posty.hu/icons/brand/pinterest-app.svg) ### Pinterest coming soon ![Bluesky](https://posty.hu/icons/brand/bluesky-app.svg) ### Bluesky ![Google Business](https://posty.hu/icons/brand/gmb-app.svg) ### Google Business coming soon ![Discord](https://posty.hu/icons/brand/discord-app.svg) ### Discord ![Telegram](https://posty.hu/icons/brand/telegram-app.svg) ### Telegram ![Slack](https://posty.hu/icons/brand/slack-app.svg) ### Slack …and more to come Pricing ## Hungarian pricing, no hidden costs Minden csomag 7 napos ingyenes próbával indul, ma 0 Ft fizetendő, és bármikor lemondható. Forintban számlázunk, áfás számlával. | Csomag | Havi | Éves (havi bontásban) | Éves egy összegben | | --- | --- | --- | --- | | Alap | 4 990 Ft/hó | 4 158 Ft/hó | 49 900 Ft | | Pro | 8 990 Ft/hó | 7 492 Ft/hó | 89 900 Ft | | Kreátor | 18 990 Ft/hó | 15 825 Ft/hó | 189 900 Ft | | Csapat | 34 990 Ft/hó | 29 158 Ft/hó | 349 900 Ft | Minden csomag tartalmazza: - Korlátlan poszt - Több fiók platformonként - Időzítés - Naptár nézet - Ismétlődő posztok - Poszt késleltetés - Stúdió hozzáférés - Analitika (béta) - Poszt hozzászólások - Sötét és világos mód ### Alap For solo creators new to scheduling - **Havi előfizetés:** 4 990 Ft/hó - **Éves előfizetés:** 4 158 Ft/hó — évente egy összegben 49 900 Ft (2 hónap ajándék) - 5 közösségi fiók - 1 munkaterület - Egy felhasználó - ~~Haladó képszerkesztő~~ - ~~Virális videó és UGC sablonok~~ - ~~Automatizációk~~ - ~~API-hozzáférés~~ - ~~Posztolás AI-ügynökkel~~ ### Pro — Most popular If you create both images and videos - **Havi előfizetés:** 8 990 Ft/hó - **Éves előfizetés:** 7 492 Ft/hó — évente egy összegben 89 900 Ft (2 hónap ajándék) - 10 közösségi fiók - 1 munkaterület - 3 felhasználó - Haladó képszerkesztő - Virális videó és UGC sablonok - Automatizációk - API-hozzáférés - Posztolás AI-ügynökkel ### Kreátor For creators managing multiple brands or clients - **Havi előfizetés:** 18 990 Ft/hó - **Éves előfizetés:** 15 825 Ft/hó — évente egy összegben 189 900 Ft (2 hónap ajándék) - 30 közösségi fiók - 5 munkaterület - Korlátlan felhasználó - Haladó képszerkesztő - Virális videó és UGC sablonok - Automatizációk - API-hozzáférés - Posztolás AI-ügynökkel ### Csapat — Highest limits For agencies managing many channels - **Havi előfizetés:** 34 990 Ft/hó - **Éves előfizetés:** 29 158 Ft/hó — évente egy összegben 349 900 Ft (2 hónap ajándék) - 100 közösségi fiók - 15 munkaterület - Korlátlan felhasználó - Haladó képszerkesztő - Virális videó és UGC sablonok - Automatizációk - API-hozzáférés - Posztolás AI-ügynökkel ## Common questions #### Which platforms can my agent schedule to? Posty handles 12+ platforms: Facebook, Instagram, TikTok, LinkedIn, X, YouTube, Pinterest, Threads, Discord, Bluesky, Telegram, Slack and Google Business Profile. The agent only works with accounts already connected in Posty. #### Where do I create an MCP key? In Posty, on the Settings → Developers page. The MCP key starts with psty\_mcp\_, and that is what you put in your MCP client setup. We only show the key when you create it, so save it right away. #### How do I install the command-line tool? With npm install -g posty-cli. The installed command is named posty. The two names differ on purpose: the bare posty name on npm belongs to a package that is not ours. Never install that. The source is at github.com/norbertlevente/posty-agent, licensed AGPL-3.0. #### Can the agent upload images and video too? Yes. First it uploads the file with posty upload, gets a URL back, and passes that to the -m flag. The publishing flow rejects a plain filename and an external link too. #### Which plan includes all of this? The MCP server, the command-line tool and the public REST API are part of the Pro, Kreátor and Csapat plans. There is no extra charge, and you do not have to negotiate it with anyone. #### Does Posty write the post for me? No, and that is on purpose. Posty has no built-in AI writer: the agent you already work with writes the text. Posty handles the connection, the scheduling, the publishing and the calendar. Get started today ## Hand scheduling over to your agent. Connect your accounts, create a key, and pick MCP, the CLI or the REST API. The last word in the calendar stays yours. [Start your free trial](https://posty.hu/regisztracio) 7 days free · 0 Ft due today · cancel anytime