Connect PostNitro to Claude — create carousels right inside your chats! 🎉
PostNitro MCP Server — Create, Manage & Schedule Social Posts from Your AI Assistant
Generate carousels and single-image posts for LinkedIn, Instagram, TikTok, and Threads, add AI-generated images, manage brand kits and connected social accounts, and schedule posts — all without leaving your AI assistant. PostNitro's MCP Server connects Claude (Desktop, Code, and Cowork), Cursor, ChatGPT, and any MCP-compatible client directly to PostNitro's content engine. Just describe what you want, and your assistant handles template selection, AI content generation, slide design, scheduling, and file delivery.
No browser. No manual design. Just conversation → carousels, scheduled and published.
https://mcp.postnitro.ai/mcpMCP Tools
28 tools
Platforms
LinkedIn, Instagram, TikTok, Threads
Output
PNG, PDF, or editable design
Scheduling
Create, edit & auto-publish
What Is MCP?
The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and services. Think of it as a USB port for AI — instead of copying and pasting between your assistant and other tools, MCP lets the assistant call tools directly and work with the results.
PostNitro's MCP Server exposes 28 tools that give your assistant full access to carousel and image post creation, AI image generation, template browsing, brand and social account management, and post scheduling. Your assistant reads the tool descriptions, understands what's available, and uses them automatically when you ask for a post.
Learn more about MCPCompatible Clients
Claude Code
Native support — drop-in config
Claude Desktop
Native HTTP support
Claude Cowork
Native support — same config
Cursor IDE
Native MCP support
ChatGPT
Via MCP plugin
Any MCP Client
Standard HTTP transport
What Can Your Assistant Do With PostNitro?
Generate Carousels with AI
Say "Create a LinkedIn carousel about 5 productivity tips" and your assistant calls PostNitro's AI to write content, design slides, and return ready-to-publish files. Works from free-text topics, article URLs, or X/Twitter posts.
Create Single-Image Posts
Not everything needs slides. The image tools are the single-image equivalents of the carousel tools — same AI generation and import options, one designed image out. Perfect for announcements and quote graphics.
Import Custom Content
Already have your slide content? Tell your assistant the headings, descriptions, and images — including infographic layouts with data columns — and PostNitro renders them into a professionally designed post using your templates and brand kit.
Add AI-Generated Images
Ask for images and your assistant passes a visual brief to generateImages — AI images are created and baked into the design before rendering, as backgrounds or in-line, on strategic slides or all of them.
Browse Templates, Brands & Presets
Ask "Show me my available templates" or "List my brands" and your assistant fetches your PostNitro library — template names, dimensions, brand colors, and AI preset configurations — without you opening a browser.
Set-and-Forget Defaults
Configure your preferred template, brand, AI preset, and output format once. Every future request uses those defaults automatically, and if your workspace has only one candidate for a missing ID, the server picks it for you.
Manage Brand Kits & Social Accounts
Create and update brand kits, and list your connected LinkedIn, Instagram, TikTok, and Threads accounts — all from a conversation, with the IDs you need ready for scheduling.
Schedule & Publish Posts
Ask your assistant to schedule a finished post to your connected accounts, set captions per platform, or list what's already on the calendar for a given date range.
One-Step Convenience
Don't want to manage async polling? The _and_wait tools handle the entire creation flow in a single call, and generate_and_schedule takes it all the way from topic to scheduled post.
Multiple Output Formats
Get individual PNG slide images for social posting, a single PDF for LinkedIn document uploads, or a render-free editable design when you only need to schedule. Your assistant delivers links you can open immediately.
Quick Setup
Setup takes about 2 minutes. Get your PostNitro API key, add one config block to your client, and you're ready.
Step 1: Get Your API Key
Log in to postnitro.ai → click the profile icon (top right) → select Embed → Add your domains under Add Whitelist Domains → click Generate API Key → copy your key (starts with pn-).
Step 2: Configure Your Client
Step 3: Set Your Defaults
Once connected, ask your assistant to list your templates, brands, and AI presets. Pick your favorites, then ask it to set your defaults with postnitro_set_defaults. Done — every future carousel request uses these automatically.
Step 4: Create — and Schedule
Ask your assistant: "Create a LinkedIn carousel about 5 remote work tips and schedule it for tomorrow at 9am." One prompt takes you from idea to a post booked on LinkedIn, Instagram, TikTok, or Threads — postnitro_generate_and_schedule handles generation, rendering, and scheduling in a single call.
Saved Defaults
Rather than passing a template, brand, or AI preset ID on every call, save them once with postnitro_set_defaults. They persist across sessions and are applied automatically whenever a generate or import call omits them.
Auto-selection
If a required ID is missing and your workspace has exactly one candidate — a single AI preset, say — the server selects it automatically. If several exist, the error lists the candidate IDs so your assistant can choose without a separate lookup.
Don't Just Create Posts — Schedule Them Too
Designing the post is only half the job, so PostNitro now finishes it: schedule posts or save drafts directly to LinkedIn, Instagram, TikTok, and Threads, with per-platform captions and settings. Generate or import a design, attach it to a time slot, and PostNitro publishes it for you — from the API, the MCP server, or the CLI, with no separate scheduling tool.
The Typical Agent Workflow
Four steps from a cold start to a scheduled post — and your assistant runs all of them for you.
1
Discover
Your assistant lists your templates, brands, and AI presets to find valid IDs — or saves defaults once so it never has to ask again.
2
Create
One _and_wait call generates or imports the post and handles all the polling — carousel or single image, AI-written or your own content.
3
Use the output
Back come PNG URLs or a PDF, plus the designId and an editor deep link — ready to download, hand off, or keep editing in PostNitro.
4
Schedule
Attach the designId to a scheduled post with per-platform captions — or compress the whole journey into one generate_and_schedule call.
For long-running generations or custom polling, the non-waiting tools plus postnitro_check_status and postnitro_get_output give your agent full control of the loop.
All 28 MCP Tools
Configuration
| Tool | Description |
|---|---|
postnitro_set_defaults | Save default template, brand, AI preset, and output format so you don't repeat them on every call. |
postnitro_get_defaults | Retrieve your saved defaults. |
Discovery
| Tool | Description |
|---|---|
postnitro_list_templates | Browse your design templates with IDs, dimensions, and aspect ratios. |
postnitro_list_brands | List your brand configurations. |
postnitro_list_ai_presets | List your AI presets (platform, tone, audience, language, slide count). |
postnitro_get_import_template | Get the exact slide structure and rules for importing content. |
Creation — Carousels
| Tool | Description |
|---|---|
postnitro_generate_carousel | Generate a carousel with AI from a topic/text, article URL, or X (Twitter) post URL. |
postnitro_import_carousel | Create a carousel from your own slide content (array of typed slides). |
postnitro_generate_and_wait | AI-generate a carousel, poll until complete, and return the output in a single call. |
postnitro_import_and_wait | Import a carousel, poll until complete, and return the output in a single call. |
Creation — Image Posts
| Tool | Description |
|---|---|
postnitro_generate_image | AI-generate a single-image post from a topic/text, article URL, or X (Twitter) post URL. |
postnitro_import_image | Create a single-image post from your own content — one slide object, infographic layout supported. |
postnitro_generate_image_and_wait | AI-generate an image post, poll until complete, and return the output in a single call. |
postnitro_import_image_and_wait | Import an image post, poll until complete, and return the output in a single call. |
Status & Output
| Tool | Description |
|---|---|
postnitro_check_status | Check generation status (PENDING, PROCESSING, COMPLETED, FAILED) and processing logs. |
postnitro_get_output | Retrieve the generated PNG image URLs or PDF document URL, plus the designId to use when scheduling. |
Brands
| Tool | Description |
|---|---|
postnitro_create_brand | Create a brand kit (name, handle, logo, display flags). |
postnitro_get_brand | Fetch one brand kit. |
postnitro_update_brand | Update a brand kit's name, handle, image, or display flags. |
Social Accounts
| Tool | Description |
|---|---|
postnitro_list_social_accounts | List connected LinkedIn, Instagram, TikTok, and Threads accounts — returns the IDs used in selectedAccounts when scheduling. |
postnitro_get_social_account | Fetch one account with scheduled-post usage by status and token expiry. |
postnitro_disconnect_social_account | Disconnect an account and remove it from every scheduled post it was attached to (destructive). |
Scheduling
| Tool | Description |
|---|---|
postnitro_list_scheduled_posts | List scheduled posts and drafts in a date range. |
postnitro_create_scheduled_post | Create a scheduled post or draft. |
postnitro_get_scheduled_post | Fetch one scheduled post. |
postnitro_update_scheduled_post | Update a scheduled post — this replaces captions and selected accounts, so send the full intended state. |
postnitro_delete_scheduled_post | Delete a scheduled post or draft (destructive). |
Combined Helper
| Tool | Description |
|---|---|
postnitro_generate_and_schedule | Generate a carousel or single-image post with AI, wait for completion, and schedule it — all in one call. If scheduling fails after generation, it returns the designId so you can retry without regenerating (or re-spending credits). |
Carousel Identifiers: embedPostId vs designId
Generation produces two distinct IDs. embedPostId identifies the generation job and is used by postnitro_check_status and postnitro_get_output. designId identifies the durable design artifact and is what scheduling expects — passing an embedPostId where a designId is expected fails with a "Design not found" error. Every tool that returns a completed carousel surfaces a top-level designId to bridge generation into scheduling.
| Identifier | Represents | Used By |
|---|---|---|
embedPostId | The generation job | postnitro_check_status, postnitro_get_output |
designId | The durable design artifact | Scheduling (designId field) |
One convention worth knowing: when a design's output is PDF and the post targets LinkedIn, the correct postType is document (with a 5–90 character postTitle) rather than carousel. postnitro_generate_and_schedule applies this automatically; the other schedule tools pass your choice through as-is.
Example Prompts
Once configured, these are real prompts you can send to your AI assistant:
Creating carousels:
“Create a LinkedIn carousel about 5 tips for remote work”
“Generate a carousel from this article: https://example.com/blog-post”
“Make a single image post announcing our new feature, with an AI-generated background”
“Turn this tweet into a carousel: https://x.com/user/status/123”
Managing configuration:
“Show me my available templates”
“List my brands”
“Set my default template to [id] and brand to [id]”
“What are my current defaults?”
Importing content:
“Import these 5 slides as a carousel with my default template”
Your assistant handles the API calls, async polling, and file delivery behind the scenes. You just describe what you want.
Scheduling & social accounts:
“Schedule this carousel to post on LinkedIn tomorrow at 9am”
“What do I have scheduled for next week?”
“List my connected social accounts”
Three Ways to Generate
From a Topic or Text
Describe what you want and the AI writes content, structures the slide flow, and designs everything.
From an Article URL
Paste a blog post link. The AI extracts the key points and converts them into a concise, swipeable carousel.
From an X Post or Thread
Repurpose a viral tweet or thread into a visual carousel for LinkedIn or Instagram.
Import Custom Slides
For full control, provide your own content. Your assistant sends it to PostNitro and returns designed slides using your template and brand kit.
Slide Rules
Every carousel needs exactly 1 starting_slide, at least 1 body_slide, and exactly 1 ending_slide. Heading is required on every slide.
Infographic Layouts
Body slides support images, background images, and infographic layouts (grid + cycle). Use postnitro_get_import_template to get the full slide structure reference.
Carousels and Image Posts — Same Flow, Two Shapes
Both post types share the same lifecycle (initiate → poll → output), the same identifiers, and the same output shape. They differ only in the content you pass: carousels take an array of typed slides, image posts take a single slide object.
| Carousel | Image post | |
|---|---|---|
| Post type | CAROUSEL — multi-slide | IMAGE — single slide |
| Your own content | slides — an array: one starting_slide, ≥1 body_slide, one ending_slide | slide — a single object, no slide type |
| AI content | Produces multiple slides | Produces one image |
| Infographic layout | Per slide in the array | On the single slide object |
AI Image Generation, Built In
All creation tools accept an optional generateImages object. When present, the server generates AI images and bakes them into the design before rendering — so the files you get back already have the artwork in place.
context (required) — a short visual brief that guides the image prompts
imagePlacement — auto (AI decides per slide), background, or in-line
imageStrategy — strategic (about half the slides) or all
Best-effort: the post still completes if image generation fails or isn't permitted (e.g. the organization is over its AI-image quota). AI images draw on a separate organization image quota — they don't change a post's slide-based credit cost.
Connect Your AI Assistant to PostNitro
Create carousels and image posts, add AI images, and schedule everything — without leaving Claude, Cursor, or ChatGPT. Set up in 2 minutes with your PostNitro API key.
Get Your API KeyCredits & Pricing
| Plan | Price | Credits/Month | Typical Usage |
|---|---|---|---|
| Monthly | $10/mo | 250 credits | Regular content creation and scheduling |
| Higher tiers | See plans page | More credits | Teams, agencies, and high-volume automation |
| Operation | Credits per Slide |
|---|---|
| Content Import | 1 credit per slide |
| AI Generation | 2 credits per slide |
A typical 6-slide AI carousel costs 12 credits. A 6-slide imported carousel costs 6 credits. AI-generated images draw on a separate organization image quota and don't change a post's credit cost.
API access requires a paid plan — there is no free tier. See the plans page for current tiers.
Get Your API KeyTechnical Specs
| Spec | Detail |
|---|---|
| Protocol | Model Context Protocol (MCP) — Streamable HTTP |
| Endpoint |
|
| Health Check |
|
| Authentication | Authorization: Bearer api-key header |
| Server Mode | Stateless — one MCP instance per request, keyed by API key |
| Defaults Storage | Per-API-key JSON files, hashed with SHA-256 |
| Output Formats | PNG (array of slide image URLs), PDF (single document URL), or DESIGN (editable design, no render) |
| Supported Platforms | LinkedIn, Instagram, TikTok, Threads (create from X/Twitter posts too) |
| Version | 1.0.0 |
| License | MIT |
PostNitro MCP vs CLI vs Embed API vs Embed SDK
MCP Server | CLI | Embed API | Embed SDK | |
|---|---|---|---|---|
| Best for | AI assistants and agents creating and scheduling posts conversationally | Terminal workflows, shell scripts, CI, and agents that shell out | Programmatic automation — Zapier, Make, n8n, cron jobs, custom backends | Letting your users visually create and edit carousels inside your web app |
| Interface | Natural language via MCP-compatible client | Commands with flags — JSON in, JSON out | REST API (HTTP requests) | Embeddable editor component in your app |
| Setup | One config block or CLI command | npm install -g @postnitro/cli | API key + HTTP client | npm package + API key |
| Surface | 28 MCP tools (create, brands, social accounts, scheduling) | Full command set incl. one-shot generate-and-schedule | REST endpoints covering the same surface | Visual editor components |
| Saved defaults | Yes — persist across sessions | Yes — defaults set | No — pass IDs every request | N/A — your users pick visually |
| Scheduling & social accounts | Yes — full CRUD via tools | Yes — full CRUD via commands | Yes — via the Schedule API | No — design only |
| Same API credits | Yes | Yes | Yes | Yes |
Use the MCP Server if you work in Claude, Cursor, or another MCP client. Use the CLI in terminals, scripts, and CI. Use the Embed API for custom integrations and automation pipelines. Use the Embed SDK when your own users should design carousels inside your product.
Frequently Asked Questions
Connect Your AI Assistant to PostNitro
Create carousels and image posts, add AI images, and schedule everything — without leaving Claude, Cursor, or ChatGPT. Set up in 2 minutes with your PostNitro API key.
Get Your API Key