@publora/mcp-server
v1.1.0
Published
Official MCP server for Publora - control social media scheduling from AI assistants
Maintainers
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
Remote Server (Recommended)
Publora hosts an MCP server at mcp.publora.com — no installation needed.
1. Get your API key at publora.com → Settings → API
2. Add to your MCP client:
{
"mcpServers": {
"publora": {
"type": "http",
"url": "https://mcp.publora.com",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}3. Restart your client and start talking to your AI about social media!
Client Setup
Edit ~/.claude.json or create .mcp.json in your project:
{
"mcpServers": {
"publora": {
"type": "http",
"url": "https://mcp.publora.com",
"headers": {
"Authorization": "Bearer sk_YOUR_API_KEY"
}
}
}
}Restart Claude Code. Verify with /mcp command.
- Open Claude Desktop → Settings → Developer → Edit Config
- Add the Publora server (same JSON as above)
- Restart Claude Desktop
Create .cursor/mcp.json in your project:
{
"mcpServers": {
"publora": {
"type": "http",
"url": "https://mcp.publora.com",
"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 startServer runs on http://localhost:3100
Available Tools (18)
Posts
| Tool | Description |
|------|-------------|
| list_posts | List posts with filters (status, platform, dates) |
| create_post | Schedule a post to one or more platforms |
| get_post | Get post details and status |
| update_post | Reschedule or change status |
| delete_post | Delete a post |
| get_upload_url | Get presigned URL for media upload |
Connections
| Tool | Description |
|------|-------------|
| list_connections | List connected social accounts |
LinkedIn Analytics
| Tool | Description |
|------|-------------|
| linkedin_post_stats | Post engagement metrics |
| linkedin_account_stats | Account-level statistics |
| linkedin_followers | Follower count and growth |
| linkedin_profile_summary | Combined profile overview |
| 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 |
Workspace (B2B)
| Tool | Description |
|------|-------------|
| list_workspace_users | List team members |
| create_workspace_user | Add a user |
| workspace_detach_user | Remove a user |
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 analytics:
You: How did my LinkedIn posts perform this week? AI: 5 posts, 4,230 impressions, 89 reactions. Best: Monday's update (1,850 impressions).
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
Use your Publora API key via:
Authorization: Bearer sk_...(recommended)x-publora-key: sk_...
Get your key: publora.com → Settings → API
Verification
# Health check
curl https://mcp.publora.com/health
# Test MCP handshake
curl -X POST https://mcp.publora.com \
-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 testEnvironment 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
Publora — Affordable social media API starting at $5.40/month
