Skip to main content
Connect Postzee to Hermes Agent by Nous Research to generate AI images/videos, create HeyGen avatar videos, and publish to 30+ social media platforms — all through natural language conversation on Telegram.

Step 1: Get your MCP URL

  1. Go to Postzee SettingsAPI Pública tab
  2. Copy the MCP URL (HTTP Streamable) from the “MCP (Model Context Protocol)” section
The URL looks like https://api.postzee.app/mcp/YOUR_API_KEY/http.

Step 2: Configure the MCP server

Add the Postzee MCP server to your Hermes config file (~/.hermes/config.yaml):
Replace YOUR_API_KEY with the key from your MCP URL. After saving, reload the MCP servers:
This registers all 20 Postzee tools (image generation, video generation, HeyGen avatars, posting, etc.) as mcp_postzee_* tools in your agent.

Step 3: Install the Postzee Skill

The skill teaches your agent how to use Postzee tools effectively — model recommendations, platform-aware aspect ratios, workflows, and best practices.
The MCP server provides the tools (what the agent can do). The skill provides the knowledge (how to use them well). Both are recommended for the best experience.

Verify the connection

Tell your agent:
Hermes should call the POSTZEE_LIST_CHANNELS tool and show your connected accounts.

Usage examples

Once connected, use natural language:

Generate an image

“Generate a professional headshot in a modern office”

Transform a photo

“Transform this photo into anime style” (provide an image URL)

Animate a photo into video

“Animate this photo into a cinematic video for Instagram Reels”

Create a HeyGen avatar video

“Create a HeyGen video of an avatar presenting our new product”

Generate and post

“Generate a sunset beach photo and post it to my Instagram”

Check your credits

“How many AI credits do I have left?”
  1. Check credits — verify you have enough credits
  2. Enhance prompt — use the prompt optimizer for better results (free)
  3. Generate — create the image or video
  4. Post — publish or schedule to your channels

Tools Reference

Complete reference for all 20 MCP tools.

Claude Code

Connect Postzee to Claude Code instead.