# Hermes MCP Server for Image, PDF and Video Generation

> Connect Hermes to Orshot's MCP server and generate images, PDFs and videos from your own templates by asking in plain language, then publish or schedule them to 15 social platforms. Free plan: 100 credits every month.

[Full Hermes guide](https://orshot.com/agents/hermes) | [All agents](https://orshot.com/agents.md) | [Start free](https://orshot.com/signup)

## At a glance

- **MCP server:** `https://mcp.orshot.com/full`, the same URL for every client, with OAuth sign-in and no API key to paste.
- **Tools:** 104 tools for Hermes, discovered on connection and scoped to one Orshot workspace.
- **Speed:** a typical image renders in 0.9s (median over the last day).
- **Time to first render:** Half of new users who render do it within 14 minutes of signing up, and a quarter within 6 minutes.
- **In production:** 49% of customer renders in the last 30 days came from AI agents over MCP.
- **Agents in use:** 94% of workspaces that rendered in the last 30 days used an AI agent at least once.
- **Agent apps:** 17 apps called Orshot in the last 30 days. Share of agent tool calls: Claude 94%, ChatGPT 3%, Codex 2%, other MCP clients 1%.
- **Agent tool calls:** more than 215,000 in the last 30 days.
- **What agent users did** (share of agent users): pulled in brand kits and stock photos 58%, designed templates 52%, rendered images or PDFs 38%, posted or scheduled to social 33%, made AI videos 3%, set up workflows 2%.
- **Agent speed** (median per call): `orshot_render_template` 1.4s, `orshot_create_template_design` 4s.
- **Cost:** no charge for connecting. Renders use your plan's credits ([pricing](https://orshot.com/pricing.md)).

## Connect Hermes

- Hermes CLI: `hermes mcp add orshot --url https://mcp.orshot.com/full --auth oauth`

Config file `~/.hermes/config.yaml`:

```yaml
mcp_servers:
  orshot:
    url: "https://mcp.orshot.com/full"
    auth: oauth
```

auth: oauth is all Hermes needs, and it handles discovery, dynamic client registration, PKCE and token refresh itself. If you edited the YAML by hand, run hermes mcp login orshot from a fresh terminal: an in-session config reload times out after 30 seconds, which is not long enough to finish the browser flow.

## Try this first

> Render this week's quote graphic from my Orshot template and publish it to LinkedIn.

## From template to posted, in one ask to Hermes

Orshot generates images, PDFs and videos from your templates, renders as many as you need through the API, and posts them to 15+ social platforms. Hermes runs the whole loop for you.

1. **Generate from your template:** Carousels, reels, ads and PDFs in your fonts, colors and logo. Never off-brand.
2. **Scale it through the API:** One render or a thousand, from a sheet, a feed or a list, in every size.
3. **Post to 15+ platforms:** Publish now, schedule for later or keep a draft. Every step is an API call too.

## Run your social accounts from the chat

Connect an account, fill the week, post when your audience is online, then see what worked. Hermes does each step with Orshot, from a single sentence.

- **Connect accounts in a minute:** No account yet? Hermes saves the post and hands you a sign-in link. Instagram, TikTok, LinkedIn, YouTube and 11 more.
- **A week of posts from one ask:** Ask for the week and every post lands on the calendar, scheduled for the days and times you name, with drafts held for your review.
- **Post at your best time:** Orshot learns when your audience engages from your own posting history, so scheduled posts go out when people are there.
- **See what worked, make more of it:** Views, engagement and follower growth per post and per account. Ask which post won and render the next one in its style.

Paid plans include social accounts (1 on the $39 plan, 2 on $99, 3 on $160 and up to 10 on $600); more are a paid add-on. Rendering works without any social account ([social publishing](https://orshot.com/features/social-publishing.md)).

### The social tools Hermes gets on connection

- **Connect:** `orshot_connect_social_account` (Connect Social Account), `orshot_list_social_accounts` (List Social Accounts)
- **Post:** `orshot_publish_social_post` (Publish or Draft a Social Post), `orshot_publish_social_draft` (Send a Held Social Post)
- **Schedule and revise:** `orshot_list_social_posts` (List Social Posts), `orshot_update_social_post` (Revise a Held Social Post), `orshot_discard_social_post` (Discard a Held Social Post), `orshot_get_best_time_to_post` (Get Best Time To Post)
- **Measure:** `orshot_get_social_analytics` (Get Social Analytics), `orshot_get_social_post_analytics` (Get Analytics For One Post), `orshot_get_social_followers` (Get Social Follower Stats)

## What Hermes can do with Orshot

### Social media automation

- **Automate social media posts end to end:** social media automation that generates each post from a template, then publishes it or lets you schedule social media posts to Instagram, LinkedIn, X, TikTok and 11 more platforms from the same API call or workflow (social publishing is a paid add-on). ([more](https://orshot.com/features/social-publishing.md))
- **Bulk create social media posts** from a spreadsheet: an Instagram post generator, Instagram carousel generator and LinkedIn carousel generator in one, making one post, carousel or story per row of Google Sheets or Airtable instead of designing each one by hand. ([more](https://orshot.com/integrations/no-code.md))
- **Instagram automation with n8n, Make or Zapier:** auto post to Instagram, automate LinkedIn posts and run n8n social media automation on a schedule, with a fresh image or video rendered for each post. ([more](https://orshot.com/integrations/automation.md))
- **Recurring posts from your data:** real estate social media posts for every new listing, a quote image generator for weekly quote cards, product launches, event announcements and results graphics. ([more](https://orshot.com/templates.md))

### Image generation

- **Image generation API for templates:** an image API where you send the template ID and the values that change (text, photos, colors) and get back a PNG, JPG or WebP. For bulk image generation, render one image per row from a spreadsheet, a workflow, the CLI or an AI agent. ([more](https://orshot.com/solutions/image-generation-api.md))
- **OG image generator** for every blog post, docs page or product: render the Open Graph image automatically from your CMS, including Framer, Webflow and WordPress. ([more](https://orshot.com/integrations/automation.md))
- **Banner generator, YouTube thumbnail generator and ad creatives in every size:** design once and Smart Resize re-lays out the same design for each format, so ad creative automation does not mean redrawing each size. ([more](https://orshot.com/solutions/banner-generation-api.md))
- **Ecommerce product images and personalized images:** promo banners for every product in your Shopify catalog, or a personalized image per contact for email and CRM campaigns. ([more](https://orshot.com/integrations/e-commerce.md))

### PDF generation

- **PDF generation API:** automate PDF generation for invoices, reports, proposals and one-pagers from a template, multi-page. It works as an invoice generator API without maintaining an HTML to PDF API and its print CSS. ([more](https://orshot.com/solutions/pdf-generation-api.md))
- **Bulk certificate generator and Google Sheets to PDF:** one certificate, badge or ticket per attendee row, from Google Sheets or Airtable. ([more](https://orshot.com/integrations/no-code.md))

### Video generation

- **Video generation API and automated video creation:** video automation for listing videos, faceless videos, personalized video and short social clips, rendered from a template with your data as MP4 (up to 30 seconds on the free plan, longer on paid plans). ([more](https://orshot.com/solutions/video-generation-api.md))

## Example prompts

### Generate & render

- "Resize my banner design to every social format in one call."
- "Generate a certificate PDF for every name in my roster CSV."

### Create & edit templates

- "Show me every editable field on the newsletter template."
- "Duplicate my OG template and switch the accent color to my brand blue."

### Automate with workflows

- "Create a workflow that reads today's sale items from a sheet and renders banners each morning."
- "Build a workflow: incoming webhook → render → upload to my S3 bucket."

### Publish & deliver

- "Schedule the carousel to post to TikTok tomorrow at 9am."
- "Generate the graphic and upload it to my Shopify Files."

## FAQ

### Which Hermes config file does Orshot go in?

~/.hermes/config.yaml, under the mcp_servers key. Give it a url and auth: oauth. There is no local process to install.

### Do I need an API key for Orshot in Hermes?

No. Orshot's MCP server supports dynamic client registration, so auth: oauth is enough. Hermes handles discovery, PKCE, token exchange and refresh on its own. You can pass a workspace API key as a bearer header instead if you prefer.

### My Hermes OAuth login keeps timing out, why?

Editing ~/.hermes/config.yaml inside a running session triggers an auto-reload with a 30 second timeout, which is not long enough to finish a browser flow. Add the entry, then run `hermes mcp login orshot` from a fresh terminal, which waits the full five minutes.

### Can Hermes render on a schedule with Orshot?

Yes. Hermes can run tasks on a cron schedule, so it can call Orshot to render a daily or weekly graphic from your template and deliver it without you prompting each time.

### What can Hermes do with Orshot once connected?

You can ask Hermes in plain language to render images, PDFs and video from your Orshot templates, resize one design to every social format, and publish the result to social. No image infrastructure to build.

### Is the Orshot MCP server free to use?

Connecting is free. Renders draw from your Orshot plan, and every account starts with 100 free credits a month and no credit card.

### What data can the Orshot MCP server access?

Only the Orshot workspaces of the account that authorized it, over OAuth 2.0 with PKCE. The server receives tool calls and their inputs, never your conversation or files, and every call goes to Orshot's own API. Disconnect from your client at any time to end access.

### How are risky actions like delete or publish handled?

Every tool declares whether it reads or writes, and destructive actions carry an explicit annotation, so MCP clients ask for confirmation before running them. Read-only tools like listing templates can run without a prompt.

### Can Hermes post to my social accounts?

Yes. Connect the account from the sign-in link Hermes gives you, or from your Orshot dashboard. Hermes can then post now, schedule for the times you name or hold a draft, and read how each post did. Rendering works without any social account.

## Links

- [Orshot for AI agents](https://orshot.com/agents.md)
- [MCP server docs](https://orshot.com/docs/integrations/mcp-server.md)
- [Hermes MCP docs](https://github.com/NousResearch/hermes-agent/blob/main/website/docs/user-guide/features/mcp.md)
- [Pricing](https://orshot.com/pricing.md)
- [All pages for agents](https://orshot.com/llms.txt)
