# OpenCode MCP Server for Image, PDF and Video Generation

> Connect OpenCode 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 OpenCode guide](https://orshot.com/agents/opencode) | [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 OpenCode, 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 OpenCode

- OpenCode CLI: `opencode mcp add orshot --url https://mcp.orshot.com/full`

Config file `opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orshot": {
      "type": "remote",
      "url": "https://mcp.orshot.com/full",
      "enabled": true
    }
  }
}
```

No client ID to paste. OpenCode sees the 401, registers itself over dynamic client registration and opens your browser. Re-authenticate any time with `opencode mcp auth orshot`.

## Try this first

> Render an OG image from the Orshot blog template for this post and wire the URL into the frontmatter.

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

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. OpenCode 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. OpenCode does each step with Orshot, from a single sentence.

- **Connect accounts in a minute:** No account yet? OpenCode 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 OpenCode 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 OpenCode 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

- "Turn my product template into a short MP4 with the hero video swapped in."
- "Render the launch template as a 1080×1920 story and a 1200×630 OG image."

### Create & edit templates

- "Add a discount-badge parameter to my sale-banner template."
- "Create an Instagram post template with a headline, subtitle and product image."

### Automate with workflows

- "Set up a workflow that renders a fresh OG image whenever I add a blog row in Airtable."
- "Run my weekly-report workflow and show me the last run's outputs."

### Publish & deliver

- "Render this post and publish it to Instagram and LinkedIn."
- "Render the announcement and save it as a draft to all my connected accounts."

## FAQ

### Do I need an API key to use Orshot in OpenCode?

No. OpenCode detects that the Orshot server requires auth, registers itself over dynamic client registration and opens your browser to authorize. If you'd rather use a key, set oauth to false and pass an Orshot workspace API key in the Authorization header.

### Where does OpenCode store the Orshot config?

Under the mcp block of your opencode.json, either at the project root or in your global config. Tokens are stored separately in ~/.local/share/opencode/mcp-auth.json.

### Can I enable Orshot for only one OpenCode agent?

Yes. Disable it globally with an "orshot*": false entry under tools, then re-enable it under that agent's own tools block. Useful for keeping the tool surface small on agents that never touch visuals.

### How do I debug a failed Orshot connection in OpenCode?

Run `opencode mcp debug orshot`. It reports auth status, tests HTTP connectivity and walks the OAuth discovery flow, which is usually enough to spot the problem.

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

You can ask OpenCode 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 OpenCode post to my social accounts?

Yes. Connect the account from the sign-in link OpenCode gives you, or from your Orshot dashboard. OpenCode 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)
- [OpenCode MCP docs](https://opencode.ai/docs/mcp-servers/)
- [Pricing](https://orshot.com/pricing.md)
- [All pages for agents](https://orshot.com/llms.txt)
