---
title: "Hermes + Posty: schedule posts through MCP | Posty"
description: "Hermes agents post to 12+ social platforms through Posty's MCP server. Your team reviews them in the calendar."
canonical: https://posty.hu/en/ai/hermes
source: https://posty.hu/en/ai/hermes.md
---

![Hermes Agent](https://posty.hu/icons/ai/hermes.svg)

Hermes and Posty

# Your Hermes agent manages your calendar

It puts the content from the conversation into the calendar, lists your connected accounts, then reads posts back or rearranges them. It can pull analytics too.

[Get started](https://posty.hu/regisztracio)[How to connect](#igy-mukodik)

Paste this to Hermes:

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/hermes

Second way

## Start with the CLI

Four commands install the CLI, sign you in, check your connected accounts, then create a post. That way you can work outside the conversation too.

terminal

```
# Install the Posty CLI
$ npm install -g posty-cli

# Sign in to your Posty account
$ posty auth:login

# Check your connected accounts
$ posty integrations:list
[{ "id": "cmf3k7…", "name": "Cafe · Instagram" }]

# Put a post on the calendar
$ 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 JSON to stdout, and sends status and errors to stderr. On failure it exits with a non-zero code.

Once connected

## What the Hermes agent handles

From the conversation it reaches the same Posty account as the CLI and the REST API. You still review posts in the calendar.

### From the conversation

The Hermes agent assigns the content from the conversation to your connected accounts. It writes the post into the Posty calendar, then reads it back so you can check it.

### Uploading media

You upload media in a separate step. In the CLI, posty upload returns the URL that the -m after that -c uses.

### Read and rearrange

The agent fetches the Posty calendar, so it can see posts already scheduled. If the plan changes, it moves them to a new time.

### CLI, second way

You can reach the same Posty account from the published CLI. Build non-conversation workflows without Hermes, using posty commands.

### REST, third way

The public REST API gives access to the same Posty account. Use it when the workflow does not go through MCP or the CLI.

### Approval in the calendar

The agent writes and rearranges posts, and you review them in the Posty calendar. You still approve them before they go out.

Four steps

## How Hermes connects

Posty gives you a ready-made config block. The connection is remote, so you do not need to install a local MCP server.

1

### Connect your accounts

On the Posty web app, add the social accounts you want to use with OAuth. After they are connected, the agent can see them.

Connected accounts in Posty

terminal

```
$ posty integrations:list
[
  { "id": "cmf3k7…", "name": "Cafe · Instagram" },
  { "id": "cmf3k9…", "name": "Cafe · Facebook" }
]
```

2

### Create the key

Open Settings → Developers and create a key that starts with psty\_mcp\_…. The ready-made Hermes config block is on the same page.

Key and ready-made Hermes block

.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

### Paste the block

Copy the full block from Posty under the mcp\_servers section of ~/.hermes/config.yaml. The block contains the connection name, URL and key.

Posty under mcp\_servers

~/.hermes/config.yaml

```
mcp_servers:
  posty:
    url: "https://api.posty.hu/mcp/AZ_API_KULCSOD"
```

4

### Check the calendar

The agent schedules the posts, and you review and approve them in the Posty calendar before they go out. If needed, the agent moves them to a new time.

Approval in the Posty calendar

terminal

```
$ posty posts:list
[
  { "id": "cmf7p2…", "state": "QUEUE",
    "publishDate": "2026-08-16T07:00:00Z" },
  { "id": "cmf7q8…", "state": "DRAFT",
    "publishDate": "2026-08-18T06:30:00Z" }
]
```

![Hermes Agent](https://posty.hu/icons/ai/hermes.svg)

In short

## What is Hermes?

Hermes is an agent platform that connects the agents running on it to external tools over MCP. It reaches Posty's remote MCP server over streaming HTTP, so you do not need to install a local server. Once connected, the agent works in the Posty account.

The agent running in Hermes lists your connected accounts from the task in the conversation, and writes a post into the Posty calendar. It reads it back, rearranges it if needed, then fetches analytics.

It reaches Posty over a remote MCP connection. You copy the config block from Settings → Developers into Hermes's config.yaml. You can reach the same account from the CLI and the public REST API too.

### Hermes

The agent runs here, and this is where your task starts. It reaches Posty's tools over MCP.

### Remote MCP

The server runs on Posty's infrastructure. Hermes reaches it over streaming HTTP, so it does not need to install a local MCP server.

### Posty calendar

Posts the agent schedules land in the Posty calendar. You read them through and approve them here before they go out.

Built for agents

## A predictable interface, three ways in

You can parse Posty's responses and errors by machine. You reach the account over MCP, the CLI and the REST API.

- JSON on the output The output is JSON, so the agent can parse the command result directly.
- Clear error signals It writes status and errors to stderr. On failure the exit code is non-zero.
- Built-in skill file From the package SKILL.md file, the agent learns the CLI with no extra training.
- Flat command set It gets a single, flat command set, with no hidden state. Every operation is a clear call.
- Three ways in It reaches the same Posty account over MCP, the CLI and the public REST API.

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`.
```

The npm package includes the SKILL.md file. The agent learns the CLI from it, with no extra explanation.

See how other agents connect to the same Posty account.

[![ChatGPT](https://posty.hu/icons/ai/chatgpt.svg)ChatGPT](https://posty.hu/en/ai/chatgpt)[![Claude](https://posty.hu/icons/ai/claude.svg)Claude](https://posty.hu/en/ai/claude)[![Gemini](https://posty.hu/icons/ai/gemini.svg)Gemini](https://posty.hu/en/ai/gemini)[![OpenClaw](https://posty.hu/icons/ai/openclaw.svg)OpenClaw](https://posty.hu/en/ai/openclaw)[![Muse](https://posty.hu/icons/ai/muse.svg)Muse](https://posty.hu/en/ai/muse)[All AI integrations](https://posty.hu/en/ai)

CLI commands

## The same from a terminal

The posty commands handle posts, integrations, analytics, uploads, config and auth. The CLI is licensed AGPL-3.0.

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 <id>`Delete a post by id.

`posty posts:find-slot <id>`The next free publishing time for a social account.

`posty posts:status <id>`Switch a post between draft and scheduled.

`posty posts:missing <id>`Content already on the platform for a post with a missing id.

`posty posts:connect <id>`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 <id>`An account's settings schema, rules, length limit, and tools.

`posty integrations:trigger <id> <method>`Call a platform tool for extra data, for example to search for music.

Media and analytics

`posty upload <fájl>`Upload a media file. The URL you get back goes into the posts:create -m flag.

`posty analytics:platform <id>`A social account's stats going back the given number of days.

`posty analytics:post <id>`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 <kulcs> <é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 CLI writes JSON to stdout, and status and errors to stderr.

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

#### Do I need to install a local MCP server for Hermes?

No. Posty's MCP server runs on Posty's infrastructure, and Hermes connects to it over streaming HTTP. The server URL is https://api.posty.hu/mcp.

#### Where do I get the Hermes config?

In Posty, open Settings → Developers. You can create a key that starts with psty\_mcp\_… there, and you get the ready-made config block on the same page. Paste it under the mcp\_servers section of ~/.hermes/config.yaml.

#### What can the Hermes agent do after it is connected?

It lists connected accounts, writes posts to the calendar, then reads them back and rearranges them. It can fetch analytics too. You review and approve the posts in the Posty calendar before they go out.

#### Which npm package should I install for the CLI?

Use npm install -g posty-cli. The installed command is named posty. The bare posty package name on npm belongs to a different package.

#### Does Posty write the copy for me?

No. Posty has no built-in AI writer, on purpose. You bring your own model, and the agent running in Hermes uses Posty's connection interface.

#### Which plan includes MCP, the CLI and the REST API?

The Pro, Kreátor and Csapat plans include MCP, the public REST API and the CLI. The Alap plan does not include these three.

Get started today

## Connect Hermes to Posty.

Create the key on the Settings → Developers page, then paste the block you get into the Hermes config. After that the agent works in the Posty calendar.

[Start your free trial](https://posty.hu/regisztracio)

7 days free · 0 Ft due today · cancel anytime
