Publora MCP server

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

Remote Server (Recommended)

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

claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp

Run /mcp, select publora, choose Authenticate and sign in to Publora in the browser. No API key needed.

For CI or headless machines, send a static key instead:

claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

The same entry can go in ~/.claude.json or a project .mcp.json (JSON above). Verify with the /mcp command.

Claude Desktop uses the same connectors as Claude on the web: open claude.ai/directory/publora and select Connect. There is no config file to edit.

Settings → Developer → Edit Config is only needed to run this repository locally over stdio, after cloning it and running npm install (see Local Development for how its tools differ from the hosted server):

{
  "mcpServers": {
    "publora": {
      "command": "node",
      "args": ["/path/to/mcp-server/src/stdio.js"],
      "env": {
        "PUBLORA_API_KEY": "sk_YOUR_API_KEY"
      }
    }
  }
}

Create .cursor/mcp.json in your project:

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

Run your own instance:

git clone https://github.com/publora/mcp-server.git
cd mcp-server
npm install
PUBLORA_API_URL=https://api.publora.com npm start

Server runs on http://localhost:3100

The code in this repository is an April 2026 snapshot of the server. Its tool set is older: it has LinkedIn analytics and workspace tools, and lacks attach_media, complete_media, delete_media, prune_media_reference, account_context, post_stats, profile_stats, linkedin_create_reshare, linkedin_list_mentionables and the company_* Agency tools. Use the hosted server for the current tools.

---

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 is available through the REST API, not MCP. Full parameters: MCP Tools Reference.

The hosted server also lists 52 company_* tools (72 in total) for Agency client work and Company account administration; access follows your Company account type and role. Start Agency client work with the Agency quickstart. First comments: personal posts and Agency posts.

---

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

• MCP Setup Guide: docs.publora.com/guides/mcp-server
• REST API Docs: docs.publora.com
• MCP Protocol: modelcontextprotocol.io

---

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

---

Related

• Publora — Social media scheduling platform
• Publora API Docs — REST API documentation
• awesome-mcp-servers — Community MCP servers list

---

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)