PM

publora/mcp-server

Developer tools
6 stars 3 forks Quality 86 Trend 28MIT

Official MCP server for Publora - control social media scheduling from AI assistants like Claude, Cursor

Overview

Official Model Context Protocol (MCP) server for Publora — control your social media scheduling directly from AI assistants like Claude, Cursor, and any MCP-compatible client. Just describe what you want in plain English: "Schedule a LinkedIn post for tomorrow at 9am" "How did my last post perform?" "Post this to Twitter and LinkedIn" Publora hosts an MCP server at mcp.publora.com/mcp — no installation needed. Install it from the connectors directory: claude.ai/directory/publora. Select , sign in to Publora, approve. No API key, no config file — on web, desktop and mobile alike. at app.publora.com/dashboard/api ( in the dashboard sidebar) Clients that support OAuth (Claude Code, Cursor, VS Code, Codex and others) can leave out headers and sign in through the browser instead. and start talking to your AI about social media!

README

Publora MCP Server

Official Model Context Protocol (MCP) server for Publora — control your social media scheduling directly from AI assistants like Claude, Cursor, and any MCP-compatible client.

No coding required. Just describe what you want in plain English:

“Schedule a LinkedIn post for tomorrow at 9am” “How did my last post perform?” “Post this to Twitter and LinkedIn”

Quick Start

Publora hosts an MCP server at mcp.publora.com/mcp — no installation needed.

Using Claude? Install it from the connectors directory: claude.ai/directory/publora. Select Connect, sign in to Publora, approve. No API key, no config file — on web, desktop and mobile alike.

Every other client:

1. Get your API key at app.publora.com/dashboard/api (API in the dashboard sidebar)

2. Add to your MCP client:

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_YOUR_API_KEY"
      }
    }
  }
}

Clients that support OAuth (Claude Code, Cursor, VS Code, Codex and others) can leave out headers and sign in through the browser instead.

3. Restart your client and start talking to your AI about social media!


Client Setup


Available Tools (20)

The hosted server at mcp.publora.com/mcp exposes:

Posts

Tool Description
list_posts List posts with filters (status, platform, dates)
create_post Create a draft, schedule a post, or publish now with publishNow: true; accepts mediaUrls and platformSettings
get_post Get post details and status
update_post Edit a draft or scheduled post: content, platforms, schedule, status, or publish it now with publishNow: true
delete_post Delete a post

Media

Tool Description
attach_media Attach an image or video from ChatGPT to an existing post; leaves the post in draft
get_upload_url Get a presigned URL for media upload
complete_media Finalize a file uploaded via get_upload_url
delete_media Remove a media slot from a post
prune_media_reference Remove a stale media reference that delete_media cannot handle

Account and connections

Tool Description
account_context Your plan, available features, publishing quotas and schedule horizon — check before a batch of posts or after a quota error
list_connections List connected social accounts

Statistics (Mastodon and Bluesky, Pro plan or legacy Premium)

Tool Description
post_stats Engagement counters for published posts
profile_stats Followers, following and post count of a connected account

LinkedIn Engagement

Tool Description
linkedin_create_reaction React to a post
linkedin_delete_reaction Remove a reaction
linkedin_create_comment Post a comment on a LinkedIn post
linkedin_delete_comment Delete a comment
linkedin_create_reshare Repost/reshare a LinkedIn post
linkedin_list_mentionables List people you can @mention in a LinkedIn post

LinkedIn analytics and workspace management are available through the REST API, not MCP. Full parameters: MCP Tools Reference.


Example Conversations

Schedule a post:

You: Schedule “Excited about our product launch!” to LinkedIn for tomorrow 9am AI: Done! Post scheduled for tomorrow at 9am EST.

Cross-platform posting:

You: Post “We’re hiring!” to all my accounts AI: Published to Twitter, LinkedIn, and Bluesky.

Check engagement (Mastodon, Bluesky):

You: How did my last Bluesky post do? AI: 42 likes, 7 reposts and 3 replies so far.

Content calendar:

You: What do I have scheduled for next week? AI: 5 posts: Mon LinkedIn, Tue Twitter+LinkedIn, Wed LinkedIn…


Who Is This For?

  • Marketers — manage campaigns and check analytics via AI chat
  • Content creators — schedule posts without switching apps
  • Business owners — delegate social media tasks to AI
  • Developers — integrate Publora into AI-powered workflows

Supported Platforms

Twitter/X · LinkedIn · Instagram · Threads · TikTok · YouTube · Facebook · Bluesky · Mastodon · Telegram


Authentication

Clients that support OAuth 2.1 (Claude, Claude Code, Cursor, VS Code, Codex and others) sign in through the browser — no key to copy.

Everywhere else, use your Publora API key via:

  • Authorization: Bearer sk_... (recommended)
  • x-publora-key: sk_...

Get your key: app.publora.com/dashboard/api


Verification

# Health check
curl https://mcp.publora.com/health

# Test MCP handshake
curl -X POST https://mcp.publora.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer sk_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'

Documentation


Development

# Install
npm install

# Run locally
PUBLORA_API_URL=https://api.publora.com npm start

# Run tests
npm test

Environment Variables

Variable Default Description
PORT 3100 Server port
PUBLORA_API_URL https://api.publora.com Backend API URL


License

MIT


Publora — Affordable social media API: free Starter plan with API and MCP access; Pro from $5.99 per account per month ($3.99 billed yearly)

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{ "mcpServers": { "publora": { "type": "http", "url": "https://mcp.publora.com/mcp", "headers": { "Authorization": "Bearer sk_YOUR_API_KEY" } } } }