@postai/mcp

use postai from
any ai agent.

PostAI exposes a full Model Context Protocol server. connect it to Claude Desktop, Cursor, or any MCP-compatible client and schedule posts, generate content, and query analytics — all through natural language.

$npx @postai/mcp
get your API key →npm · @postai/mcp →

available on Pro Plus plan ($99/mo) and above · free for self-hosted

connect to your ai client

works with any MCP-compatible agent — three quick-start configs below

🤖

Claude Desktop

The most powerful setup. Claude reads your calendar, drafts posts, and schedules them using natural language — all inside Claude Desktop.

claude_desktop_config.jsonjson
{
  "mcpServers": {
    "postai": {
      "command": "npx",
      "args": ["@postai/mcp"],
      "env": {
        "POSTAI_API_KEY": "your-api-key"
      }
    }
  }
}
⌨️

Cursor

Schedule posts and query analytics right from your editor. Great for developers who want to automate content alongside code shipping.

.cursor/mcp.jsonjson
{
  "mcpServers": {
    "postai": {
      "command": "npx @postai/mcp",
      "env": {
        "POSTAI_API_KEY": "your-api-key"
      }
    }
  }
}
⚙️

Custom Agent

Building your own AI agent? PostAI's MCP server connects via stdio or SSE transport. Any MCP-compatible client works out of the box.

SSE endpointjson
# SSE transport for web-based clients
https://api.postai.app/mcp/sse

Authorization: Bearer <your-api-key>
Content-Type: text/event-stream

available MCP tools

10 tools covering the full PostAI feature set

schedule_post

Schedule a post to any connected platform at a specific time or into the queue

create_draft

Save a draft post for review before scheduling — with platform, time, and media

list_queue

View all upcoming scheduled posts across every platform in the workspace

get_analytics

Query X or LinkedIn analytics — impressions, reach, engagement, follower growth

search_viral_posts

Semantic search over PostAI's viral post corpus for any niche or topic

generate_content

Run the AI Content Agent on any URL, text, or topic to produce platform-native posts

list_accounts

List all connected social accounts and their status in the workspace

generate_image

Generate an image via Gemini Imagen 3, SDXL, or DALL-E 3 from a text prompt

get_post_status

Check the publishing status of any scheduled or recently published post

delete_scheduled

Remove a post from the queue before it publishes

api key setup

1
sign up or sign in to PostAI
you need a Pro Plus or Agency plan to access the MCP server. see pricing →
2
generate an API key
go to Settings → API Keys and create a new key. copy it — it won't be shown again.
3
set the environment variable
add your key to the MCP config in your AI client:
POSTAI_API_KEY=pk_live_xxxxxxxxxxxxxxxxxxxx

see it in action

a demo conversation — Claude Desktop scheduling a post via PostAI MCP

Claude Desktop — postai MCP connected
postai mcp active

Schedule a LinkedIn post about our new product feature launching tomorrow. Make it professional but exciting, around 200 words.

you
C

I'll generate that LinkedIn post and schedule it for tomorrow morning at optimal time.

calling generate_content…
// generate_content
{
  "platform": "linkedin",
  "topic": "new product feature launch",
  "tone": "professional, exciting",
  "length": "~200 words"
}
C

Got it. Generated a 194-word post. Scheduling for tomorrow at 8:00 AM based on your account's best engagement window.

calling schedule_post…
// schedule_post
{
  "platform": "linkedin",
  "publish_at": "2025-05-01T08:00:00Z",
  "status": "scheduled",
  "post_id": "post_a4k2m9"
}
C

Done. Your LinkedIn post is scheduled for tomorrow at 8:00 AM ET. I can preview it or make edits if you'd like.

let your ai assistant post for you.

set up in 2 minutes. schedule your first post from Claude Desktop.

get your API key →

available on Pro Plus ($99/mo) · self-hostable · free trial