AgentsCodex MCP

Generate images, PDFs and videos in Codex.

Add Orshot to Codex to render images, PDFs and videos from your templates, publish straight to social, and post at the best time to grow engagement.

Connect with Codex

30 free credits · no credit card · hosted MCP, no local install

What Orshot for Agents can do for you:

  • Generate on-brand templates
  • Render carousels, videos from your data
  • Manage your brand assets
  • Plug API, Automation Workflows
  • Post, draft, schedule social content
  • Analyze your social metrics
  • Tell your best time to post
  • See what gets engagement, what doesn't
  • Get every number you need to grow
Install the plugin quickly
Install in Codex
Codex CLI
codex mcp add orshot --url https://mcp.orshot.com/mcp
Setup
  1. 1Or install the Orshot app: run /plugins in Codex to open the plugin browser.
  2. 2Search for Orshot, open it, and select Install plugin.
  3. 3Start a new chat, then ask Codex to render from your templates.

The CLI command adds Orshot to ~/.codex/config.json. Authenticate over OAuth or pass an Orshot API key as a bearer token.

Full docs
Right in your workflow

One prompt, assets in your build.

Codex calls the Orshot tools inline, renders from your templates, and hands back URLs you can drop straight into your code, CI or CDN.

  • Publish to social from the same call, no extra API
  • Render an OG image and reference it in your meta tags
  • Batch-render assets from a CSV or database, one per row
  • Pipe every render straight into your own S3 or CDN
See all agent capabilities

Render this week's quote graphic from my template and post it to LinkedIn.

Rendered and posted to LinkedIn · Codex replies with the links
Interactive previews

Every render comes back ready to ship.

In Codex, renders come back as links you can open. In the Claude and ChatGPT apps, the same results come back as interactive cards you can flip through.

  • Every render comes back as a link Codex can open
  • The same Orshot tools, whatever your MCP client
  • Interactive cards in the Claude and ChatGPT desktop and web apps
Bali travel poster variant
Kyoto travel poster variant
New York travel poster variant
1 / 3
Launch poster · 3 variantsRendered from your template + data
Create

On-brand carousels, documents and reels, from a prompt.

Describe the piece and Codex builds it from your templates: a LinkedIn carousel, a one-page document, a reel cover, already in your fonts and colors.

“List my studio templates and tell me which ones have a video layer.”

“Add a discount-badge parameter to my sale-banner template.”

Agent session
Completed
You

“Design a square invite series for the winter events: gala night, supper club and the gilded hour, one look across all three.”

Agent
orshot_create_template_design
Gala night invite
Supper club invite
Gilded hour invite
1 / 3
Template #4821 · Invite seriesBrand fonts + colors from Acme's kit
Render

Render images, video and PDFs from your data source.

Point Codex at a Google Sheet, an Airtable or a list of rows and it renders one asset per record from a template you designed once: product shots, certificates, thumbnails, the lot.

“Make an Instagram carousel from the promo template with these three headlines.”

“Turn my product template into a short MP4 with the hero video swapped in.”

Agent session
Completed
You

“Render a cover for every session in rows A1–A500: title, speaker and date.”

Agent
orshot_generate_image × 500
Content marketing session cover
Ads webinar session cover
Morning retreat session cover
1 / 3
500 covers in 1m 52sSigned URLs · avg 220 ms per render
Publish

Post to 15+ social platforms, via Codex and API.

Codex posts to the accounts you have connected, holds a draft for you to read first, or schedules a whole week for the times and timezone you name. Every one of those actions is an API call too.

“Render the announcement and save it as a draft to all my connected accounts.”

“Render the certificate and email me a signed URL to download it.”

Agent session
Completed
You

“Render the customer quote from today's call and publish it to our Instagram and LinkedIn.”

Agent
orshot_list_social_accounts
orshot_generate_image
orshot_publish_social_post
Customer quote postinstagram+412reachlinkedin+38%engagement
Live
Posted to Instagram + LinkedInLive now · caption and first comment set
Automate

Automate the loop, or drop the API into your codebase.

Have Codex wire up an Orshot Workflow that keeps running after the chat: a trigger, a data source, your template and a destination. Or skip Codex and call the REST API straight from your own app.

“Run my weekly-report workflow and show me the last run's outputs.”

“Schedule a workflow to generate a daily quote graphic from a Google Sheet.”

Agent session
Completed
You

“Set up a workflow: for every new session row, render the episode cover and post it to our Slack.”

Agent
orshot_list_workflow_nodes
orshot_create_workflow
orshot_run_workflow
New session row
Render episode cover
Post to Slack
Live · runs on new rows
Episode covers → SlackTest run passed · runs on new rows
Security and data handling

Scoped by OAuth, nothing else touched.

OAuth 2.0, standards-compliant

Authorization code with PKCE and dynamic client registration, per the MCP Authorization spec. Tokens stay in your MCP client; the server does not store them.

Scoped to your workspace

Each connection accesses only the Orshot workspaces of the account that authorized it. Disconnect from your client at any time to end access.

Tool calls only

The server receives tool calls and their inputs, nothing else. It never reads your conversation, files or memory, and it only talks to Orshot's own API.

Annotated, permission-aware tools

Every tool declares read-only or write behavior, and destructive actions like delete and publish are marked so your client asks before running them.

Full details in the MCP server reference, the help center, the privacy policy and the terms of service. Questions from your security team? Write to hi@orshot.com.

More setup guides

Wire Orshot into your other tools.

CursorVS CodeAntigravityWarpZedOpenCodeHermesClaudeChatGPTLovableReplitGrok BotBrowser Agents
FAQ

Using Orshot with Codex

Where does the Codex CLI store the Orshot config?

Running `codex mcp add orshot --url …` writes it to ~/.codex/config.json. You can also edit that file directly.

Can I use Orshot with Codex headlessly?

Yes. Authenticate over OAuth interactively, or pass an Orshot workspace API key as a bearer token for CI and scripts.

Does the Orshot MCP work in both the Codex CLI and IDE extension?

Yes. Both connect to the same hosted server. The CLI stores the config in ~/.codex/config.json.

Can Codex render more than images?

Yes. Ask for PDFs and MP4 or GIF video from the same templates, not just PNGs.

What can Codex do with Orshot once connected?

You can ask Codex 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 30 free credits 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 Codex post to my social accounts?

Yes, once you connect that account in your Orshot dashboard. After it is connected, Codex can draft, schedule or publish to it. Rendering and everything else works without connecting any social account.

Give Codex your templates. 30 free credits to try.

No credit card. Connect the hosted MCP server, then let Codex render images, PDFs and video from your Orshot templates.

Start buildingAgent skills overview