PlanPost
lukbb/planpost-mcp
Schedule posts to 7 social networks, render video and carousels, read analytics and revenue.
- tools
- 49
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 2
- last updated
- Nov 9, 2026
Tools
49 toolsPublic tool metadata for what this MCP can expose to an agent.
list_postsList posts, filter by status/platform
List posts, filter by status/platform
No parameter schema in public metadata yet.
get_postFetch one post
Fetch one post
No parameter schema in public metadata yet.
create_postCreate a draft or scheduled post (per-platform content/settings/media, UTM overrides, timezone)
Create a draft or scheduled post (per-platform content/settings/media, UTM overrides, timezone)
No parameter schema in public metadata yet.
update_postUpdate a draft/scheduled post
Update a draft/scheduled post
No parameter schema in public metadata yet.
delete_postDelete a post
Delete a post
No parameter schema in public metadata yet.
publish_postPublish immediately
Publish immediately
No parameter schema in public metadata yet.
retry_failedRe-queue the platforms that failed for a transient reason; never re-posts one that went out
Re-queue the platforms that failed for a transient reason; never re-posts one that went out
No parameter schema in public metadata yet.
get_delivery_reportThe morning check: recent failed or partly failed posts with each platform's error and fix, unhealthy connections, approvals running late
The morning check: recent failed or partly failed posts with each platform's error and fix, unhealthy connections, approvals running late
No parameter schema in public metadata yet.
preview_postShow exactly what each platform will receive (text after overrides, attachments, warnings)
Show exactly what each platform will receive (text after overrides, attachments, warnings)
No parameter schema in public metadata yet.
bulk_create_postsCreate a whole campaign of posts from one manifest
Create a whole campaign of posts from one manifest
No parameter schema in public metadata yet.
list_campaignsCampaign tags in use, with post counts by status and platform
Campaign tags in use, with post counts by status and platform
No parameter schema in public metadata yet.
delete_postsBulk-delete posts matching a filter (a filter is required)
Bulk-delete posts matching a filter (a filter is required)
No parameter schema in public metadata yet.
list_mediaMedia already uploaded, so an asset can be reused instead of re-uploaded
Media already uploaded, so an asset can be reused instead of re-uploaded
No parameter schema in public metadata yet.
upload_mediaGet a presigned URL to upload an image/video
Get a presigned URL to upload an image/video
No parameter schema in public metadata yet.
repurpose_contentSave repurposed content as draft posts
Save repurposed content as draft posts
No parameter schema in public metadata yet.
list_connectionsConnected social accounts
Connected social accounts
No parameter schema in public metadata yet.
list_account_groupsNamed account groups (e.g. "Polish Pages")
Named account groups (e.g. "Polish Pages")
No parameter schema in public metadata yet.
get_account_groupResolve a group by id/name/default → connection IDs
Resolve a group by id/name/default → connection IDs
No parameter schema in public metadata yet.
create_account_groupCreate a named group bundling connections
Create a named group bundling connections
No parameter schema in public metadata yet.
update_account_groupRename, recolour, set default, or replace a group's connections
Rename, recolour, set default, or replace a group's connections
No parameter schema in public metadata yet.
delete_account_groupDelete a group (the accounts stay connected)
Delete a group (the accounts stay connected)
No parameter schema in public metadata yet.
add_connections_to_groupAdd connections to a group
Add connections to a group
No parameter schema in public metadata yet.
remove_connections_from_groupRemove connections from a group
Remove connections from a group
No parameter schema in public metadata yet.
get_connection_linkLink the user opens in a browser to connect a new social account (OAuth needs a human)
Link the user opens in a browser to connect a new social account (OAuth needs a human)
No parameter schema in public metadata yet.
submit_for_approvalSend a post to a human reviewer (required when the API key is approval-gated)
Send a post to a human reviewer (required when the API key is approval-gated)
No parameter schema in public metadata yet.
list_pending_approvalsPosts waiting for review, with outcomes
Posts waiting for review, with outcomes
No parameter schema in public metadata yet.
get_approval_statusPending / approved / rejected / changes requested for one submission
Pending / approved / rejected / changes requested for one submission
No parameter schema in public metadata yet.
get_best_timesBest posting times per platform from the account's engagement history
Best posting times per platform from the account's engagement history
No parameter schema in public metadata yet.
suggest_scheduleSpread N posts across a date range at optimal times; returns concrete timestamps
Spread N posts across a date range at optimal times; returns concrete timestamps
No parameter schema in public metadata yet.
get_posting_scheduleWeekly queue slots, global plus per-group overrides
Weekly queue slots, global plus per-group overrides
No parameter schema in public metadata yet.
set_posting_scheduleReplace the weekly queue slots for the global schedule or one group (Pro)
Replace the weekly queue slots for the global schedule or one group (Pro)
No parameter schema in public metadata yet.
list_video_templatesBrowse video templates and their editable fields
Browse video templates and their editable fields
No parameter schema in public metadata yet.
create_videoSubmit a render job from a template
Submit a render job from a template
No parameter schema in public metadata yet.
get_video_statusPoll a render; completed renders return download URLs
Poll a render; completed renders return download URLs
No parameter schema in public metadata yet.
generate_carouselDecompose long-form content into carousel slide text
Decompose long-form content into carousel slide text
No parameter schema in public metadata yet.
list_carousel_stylesTemplate families, 40-palette library, formats, font pairings
Template families, 40-palette library, formats, font pairings
No parameter schema in public metadata yet.
render_carouselRender slides into branded PNGs in the media library
Render slides into branded PNGs in the media library
No parameter schema in public metadata yet.
get_carousel_renderPoll a render; completed renders return post-ready media assets
Poll a render; completed renders return post-ready media assets
No parameter schema in public metadata yet.
list_brand_kitsSaved brand kits (palette, fonts, logo, handle) for render_carousel
Saved brand kits (palette, fonts, logo, handle) for render_carousel
No parameter schema in public metadata yet.
generate_imageGenerate an image with AI for a post (1 AI credit); pass the URL to create_post
Generate an image with AI for a post (1 AI credit); pass the URL to create_post
No parameter schema in public metadata yet.
list_content_sourcesList WordPress/RSS sources
List WordPress/RSS sources
No parameter schema in public metadata yet.
add_content_sourceConnect a WordPress site or RSS feed
Connect a WordPress site or RSS feed
No parameter schema in public metadata yet.
delete_content_sourceRemove a source
Remove a source
No parameter schema in public metadata yet.
fetch_source_contentImport the latest content now
Import the latest content now
No parameter schema in public metadata yet.
list_imported_contentList imported content for repurposing
List imported content for repurposing
No parameter schema in public metadata yet.
get_analyticsPost performance (impressions, likes, comments, shares)
Post performance (impressions, likes, comments, shares)
No parameter schema in public metadata yet.
get_revenue_overviewRevenue totals + trend; optionally recent transactions and Stripe/RevenueCat MRR
Revenue totals + trend; optionally recent transactions and Stripe/RevenueCat MRR
No parameter schema in public metadata yet.
get_brand_voicesTone-of-voice profiles analysed from the user's content
Tone-of-voice profiles analysed from the user's content
No parameter schema in public metadata yet.
get_brand_voice_promptReady-to-use system prompt for a voice; apply it when drafting posts
Ready-to-use system prompt for a voice; apply it when drafting posts
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
PLANPOST_API_KEY*secretPlanPost API key from Settings -> API Keys (starts with pk_live_).
PLANPOST_API_URLdefault: https://api.planpo.stAPI base URL. Only change it for a self-hosted PlanPost.
Readme
planpost-mcp
MCP (Model Context Protocol) server for PlanPost, the agentic social scheduler with revenue attribution. It lets Claude, ChatGPT, Cursor, Gemini CLI and other AI agents schedule social media posts, create videos and carousels, manage content sources, and read analytics and revenue data by talking to your PlanPost account.
Quick start
The short way: sign in
Add https://mcp.planpo.st/mcp to your agent as a remote MCP server (a
"connector" in Claude and ChatGPT) and leave the authentication fields empty.
The first time the agent uses it, a browser opens on planpo.st: log in, review
what the agent may do, and choose whether its posts wait for your approval.
No key to create or paste.
claude mcp add --transport http planpost https://mcp.planpo.st/mcp
{ "mcpServers": { "planpost": { "url": "https://mcp.planpo.st/mcp" } } }
Connected agents are listed under Settings → API Keys → Connected apps, where you can remove one at any time. They use the same permissions and the same monthly call allowance as API keys.
Details
- Repository
- github.com/lukbb/planpost-mcp
- Website
- planpo.st/mcp
- Categories
- Sales & Marketing, Design & Creative, Automation & Workflows, Monitoring & Observability, Media & Entertainment
- Package
planpost-mcp- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
