Posterly
Hermes + npm MCP + HTTP MCP + skills

Schedule social posts from Hermes

Connect Hermes to posterly with the real npm MCP server, direct HTTP MCP, REST API calls, or a reusable skill file. Then let your agent create, schedule, and analyse posts across 11 platforms.

Start plan, then add APICreate API keyMCP guide

Same posterly access layer as Claude, ChatGPT, Cursor, OpenClaw, and custom automations.

Get Hermes connected in three steps

Start with an API key, then choose MCP, REST, or skill-driven workflows.

1

Enable API & MCP access

Open Dashboard → API & MCP, activate the $3/month add-on, then create a posterly API key.

Open API dashboard
2

Choose your connection

Use npm MCP for local Hermes, HTTP MCP for web agents, REST for scripts, or the SKILL.md file for reusable agent behaviour.

Compare MCP options
3

Ask Hermes to schedule

Once connected, Hermes can list accounts, find available slots, upload media, generate images, and create posts.

Read API reference

Use the actual npm MCP server

For local Hermes, use the same npm package documented on the posterly MCP page. The page should show the real install path, not a vague “posterly MCP” placeholder.

Hermes MCP config

Add posterly as a local stdio MCP server. Replace the key with the one from your posterly API dashboard.

{
  "mcp_servers": {
    "posterly": {
      "command": "npx",
      "args": ["-y", "posterly-mcp-server"],
      "env": {
        "POSTERLY_API_KEY": "pst_live_your_key_here"
      }
    }
  }
}

The npm package is posterly-mcp-server. See the full MCP setup guide for Claude, ChatGPT, Cursor, Windsurf, and HTTP clients.

HTTP MCP option

If your Hermes workflow calls remote MCP over HTTP, skip the local subprocess and call posterly directly.

POST https://www.poster.ly/api/mcp
Authorization: Bearer pst_live_your_key_here
Content-Type: application/json

{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Discovery metadata lives at /.well-known/mcp/server-card.json and auth metadata at /.well-known/oauth-protected-resource.

The OpenClaw skill also works as a Hermes skill

A skill is just a Markdown instruction file. The OpenClaw page shows the pattern, but the same SKILL.md approach can teach Hermes when to use posterly MCP, when to fall back to REST, and what safety checks to apply before publishing.

Minimal reusable SKILL.md

Put this in a Hermes skill, or adapt the public posterly agent skill from GitHub.

Show SKILL.md example
---
name: posterly-social-manager
description: Schedule and manage social posts through posterly. Prefer MCP when available, fall back to REST with the same POSTERLY_API_KEY.
---

# posterly social manager

Use posterly to create, schedule, inspect, and analyse social posts.

Connection order:
1. Prefer the posterly MCP server when available.
2. Use REST API endpoints when MCP is not available.
3. Never publish immediately without showing the user the account, caption, media, and schedule first.

Auth:
- Environment variable: POSTERLY_API_KEY
- Base URL: https://www.poster.ly
- MCP npm package: posterly-mcp-server

Core actions:
- list accounts and brands
- find available slots
- upload media
- create, update, delete, and inspect posts
- get account and post analytics

Install or adapt the skill

Use the public skill repo as the source of truth, then load it in Hermes for social workflows.

hermes skills install https://github.com/awpthorp/posterly-agent
View the OpenClaw skill page

Good agent behaviour

  • Confirm account, caption, media, and schedule before public posting.
  • Prefer MCP tools when available because schemas reduce mistakes.
  • Use REST fallback for scripts, cron jobs, and runtimes without MCP.
  • Always run whoami first so posts land in the right workspace.

What Hermes can do once connected

The MCP server exposes the same core tools as the API add-on, with structured schemas for safer agent use.

Common tools

whoamilist_accountslist_brandsget_brand_profilecreate_postlist_postsfind_available_slotupload_mediagenerate_imageget_account_analyticsget_post_analytics
See all MCP tools

Example Hermes prompts

  • “List my posterly accounts and tell me which LinkedIn accounts are connected.”
  • “Find the next free slot for @awpthorp, then draft a LinkedIn post for tomorrow morning.”
  • “Upload this image, write three caption options, and ask me before scheduling.”
  • “Show my last 30 days of LinkedIn analytics and recommend what to post next.”

Post to 11 platforms

Hermes can schedule through posterly to every supported social platform.

InstagramTikTokLinkedInYouTubeX (Twitter)FacebookThreadsPinterestGoogle Business ProfileBlueskyTelegram

Related setup guides

Use these pages together. Hermes is one route into the same API, MCP, and skill layer.

MCP setup guide

The canonical MCP page with client setup, HTTP transport, OAuth metadata, and tool list.

OpenClaw skill

The OpenClaw page includes the reusable SKILL.md pattern. It is Markdown, not OpenClaw-only magic.

API dashboard

Activate the add-on, generate keys, and copy setup snippets from inside posterly.

REST API reference

Use direct HTTP calls from Hermes scripts, cron jobs, or custom automations.

Pricing

API & agent access is an add-on to any posterly plan.

API, MCP & Agent Access

$3/month

Add-on to any posterly plan (from $7/mo)

  • Hermes + npm MCP + HTTP MCP + REST API
  • Reusable Markdown skill workflows
  • 16 tools for scheduling, media, brands, and analytics
  • 30 requests per hour across all endpoints
  • All 11 supported platforms
Start plan, then add API

Hermes questions

Do I need the npm package for MCP?+

For local stdio MCP, yes. Use npx -y posterly-mcp-server with POSTERLY_API_KEY in the server environment. For HTTP MCP, call https://www.poster.ly/api/mcp directly instead.

Is the OpenClaw skill only for OpenClaw?+

No. The useful part is the SKILL.md file. Hermes can use the same Markdown instructions to know when to prefer MCP, when to use REST, and what safety checks to run before posting.

Which connection should I use?+

Use npm MCP when Hermes can run local subprocess MCP servers. Use HTTP MCP for remote tool calls. Use REST for scripts and explicit automations. Use a skill when you want repeatable agent behaviour.

What can Hermes schedule?+

All 11 posterly platforms: Instagram, TikTok, LinkedIn, YouTube, X, Facebook, Threads, Pinterest, Google Business Profile, Bluesky, and Telegram.

Ready to connect Hermes?

Start posterly, activate API access, create a key, then connect Hermes with npm MCP, HTTP MCP, REST, or a skill.

Start plan, then add APIRead MCP guide