publora/linkedin-post

LinkedIn Post

Create and schedule LinkedIn posts using the Publora MCP server. Supports text posts, single images, multi-image posts (grid layout), videos, and PDF documents.

Prerequisites

Plans: Starter (free), Pro, Premium - LinkedIn is available on all plans including free.

Getting Started

1. Create account at publora.com/register (free)
2. Connect LinkedIn via OAuth in Publora Dashboard
3. Get API key at publora.com/settings/api
4. Configure MCP in Claude Desktop (~/.claude/claude_desktop_config.json):

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

REST API Fallback

If the MCP server is unavailable or returns errors, use the REST API directly:

Base URL: https://api.publora.com/api/v1

Authentication: Use x-publora-key header (NOT Authorization: Bearer):

# Get your connected platforms
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Create a post
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["linkedin-Tz9W5i6ZYG"],
    "content": "Your post content here",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Platform ID Format: linkedin-{id} where {id} is from /platform-connections response.

Example IDs: linkedin-Tz9W5i6ZYG, linkedin-abc123xyz

📖 Full API documentation: docs.publora.com

Plan Limits

| Plan | Posts/month | Price | |------|-------------|-------| | Starter | 15 | Free | | Pro | 100/account | $2.99/account/month | | Premium | 500/account | $9.99/account/month |

Platform Limits

| Feature | Limit | |---------|-------| | Characters | 3,000 max | | Visible before "see more" | First 210 characters | | Images | Up to 10 (grid layout, not swipeable carousel) | | Image size | 5 MB max | | Image formats | JPEG, PNG, GIF, WebP (WebP auto-converted) | | Video duration | 30 minutes | | Video size | 500 MB max | | Video format | MP4 only |

Available Tools

create_post

Create a new LinkedIn post or schedule for later.

Parameters:

• platforms: Array including your LinkedIn connection ID (e.g., ["linkedin-abc123"])
• content: Post text (up to 3,000 characters)
• scheduledTime: ISO 8601 datetime (required - for immediate posting, use current time + 1 minute)

get_upload_url

Get a presigned URL to upload media.

Parameters:

• postGroupId: The post ID to attach media to
• fileName: File name (e.g., "chart.png")
• contentType: MIME type (e.g., "image/jpeg", "video/mp4", "application/pdf")
• type: "image" or "video"

list_posts / update_post / delete_post

Manage your scheduled and draft posts.

Mentioning People and Companies

LinkedIn posts support @mentions using URN syntax:

@{urn:li:person:MEMBER_ID|Display Name}       # Mention a person
@{urn:li:organization:ORG_ID|Company Name}    # Mention a company

Example:

Great insights from @{urn:li:person:4986615|Serge Bulaev} at @{urn:li:organization:107107343|Creative Content Crafts Inc}!

Important: The display name must exactly match the LinkedIn profile name (case-sensitive), including company suffixes like "Inc", "LLC", etc.

Important API Restrictions

1. No organic carousels: Swipeable multi-image carousels are NOT available via API (only for sponsored content). Multi-image posts appear as a grid layout.

2. No mixed media: Cannot combine images with videos or documents in the same post.

3. No rich text: LinkedIn API does not support bold, italic, or other formatting. Use plain text or Unicode characters for emphasis.

4. PDF alternative for carousels: To share multi-page swipeable content, upload a PDF document instead.

Examples

Simple Text Post

Schedule a LinkedIn post for tomorrow at 9 AM:
"We're thrilled to announce the release of our AI writing assistant. After 18 months of development, we're ready to help teams write better content faster."

Post with Mention

Create a LinkedIn post mentioning our CEO:
"Excited to share insights from @{urn:li:person:4986615|Serge Bulaev} on the future of AI in content creation."

Multi-Image Post

Create a LinkedIn post with 4 product screenshots showing our new dashboard features.

Note: Images will appear in a grid layout, not as a swipeable carousel.

PDF Document Post

Share our Q4 report as a PDF on LinkedIn with a summary caption.

This is the best way to share multi-page carousel-like content.

Best Practices

1. First line matters: First 210 characters appear before "see more" - make them compelling
2. Optimal length: Posts under 1,300 characters tend to perform better
3. Posting times: Tuesday-Thursday, 8-10 AM in your audience's timezone
4. Hashtags: Use 3-5 relevant hashtags - they're supported as plain text
5. Engagement: End with a question to encourage comments

Troubleshooting

| Error | Cause | Solution | |-------|-------|----------| | "Account not connected" | LinkedIn OAuth expired | Reconnect in Publora dashboard | | "MEDIA_ASSET_PROCESSING_FAILED" | File too large or wrong format | Check: images < 5 MB, videos < 500 MB MP4 | | "Rate limited" (429) | Too many API calls | Wait and retry with backoff | | "Cannot mix media types" | Images + video in same post | Use only one media type per post | | MCP unavailable | Server issue | Use REST API fallback (see above) |