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 24 tools that give your assistant full access to carousel creation, 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 carousel or a scheduled post.

Learn more about MCP

Compatible Clients

Claude Code

Native support — drop-in config

Claude Desktop

Native HTTP support

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 PNG or PDF files. Works from free-text topics, article URLs, or X/Twitter posts.

Import Custom Content

Already have your slide content? Tell your assistant the headings, descriptions, and images, and PostNitro renders them into a professionally designed carousel using your templates and brand kit.

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 carousel 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? generate_and_wait and import_and_wait 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 media posting, or a single PDF document for LinkedIn carousel uploads. Your assistant delivers download 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

claude mcp add --transport http postnitro https://mcp.postnitro.ai/mcp \
  --header "Authorization: Bearer pn-your-api-key-here"

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.

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.

All 24 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

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.
`postnitro_generate_and_wait`	Generate, poll until complete, and return the output in a single call.
`postnitro_import_and_wait`	Import, 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 with AI, wait for completion, and schedule it — in one call.

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”

“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.

"Create a 7-slide carousel about AI trends in 2026. Professional tone, actionable advice."

From an Article URL

Paste a blog post link. The AI extracts the key points and converts them into a concise, swipeable carousel.

"Turn this article into a carousel: https://yourblog.com/content-strategy-2026"

From an X Post or Thread

Repurpose a viral tweet or thread into a visual carousel for LinkedIn or Instagram.

"Convert this X thread into LinkedIn slides: https://x.com/username/status/1234567890"

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.

{
  "slides": [
    {
      "type": "starting_slide",
      "heading": "How to Build a Content Strategy",
      "description": "Everything you need to know.",
      "cta_button": "Swipe to learn more"
    },
    {
      "type": "body_slide",
      "heading": "Step 1: Define Your Audience",
      "description": "Create detailed personas covering demographics and pain points."
    },
    {
      "type": "body_slide",
      "heading": "Step 2: Choose Your Platforms",
      "description": "Go where your audience already is. Focus on 2-3 platforms."
    },
    {
      "type": "ending_slide",
      "heading": "Ready to Get Started?",
      "cta_button": "Follow for More"
    }
  ]
}

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.

Credits & Pricing

Plan	Price	Credits/Month	Typical Usage
Free	$0	5 credits	2–3 AI carousels for testing
Paid	From $10/mo	250+ (scalable)	Regular content creation

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.

No credit card required for the free plan.

Get Your API Key — Free

Technical Specs

Spec	Detail
Protocol	Model Context Protocol (MCP) — Streamable HTTP
Endpoint	`https://mcp.postnitro.ai/mcp`
Health Check	`GET https://mcp.postnitro.ai/health`
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) or PDF (single document URL)
Supported Platforms	LinkedIn, Instagram, TikTok, X (Twitter), Threads
Version	1.0.0
License	MIT

PostNitro MCP vs Embed API vs Embed SDK

	MCP Server	Embed API	Embed SDK
Best for	AI assistants and agents creating and scheduling carousels conversationally	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	REST API (HTTP requests)	Embeddable editor component in your app
Setup	One config block or CLI command	API key + HTTP client	npm package + API key
Tools/endpoints available	24 MCP tools (create, brands, social accounts, scheduling)	REST endpoints covering the same surface	Visual editor components
Template/brand browsing	Yes — built-in discovery tools	Manual (via dashboard or API calls)	Built into the visual editor
Default configuration	Yes — persists across sessions	No — pass IDs every request	N/A — your users pick visually
Scheduling & social accounts	Yes — full CRUD via tools	Yes — via the Schedule API	No — design only
Self-hostable	Yes (Docker)	N/A (hosted API)	N/A (npm package)
Same API credits	Yes	Yes	Yes

Use the MCP Server if you work in Claude, Cursor, or another MCP client. Use the Embed API if you're building a custom integration or automation pipeline. Use the Embed SDK if you want your own users to design carousels inside your product.

Frequently Asked Questions

What is the PostNitro MCP Server?

What AI assistants are supported?

Is the MCP Server free?

How do I get an API key?

What's the difference between MCP and the Embed API?

Can I browse my templates and brands from the assistant?

Do my defaults persist?

Can I self-host the MCP Server?

What output formats are supported?

Can I use infographic layouts via MCP?

Can I schedule posts and manage social accounts via MCP?

What's the difference between embedPostId and designId?

Related Resources

Embed API Documentation OpenClaw Skill AI Carousel Generator LinkedIn Carousel Generator Instagram Carousel Generator Pricing & Plans

PostNitro MCP Server — Create, Manage & Schedule Carousels from Your AI Assistant

Generate professional carousel posts for LinkedIn, Instagram, TikTok, and X, manage brand kits and connected social accounts, and schedule posts — all without leaving your AI assistant. PostNitro's MCP Server connects Claude, Cursor, ChatGPT, and any MCP-compatible client directly to PostNitro's carousel engine. Just describe what you want in natural language, 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.

Endpoint: https://mcp.postnitro.ai/mcp

MCP Tools

24 tools

Platforms

LinkedIn, Instagram, TikTok, X, Threads

Output

PNG images, PDF documents

Scheduling

Create, edit & auto-publish

Read the API Docs Get API Key

What Is MCP?

Learn more about MCP

Compatible Clients

Claude Code

Native support — drop-in config

Claude Desktop

Native HTTP support

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

Import Custom Content

Already have your slide content? Tell your assistant the headings, descriptions, and images, and PostNitro renders them into a professionally designed carousel using your templates and brand kit.

Browse Templates, Brands & Presets

Set-and-Forget Defaults

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 carousel to your connected accounts, set captions per platform, or list what's already on the calendar for a given date range.

One-Step Convenience

Multiple Output Formats

Get individual PNG slide images for social media posting, or a single PDF document for LinkedIn carousel uploads. Your assistant delivers download 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

claude mcp add --transport http postnitro https://mcp.postnitro.ai/mcp \
  --header "Authorization: Bearer pn-your-api-key-here"

Step 3: Set Your Defaults

Saved Defaults

Auto-selection

All 24 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

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.
`postnitro_generate_and_wait`	Generate, poll until complete, and return the output in a single call.
`postnitro_import_and_wait`	Import, 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 with AI, wait for completion, and schedule it — in one call.

Carousel Identifiers: embedPostId vs designId

Identifier	Represents	Used By
`embedPostId`	The generation job	postnitro_check_status, postnitro_get_output
`designId`	The durable design artifact	Scheduling (designId field)

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”

“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.

"Create a 7-slide carousel about AI trends in 2026. Professional tone, actionable advice."

From an Article URL

Paste a blog post link. The AI extracts the key points and converts them into a concise, swipeable carousel.

"Turn this article into a carousel: https://yourblog.com/content-strategy-2026"

From an X Post or Thread

Repurpose a viral tweet or thread into a visual carousel for LinkedIn or Instagram.

"Convert this X thread into LinkedIn slides: https://x.com/username/status/1234567890"

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.

{
  "slides": [
    {
      "type": "starting_slide",
      "heading": "How to Build a Content Strategy",
      "description": "Everything you need to know.",
      "cta_button": "Swipe to learn more"
    },
    {
      "type": "body_slide",
      "heading": "Step 1: Define Your Audience",
      "description": "Create detailed personas covering demographics and pain points."
    },
    {
      "type": "body_slide",
      "heading": "Step 2: Choose Your Platforms",
      "description": "Go where your audience already is. Focus on 2-3 platforms."
    },
    {
      "type": "ending_slide",
      "heading": "Ready to Get Started?",
      "cta_button": "Follow for More"
    }
  ]
}

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.

Connect Your AI Assistant to PostNitro

Create, manage, and schedule AI-powered carousel posts without leaving Claude, Cursor, or ChatGPT. Set up in 2 minutes, free tier available.

Get Your API Key

Credits & Pricing

Plan	Price	Credits/Month	Typical Usage
Free	$0	5 credits	2–3 AI carousels for testing
Paid	From $10/mo	250+ (scalable)	Regular content creation

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.

No credit card required for the free plan.

Get Your API Key — Free

Technical Specs

Spec	Detail
Protocol	Model Context Protocol (MCP) — Streamable HTTP
Endpoint	`https://mcp.postnitro.ai/mcp`
Health Check	`GET https://mcp.postnitro.ai/health`
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) or PDF (single document URL)
Supported Platforms	LinkedIn, Instagram, TikTok, X (Twitter), Threads
Version	1.0.0
License	MIT

PostNitro MCP vs Embed API vs Embed SDK

	MCP Server	Embed API	Embed SDK
Best for	AI assistants and agents creating and scheduling carousels conversationally	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	REST API (HTTP requests)	Embeddable editor component in your app
Setup	One config block or CLI command	API key + HTTP client	npm package + API key
Tools/endpoints available	24 MCP tools (create, brands, social accounts, scheduling)	REST endpoints covering the same surface	Visual editor components
Template/brand browsing	Yes — built-in discovery tools	Manual (via dashboard or API calls)	Built into the visual editor
Default configuration	Yes — persists across sessions	No — pass IDs every request	N/A — your users pick visually
Scheduling & social accounts	Yes — full CRUD via tools	Yes — via the Schedule API	No — design only
Self-hostable	Yes (Docker)	N/A (hosted API)	N/A (npm package)
Same API credits	Yes	Yes	Yes

Frequently Asked Questions

What is the PostNitro MCP Server?

What AI assistants are supported?

Is the MCP Server free?

How do I get an API key?

What's the difference between MCP and the Embed API?

Can I browse my templates and brands from the assistant?

Do my defaults persist?

Can I self-host the MCP Server?

What output formats are supported?

Can I use infographic layouts via MCP?

Can I schedule posts and manage social accounts via MCP?

What's the difference between embedPostId and designId?

Connect Your AI Assistant to PostNitro

Create, manage, and schedule AI-powered carousel posts without leaving Claude, Cursor, or ChatGPT. Set up in 2 minutes, free tier available.

Get Your API Key

Related Resources

Embed API Documentation OpenClaw Skill AI Carousel Generator LinkedIn Carousel Generator Instagram Carousel Generator Pricing & Plans