posterly MCP Server

Use Posterly from any MCP-compatible AI client.

This package gives Claude Desktop, Cursor, Windsurf, Cline, and other local MCP clients a stdio server that can:

• list connected social accounts
• resolve brands/clients into the right accounts
• schedule and manage posts
• upload media
• generate images
• read account and post analytics

Posterly also exposes the same toolset over HTTP at poster.ly/mcp, but this npm package is the local stdio transport.

Requirements

• Node.js 20+
• A Posterly account: poster.ly/signup
• The Posterly API add-on enabled: poster.ly/dashboard/api
• A Posterly API key

Install

You can install globally:

npm install -g posterly-mcp-server

Or just use it via npx in your MCP config:

{
  "mcpServers": {
    "posterly": {
      "command": "npx",
      "args": ["-y", "posterly-mcp-server"],
      "env": {
        "POSTERLY_API_KEY": "pst_live_your_key_here"
      }
    }
  }
}

Quick setup

1. Sign up at poster.ly
2. Go to Dashboard → API & MCP
3. Enable the API add-on
4. Generate an API key
5. Paste it into your MCP client config as POSTERLY_API_KEY
6. Restart your AI client

Example configs

Claude Desktop

Add this to your Claude Desktop MCP config:

{
  "mcpServers": {
    "posterly": {
      "command": "npx",
      "args": ["-y", "posterly-mcp-server"],
      "env": {
        "POSTERLY_API_KEY": "pst_live_your_key_here"
      }
    }
  }
}

Cursor

Add the same server definition to your Cursor MCP settings:

{
  "mcpServers": {
    "posterly": {
      "command": "npx",
      "args": ["-y", "posterly-mcp-server"],
      "env": {
        "POSTERLY_API_KEY": "pst_live_your_key_here"
      }
    }
  }
}

Available tools

[email protected] exposes 16 tools:

• whoami
• list_accounts
• list_brands
• get_brand
• list_brand_accounts
• get_brand_profile
• list_posts
• get_post
• create_post (supports thread_posts: string[] for X / Threads reply chains, plus platform_settings for platform-specific composer controls)
• update_post (also accepts platform_settings)
• delete_post
• upload_media
• find_available_slot
• generate_image
• get_account_analytics
• get_post_analytics

What the brand tools are for

Posterly workspaces often have multiple connected accounts under one client or brand.

The brand tools let an assistant work at the same level a human does:

• list_brands lets the agent see clients/brands in the workspace
• get_brand returns summary info for one brand
• list_brand_accounts resolves a brand into the actual connected accounts
• get_brand_profile returns saved brand guidance like tone, audience, keywords, dos and don'ts, and visual notes

This makes prompts like:

• "How is Grassroots doing on Instagram?"
• "Write a post for the Posterly brand voice"
• "Schedule something for our Dubai dental client"

much more reliable than forcing the agent to guess from raw account handles alone.

Example prompts

• What Posterly accounts do I have connected?
• List my brands in Posterly
• Show me the brand profile for Grassroots
• Find the next 3 posting slots for my LinkedIn account
• Schedule a post for tomorrow at 9am for the Posterly Instagram account
• Schedule this as an Instagram Story with a first comment and @partner as collaborator
• Schedule this YouTube video as unlisted, add the thumbnail URL, and put it in our launch playlist
• Post this TikTok with direct-post privacy set to public and stitch disabled
• How did Grassroots perform on Instagram in the last 30 days?

Pricing

This package uses the Posterly API/MCP add-on:

• $3/month add-on
• 30 requests/hour per API key
• user-created API keys per plan: Starter 1, Pro 2, Power User 3, Agency 4
• works across all 11 supported platforms

Each API call counts as one request, so you can still schedule multiple posts in a single request to maximize throughput.

Details: poster.ly/dashboard/api

Links

• Docs: poster.ly/mcp
• OpenClaw skill: poster.ly/openclaw
• API add-on: poster.ly/dashboard/api
• MCP server card: /.well-known/mcp/server-card.json
• OAuth authorization server metadata: /.well-known/oauth-authorization-server
• OAuth protected resource metadata: /.well-known/oauth-protected-resource

Development

From the mcp-server directory:

npm install
npm run build
npm start

The package reads:

• POSTERLY_API_KEY
• optional POSTERLY_URL if you need to point at a non-production environment