Skip to content
publoraPublic

About

Official Publora skills for AI agents: post and schedule to LinkedIn, X, Instagram, Threads, TikTok, YouTube, Facebook, Bluesky, Mastodon and Telegram from Claude Code, Codex, Cursor or OpenClaw through the Publora MCP server. 9 SKILL.md, MIT. Install: npx skills add publora/skills

Topics

Resources

Contributing

Security policy

Stars

60 stars

Watchers

1 watching

Forks

Repository files navigation

Publora skills: post to ten social networks from Claude Code, Codex, Cursor or OpenClaw through the Publora MCP server

Publora Skills: post to 10 social networks from your AI agent

Latest release 20 MCP tools Claude Code compatible Codex compatible MIT License GitHub stars

Official skills from the Publora team. Nine SKILL.md files that teach Claude Code, Codex, Cursor, OpenClaw or any skills-aware agent how to publish and schedule posts on LinkedIn, X, Instagram, Threads, TikTok, YouTube, Facebook, Bluesky, Mastodon and Telegram through the Publora MCP server.

Create drafts and schedule posts through your agent. One integration instead of ten platform APIs, each with its own auth, media pipeline and rate limits.

Install

Using Claude? Install from the connectors directory — no API key, no config: claude.ai/directory/publora

For every other agent, connect as below. Clients that cannot sign in through the browser need an API key from app.publora.com/dashboard/api.

Client How
Claude (web, desktop, mobile) claude.ai/directory/publora, select Connect. OAuth, no key
Claude Code claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp, then /mcp to sign in. No key needed
Claude Code (plugin) /plugin marketplace add publora/skills
Claude Desktop Install from the directory like the web app; no config file (details)
Any agent (skills CLI) npx skills add publora/skills
Codex add publora/skills as a marketplace, then install the publora-skills plugin
Cursor Settings, MCP, add https://mcp.publora.com (guide)
OpenClaw docs.publora.com/mcp/openclaw

Existing Claude Code connections

If you previously connected to https://mcp.publora.com without /mcp, installing this plugin can leave two Publora servers. Claude treats the two URL paths as different endpoints even though both work on Publora.

Check /mcp or claude mcp list and choose which account and authentication you want to keep:

  • Keep your manual connection: change its URL to https://mcp.publora.com/mcp in the same local, project or user scope, preserving its authentication settings. Sign in again if requested. Claude combines it with the plugin's matching endpoint; do not add another entry.
  • Use the bundled OAuth connection: sign in to the intended Publora account through the plugin, verify it is the account you want, then remove only the old manual server entry from the scope where it was configured. Do not delete credentials or disconnect social accounts as part of this cleanup.

Restart the session and check that only one Publora connection remains.

The free Starter plan covers every platform except X. Current limits and pricing: publora.com/pricing.

The 9 skills

Skill Use it when It never
linkedin-post the user wants a LinkedIn post, a multi-image grid, a PDF document or an @mention builds a swipeable carousel, which the API reserves for sponsored content
linkedin-analytics the user asks how a post or the account performed, or wants to react, comment or reshare calls an MCP tool for LinkedIn statistics, which are REST only
x-post the user wants a tweet or a thread auto-split past 280 characters works on the free plan, since X API costs are passed through
threads-post the user wants a Threads post, a multi-part chain or an image carousel splits content over 500 characters into a connected chain of replies; --- lines set the breaks
instagram-post the user has a JPEG, a carousel, a Reel or a Story and a Business account sends PNG, or posts text with no media
tiktok-post the user has a vertical video for TikTok promises a public post from an unaudited app, where everything lands private
telegram-post the user wants a channel or group post through a bot exceeds the 1,024-character media caption or the 50 MB bot video ceiling
bluesky-post the user wants a 300-character Bluesky post with alt text uses the account password instead of an app password
social-post the user targets YouTube, a Facebook Page or Mastodon posts to a personal Facebook profile, which the API forbids

How it works

The MCP server exposes 20 tools:

Posts create_post, get_post, update_post, delete_post, list_posts

Media attach_media, get_upload_url, complete_media, delete_media, prune_media_reference

Account and connections account_context, list_connections

Engagement counts post_stats, profile_stats — Mastodon and Bluesky only, on plans with analytics

LinkedIn engagement linkedin_create_reaction, linkedin_delete_reaction, linkedin_create_comment, linkedin_delete_comment, linkedin_create_reshare, linkedin_list_mentionables

Clients also list 48 company_* tools (68 in total). They cover Agency client work and Company account administration; access follows your Company account type and role.

Full signatures: docs.publora.com/mcp/tools-reference.

Three things worth knowing before your agent writes its first call:

  • Media in one call. Pass up to 10 public https mediaUrls to create_post. Publora downloads them server-side and attaches them before validation, so you can attach media and schedule in a single request instead of running the four-step upload flow.
  • Draft or schedule. Omit scheduledTime and you get a draft. Send a future ISO 8601 UTC time to schedule. A time five or more minutes in the past is rejected.
  • Platform IDs are not guessable. Call list_connections and copy the platformId values verbatim.

These skills do not enforce a separate preview or approval step before scheduling or publishing. Whether a confirmation prompt appears depends on the agent and client settings and instructions.

REST fallback

Every MCP tool has a REST twin at https://api.publora.com/api/v1, authenticated with the x-publora-key header rather than a bearer token. Some things are REST only, including LinkedIn statistics and workspace (managed-user) administration. The per-platform platformSettings block that controls Instagram video type, TikTok privacy, YouTube visibility, Telegram delivery flags and Threads reply control works over both: the MCP create_post and update_post tools accept it too.

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

Full reference: docs.publora.com.

FAQ

Does X work on the free plan? No. X requires a paid plan because the X API bills per call. Every other platform works on the free Starter plan.

Can I post a swipeable carousel to LinkedIn? Not through the API, which reserves organic carousels for sponsored content. Multi-image posts render as a grid. For swipeable multi-page content, upload a PDF document instead.

Why did my TikTok video publish as private? TikTok forces SELF_ONLY for apps that have not passed its audit, whatever viewerSetting you send. Ask Publora support about the audited app.

Why is my Instagram post rejected? Instagram's Graph API takes JPEG only, requires a Business account, and refuses text-only posts. PNG uploads fail.

Can I edit a scheduled post? Yes. update_post patches content, platforms, scheduledTime and platformSettings on a draft or scheduled post, so a typo no longer means deleting and recreating.

How do I update these skills? Run npx skills add publora/skills again. What changed is listed in CHANGELOG.md and on the Releases page.

Contributing

Read CONTRIBUTING.md first. The short version: these skills must not restate facts that live in the API. No prices, no hand-copied platform limits, no tool that is not in the live tools/list. CI enforces all three.

Related

License

MIT

About

Official Publora skills for AI agents: post and schedule to LinkedIn, X, Instagram, Threads, TikTok, YouTube, Facebook, Bluesky, Mastodon and Telegram from Claude Code, Codex, Cursor or OpenClaw through the Publora MCP server. 9 SKILL.md, MIT. Install: npx skills add publora/skills

Topics

Resources

Contributing

Security policy

Stars

60 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages