FoPost

Official FoPost MCP server. Lets AI agents draft, schedule and publish social media posts across X, LinkedIn, Instagram, TikTok, YouTube, Threads, Bluesky, Facebook, Pinterest, Reddit and more, plus read analytics, manage the posting queue, upload media and reply to the inbox. Every publish waits for the user's approval. Runs locally with npx -y @fopost/mcp or as a hosted remote server at https://api.fopost.com/mcp.

Hosted MCP Server

npx add-mcp 'https://api.fopost.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

@fopost/mcp

MCP server for FoPost: manage social media posts, accounts, AI usage, the inbox, contacts, broadcasts, and ads from any MCP-aware client (Claude Desktop, Cursor, ChatGPT desktop, Continue, etc.).

Runs via npx -y @fopost/mcp, no install step. Requires Node 18 or newer.

0.x release. Tool names and arguments may still change between minor versions. Pin an exact version if that matters to you.

Tools

ToolWhat it does
list_postsList posts in a workspace, filter by status
get_postFetch a post by id
schedule_postCreate a post for accounts or an account group
edit_postUpdate an existing post
cancel_postCancel a scheduled post
delete_postPermanently delete a post
list_post_deliveriesPer-account delivery status for a post
list_accountsList connected social accounts, optionally by group
get_account_healthCheck token freshness and rate-limit headroom
list_workspacesList workspaces the user can access
rename_accountSet or clear an account's display name
list_account_groupsList account groups and their members
get_account_groupFetch an account group
create_account_groupCreate an account group
rename_account_groupRename an account group
set_account_group_membersReplace the accounts in a group
delete_account_groupDelete a group (its accounts stay connected)
create_telegram_connect_codeMint a one-time code to connect a Telegram chat
get_telegram_connect_statusCheck whether a Telegram connect code was used
get_telegram_bot_commandsList the bot command menu in a Telegram chat
set_telegram_bot_commandsReplace the bot command menu in a Telegram chat
clear_telegram_bot_commandsClear the bot command menu in a Telegram chat
list_slack_channelsList the channels a Slack account can post to
list_slack_membersList members of a Slack workspace, for DMs
get_slack_identityShow the name and icon a Slack account posts under
set_slack_identitySet the name and icon a Slack account posts under
list_reddit_subredditsList the subreddits a Reddit account is in
list_reddit_subreddit_rulesList a subreddit's rules, to read before publishing
list_reddit_flairsList a subreddit's post flairs
validate_subredditCheck a subreddit exists and takes a post
set_reddit_default_subredditSet where posts go when a post names no subreddit
generate_captionAI-generate or improve a caption (1 credit)
rewrite_for_platformsRewrite content per target platform (1 credit each)
repurpose_urlTurn a blog URL into N platform-optimized posts (6 credits)
get_ai_creditsShow current AI credit balance
list_inboxList comments, mentions and DMs with filters
list_inbox_threadsList comment threads under your posts, or mentions
list_inbox_conversationsList DM conversations
get_inbox_unread_countCount unread inbox items
mark_inbox_thread_readMark a comment thread or DM conversation read
resolve_inboxResolve every unanswered item of one type
reply_to_inbox_itemReply on the platform, with media or quick replies on a DM
edit_inbox_commentEdit your own comment on the platform
update_inbox_itemSet an item to unread, read, resolved or snoozed
hide_inbox_itemHide a comment on the platform
unhide_inbox_itemUnhide a comment on the platform
delete_inbox_itemDelete a comment, or your own reply, on the platform
like_inbox_itemLike a comment or message on the platform
unlike_inbox_itemRemove your like
repost_inbox_itemRepost a post on X, where can_repost is true
unrepost_inbox_itemUndo your repost on X
bookmark_inbox_itemBookmark a post on X, where can_bookmark is true
unbookmark_inbox_itemRemove your bookmark on X
vote_inbox_itemVote up or down, or take the vote back
pin_inbox_itemPin your own comment
unpin_inbox_itemUnpin your own comment
react_to_inbox_itemReact to a DM, or remove your reaction
start_inbox_conversationSend a new DM, or answer a comment privately
set_inbox_typingShow or clear the typing indicator in a DM
list_inbox_approvalsList drafted replies waiting for approval
approve_inbox_replyApprove and send a drafted reply
reject_inbox_replyReject a drafted reply
refresh_inboxPoll every inbox-capable account now
list_adsList boosts and ads created through FoPost
list_external_adsList ads on connected ad accounts made elsewhere
list_boostable_postsList published posts that can be boosted
list_ad_sourcesList ad connections, ad accounts and pages
boost_postBoost a published post (starts paused, needs publish)
create_adCreate an ad (starts paused, needs publish)
set_ad_statusPause or resume an ad (needs publish)
refresh_adRe-read delivery status and insights
delete_adEnd delivery and delete an ad (needs publish)
list_audiencesList saved audiences and pixels on an ad account
search_ad_targetingSearch locations, interests, behaviors and income brackets
list_lead_formsList lead forms on connected pages
list_leadsList one page of leads from a lead form
get_ad_account_treeRead campaigns, ad sets and ads on an ad account
create_ad_campaignCreate a campaign (starts paused, needs publish)
get_ad_campaignRead one campaign
update_ad_campaignRename, pause or resume a campaign (needs publish)
delete_ad_campaignDelete a campaign and its contents (needs publish)
duplicate_ad_campaignCopy a campaign (starts paused, needs publish)
create_ad_setCreate an ad set (starts paused, needs publish)
get_ad_setRead one ad set
update_ad_setChange an ad set's status, budget or targeting (needs publish)
delete_ad_setDelete an ad set and its ads (needs publish)
duplicate_ad_setCopy an ad set (starts paused, needs publish)
create_network_adCreate an ad inside an ad set (starts paused, needs publish)
get_network_adRead one ad inside an ad set
update_network_adRename, pause, resume or swap an ad's creative (needs publish)
delete_network_adDelete an ad inside an ad set (needs publish)
duplicate_network_adCopy an ad (starts paused, needs publish)
bulk_set_ad_statusPause or resume up to 50 objects (needs publish)
list_ad_creativesList creatives on an ad account
create_ad_creativeCreate an image, video or carousel creative
get_ad_creativeRead one creative
delete_ad_creativeDelete a creative
get_audienceRead one saved audience
update_audienceRename or redescribe a saved audience
delete_audienceDelete a saved audience
add_audience_usersAdd customer emails to a custom audience
estimate_ad_reachEstimate the reach of a targeting
get_ad_object_insightsInsights for a campaign, ad set or ad
get_ad_insightsInsights for an ad created through FoPost
get_lead_formRead one lead form
archive_lead_formArchive a lead form
list_leads_feedList stored leads from subscribed pages
list_lead_pagesList pages subscribed to new leads
subscribe_lead_pageSubscribe a page to new leads and backfill
unsubscribe_lead_pageUnsubscribe a page from new leads
get_whatsapp_profileThe profile on a WhatsApp number and how the platform rates it
update_whatsapp_profileUpdate the profile fields the platform allows
list_whatsapp_templatesMessage templates with the review status the platform assigned
get_whatsapp_template_libraryThe platform's pre-written templates, for adapting
create_whatsapp_templateFile a template for review, from scratch or a library entry
list_whatsapp_flowsIn-chat forms, with their status and validation errors
get_whatsapp_flow_responsesWhat people submitted through this account's flows
list_whatsapp_groupsGroups this WhatsApp number created, with their invite links
get_whatsapp_account_stateWhatsApp account review state and the number's standing
ToolWhat it does
-------------------------------------------------------------------------------------------------------
list_postsList posts in a workspace, filter by status
get_postFetch a post by id
schedule_postCreate a post for accounts or an account group, with local files
edit_postUpdate an existing post, optionally attaching local files
get_upload_limitsLargest file the account may upload, and the allowed types
cancel_postCancel a scheduled post
delete_postPermanently delete a post
list_post_deliveriesPer-account delivery status for a post
list_accountsList connected social accounts, optionally by group
get_account_healthCheck token freshness and rate-limit headroom
get_account_platform_metricsThe numbers only an account's own network reports
list_workspacesList workspaces the user can access
rename_accountSet or clear an account's display name
list_account_groupsList account groups and their members
get_account_groupFetch an account group
create_account_groupCreate an account group
rename_account_groupRename an account group
set_account_group_membersReplace the accounts in a group
delete_account_groupDelete a group (its accounts stay connected)
create_telegram_connect_codeMint a one-time code to connect a Telegram chat
get_telegram_connect_statusCheck whether a Telegram connect code was used
get_telegram_bot_commandsList the bot command menu in a Telegram chat
set_telegram_bot_commandsReplace the bot command menu in a Telegram chat
clear_telegram_bot_commandsClear the bot command menu in a Telegram chat
list_slack_channelsList the channels a Slack account can post to
list_slack_membersList members of a Slack workspace, for DMs
get_slack_identityShow the name and icon a Slack account posts under
set_slack_identitySet the name and icon a Slack account posts under
get_messaging_settingRead a Meta ice breakers, persistent menu or greeting setting
set_ice_breakersReplace the prompts shown before the first message
set_persistent_menuReplace the always-visible Messenger menu
set_greetingReplace the Messenger greeting
clear_messaging_settingClear one Meta messaging-profile setting
get_webhook_subscriptionCheck what the network delivers to the FoPost webhook
resubscribe_webhookRe-subscribe an account whose webhook lapsed
list_discord_channelsList the channels a Discord bot account can post to
switch_discord_channelMove a Discord account to another channel in the same server
get_discord_identityShow the nickname and avatar the bot wears in the server
set_discord_identitySet the nickname and avatar the bot wears in the server
list_discord_pinsList the pinned messages in the account's channel
manage_discord_messageDelete, pin, unpin, crosspost a message or start a thread on it
send_discord_dmSend one direct message to a member of the server
list_discord_eventsList the server's scheduled events
create_discord_eventAdd a scheduled event to the server
update_discord_eventChange a scheduled event
delete_discord_eventRemove a scheduled event
list_discord_membersList or search the server's members
list_discord_rolesList the server's roles
create_discord_roleAdd a role to the server
assign_discord_roleGive a member a role, or take one away
generate_captionAI-generate or improve a caption (1 credit)
rewrite_for_platformsRewrite content per target platform (1 credit each)
repurpose_urlTurn a blog URL into N platform-optimized posts (6 credits)
get_ai_creditsShow current AI credit balance
list_inboxList comments, mentions and DMs with filters
list_inbox_threadsList comment threads under your posts, or mentions
list_inbox_conversationsList DM conversations
get_inbox_unread_countCount unread inbox items
mark_inbox_thread_readMark a comment thread or DM conversation read
resolve_inboxResolve every unanswered item of one type
reply_to_inbox_itemReply on the platform, with media or quick replies on a DM
edit_inbox_commentEdit your own comment on the platform
update_inbox_itemSet an item to unread, read, resolved or snoozed
hide_inbox_itemHide a comment on the platform
unhide_inbox_itemUnhide a comment on the platform
delete_inbox_itemDelete a comment, or your own reply, on the platform
like_inbox_itemLike a comment or message on the platform
unlike_inbox_itemRemove your like
repost_inbox_itemRepost a post on X, where can_repost is true
unrepost_inbox_itemUndo your repost on X
bookmark_inbox_itemBookmark a post on X, where can_bookmark is true
unbookmark_inbox_itemRemove your bookmark on X
pin_inbox_itemPin your own comment
unpin_inbox_itemUnpin your own comment
react_to_inbox_itemReact to a DM, or remove your reaction
start_inbox_conversationSend a new DM, or answer a comment privately
set_inbox_typingShow or clear the typing indicator in a DM
handover_conversationPass a Messenger thread to another Meta app, or take it back
list_inbox_approvalsList drafted replies waiting for approval
approve_inbox_replyApprove and send a drafted reply
reject_inbox_replyReject a drafted reply
refresh_inboxPoll every inbox-capable account now
list_contactsList the people behind the inbox, most recently active first
get_contactRead one contact
create_contactFile a person by hand; folds into whoever holds the handle
update_contactChange a name, note, channels or custom fields
delete_contactRemove a contact; the messages stay in the inbox
list_contact_conversationsThe inbox threads one contact appears in
import_contactsImport from CSV text
list_contact_fieldsThe columns this workspace keeps about a contact
create_contact_fieldAdd a column
update_contact_fieldRename a field, change its options, or move it
delete_contact_fieldRemove a field and every answer to it
get_conversation_analyticsInbox volume and reply time per thread (needs analytics)
list_broadcastsList broadcasts, newest first
get_broadcastRead one broadcast
create_broadcastWrite one without sending it
update_broadcastEdit a draft or scheduled broadcast
send_broadcastSend it; closed windows are skipped (needs publish)
cancel_broadcastStop it where it stands (needs publish)
list_broadcast_recipientsWho it reached, who it skipped, and why
delete_broadcastRemove it; sent messages stay in their conversations
list_sequencesList drip sequences
get_sequenceRead one sequence and its steps
create_sequenceWrite one; creating it enrolls nobody
update_sequenceEdit the steps, or pause and resume it
enroll_in_sequencePut contacts on it, by id or audience (needs publish)
unenroll_from_sequenceTake contacts off it (needs publish)
list_sequence_enrollmentsWho is on it and what step they are at
delete_sequenceRemove it and every enrollment on it
list_adsList boosts and ads created through FoPost
list_external_adsList ads on connected ad accounts made elsewhere
list_boostable_postsList published posts that can be boosted
list_ad_sourcesList ad connections, ad accounts and pages
list_ad_goalsList the goals this connection can run right now
list_ad_catalogsList product catalogs the connection reaches
create_ad_catalogCreate a product catalog (needs publish)
list_catalog_productsList one page of a catalog's products
write_catalog_productsUpsert or delete up to 500 products (needs publish)
list_catalog_product_setsList the product sets a catalog ad can run from
create_catalog_product_setCreate a product set (needs publish)
list_reach_frequencyList reach-and-frequency predictions on an ad account
search_ad_librarySearch the public ad archive, read live and never stored
list_ad_account_activityRead an ad account's change log
boost_postBoost a published post (starts paused, needs publish)
create_adCreate an ad (starts paused, needs publish)
set_ad_statusPause or resume an ad (needs publish)
refresh_adRe-read delivery status and insights
delete_adEnd delivery and delete an ad (needs publish)
list_audiencesList saved audiences and pixels on an ad account
search_ad_targetingSearch locations, interests, behaviors and income brackets
list_lead_formsList lead forms on connected pages
list_leadsList one page of leads from a lead form
get_ad_account_treeRead campaigns, ad sets and ads on an ad account
create_ad_campaignCreate a campaign (starts paused, needs publish)
get_ad_campaignRead one campaign
update_ad_campaignRename, pause or resume a campaign (needs publish)
delete_ad_campaignDelete a campaign and its contents (needs publish)
duplicate_ad_campaignCopy a campaign (starts paused, needs publish)
create_ad_setCreate an ad set (starts paused, needs publish)
get_ad_setRead one ad set
update_ad_setChange an ad set's status, budget or targeting (needs publish)
delete_ad_setDelete an ad set and its ads (needs publish)
duplicate_ad_setCopy an ad set (starts paused, needs publish)
create_network_adCreate an ad inside an ad set (starts paused, needs publish)
get_network_adRead one ad inside an ad set
update_network_adRename, pause, resume or swap an ad's creative (needs publish)
delete_network_adDelete an ad inside an ad set (needs publish)
duplicate_network_adCopy an ad (starts paused, needs publish)
bulk_set_ad_statusPause or resume up to 50 objects (needs publish)
list_ad_creativesList creatives on an ad account
create_ad_creativeCreate an image, video or carousel creative
get_ad_creativeRead one creative
delete_ad_creativeDelete a creative
get_audienceRead one saved audience
update_audienceRename or redescribe a saved audience
delete_audienceDelete a saved audience
add_audience_usersAdd customer emails to a custom audience
estimate_ad_reachEstimate the reach of a targeting
get_ad_object_insightsInsights for a campaign, ad set or ad
get_ad_insightsInsights for an ad created through FoPost
get_lead_formRead one lead form
archive_lead_formArchive a lead form
list_leads_feedList stored leads from subscribed pages
list_lead_pagesList pages subscribed to new leads
subscribe_lead_pageSubscribe a page to new leads and backfill
unsubscribe_lead_pageUnsubscribe a page from new leads
search_knowledgeFind the saved passages that answer a question about the brand
list_knowledge_sourcesList knowledge sources and their sync status
create_knowledge_sourceSave an FAQ, a note, one of your pages, or a text file
update_knowledge_sourceEdit a source; changing its text re-indexes it
sync_knowledge_sourceRead a source again — a URL source is re-fetched
delete_knowledge_sourceDelete a source and its indexed passages
list_activityWhat happened in a workspace, newest first
list_audit_eventsThe security audit log: who changed access, and when
ToolWhat it does
-------------------------------------------------------------------------------------------------------
list_postsList posts in a workspace, filter by status
get_postFetch a post by id
schedule_postCreate a post for accounts or an account group, with local files
edit_postUpdate an existing post, optionally attaching local files
get_upload_limitsLargest file the account may upload, and the allowed types
cancel_postCancel a scheduled post
delete_postPermanently delete a post
list_post_deliveriesPer-account delivery status for a post
list_accountsList connected social accounts, optionally by group
get_account_healthCheck token freshness and rate-limit headroom
list_workspacesList workspaces the user can access
rename_accountSet or clear an account's display name
list_account_groupsList account groups and their members
get_account_groupFetch an account group
create_account_groupCreate an account group
rename_account_groupRename an account group
set_account_group_membersReplace the accounts in a group
delete_account_groupDelete a group (its accounts stay connected)
create_telegram_connect_codeMint a one-time code to connect a Telegram chat
get_telegram_connect_statusCheck whether a Telegram connect code was used
get_telegram_bot_commandsList the bot command menu in a Telegram chat
set_telegram_bot_commandsReplace the bot command menu in a Telegram chat
clear_telegram_bot_commandsClear the bot command menu in a Telegram chat
list_slack_channelsList the channels a Slack account can post to
list_slack_membersList members of a Slack workspace, for DMs
get_slack_identityShow the name and icon a Slack account posts under
set_slack_identitySet the name and icon a Slack account posts under
generate_captionAI-generate or improve a caption (1 credit)
rewrite_for_platformsRewrite content per target platform (1 credit each)
repurpose_urlTurn a blog URL into N platform-optimized posts (6 credits)
get_ai_creditsShow current AI credit balance
list_inboxList comments, mentions and DMs with filters
list_inbox_threadsList comment threads under your posts, or mentions
list_inbox_conversationsList DM conversations
get_inbox_unread_countCount unread inbox items
mark_inbox_thread_readMark a comment thread or DM conversation read
resolve_inboxResolve every unanswered item of one type
reply_to_inbox_itemReply on the platform, with media or quick replies on a DM
edit_inbox_commentEdit your own comment on the platform
update_inbox_itemSet an item to unread, read, resolved or snoozed
hide_inbox_itemHide a comment on the platform
unhide_inbox_itemUnhide a comment on the platform
delete_inbox_itemDelete a comment, or your own reply, on the platform
like_inbox_itemLike a comment or message on the platform
unlike_inbox_itemRemove your like
repost_inbox_itemRepost a post on X, where can_repost is true
unrepost_inbox_itemUndo your repost on X
bookmark_inbox_itemBookmark a post on X, where can_bookmark is true
unbookmark_inbox_itemRemove your bookmark on X
pin_inbox_itemPin your own comment
unpin_inbox_itemUnpin your own comment
react_to_inbox_itemReact to a DM, or remove your reaction
start_inbox_conversationSend a new DM, or answer a comment privately
set_inbox_typingShow or clear the typing indicator in a DM
list_inbox_approvalsList drafted replies waiting for approval
approve_inbox_replyApprove and send a drafted reply
reject_inbox_replyReject a drafted reply
refresh_inboxPoll every inbox-capable account now
list_adsList boosts and ads created through FoPost
list_external_adsList ads on connected ad accounts made elsewhere
list_boostable_postsList published posts that can be boosted
list_ad_sourcesList ad connections, ad accounts and pages
boost_postBoost a published post (starts paused, needs publish)
create_adCreate an ad (starts paused, needs publish)
set_ad_statusPause or resume an ad (needs publish)
refresh_adRe-read delivery status and insights
delete_adEnd delivery and delete an ad (needs publish)
list_audiencesList saved audiences and pixels on an ad account
search_ad_targetingSearch locations, interests, behaviors and income brackets
list_lead_formsList lead forms on connected pages
list_leadsList one page of leads from a lead form
get_ad_account_treeRead campaigns, ad sets and ads on an ad account
create_ad_campaignCreate a campaign (starts paused, needs publish)
get_ad_campaignRead one campaign
update_ad_campaignRename, pause or resume a campaign (needs publish)
delete_ad_campaignDelete a campaign and its contents (needs publish)
duplicate_ad_campaignCopy a campaign (starts paused, needs publish)
create_ad_setCreate an ad set (starts paused, needs publish)
get_ad_setRead one ad set
update_ad_setChange an ad set's status, budget or targeting (needs publish)
delete_ad_setDelete an ad set and its ads (needs publish)
duplicate_ad_setCopy an ad set (starts paused, needs publish)
create_network_adCreate an ad inside an ad set (starts paused, needs publish)
get_network_adRead one ad inside an ad set
update_network_adRename, pause, resume or swap an ad's creative (needs publish)
delete_network_adDelete an ad inside an ad set (needs publish)
duplicate_network_adCopy an ad (starts paused, needs publish)
bulk_set_ad_statusPause or resume up to 50 objects (needs publish)
list_ad_creativesList creatives on an ad account
create_ad_creativeCreate an image, video or carousel creative
get_ad_creativeRead one creative
delete_ad_creativeDelete a creative
get_audienceRead one saved audience
update_audienceRename or redescribe a saved audience
delete_audienceDelete a saved audience
add_audience_usersAdd customer emails to a custom audience
estimate_ad_reachEstimate the reach of a targeting
get_ad_object_insightsInsights for a campaign, ad set or ad
get_ad_insightsInsights for an ad created through FoPost
get_lead_formRead one lead form
archive_lead_formArchive a lead form
list_leads_feedList stored leads from subscribed pages
list_lead_pagesList pages subscribed to new leads
subscribe_lead_pageSubscribe a page to new leads and backfill
unsubscribe_lead_pageUnsubscribe a page from new leads
get_google_business_locationRead a Business Profile location
update_google_business_locationChange its name, description, website or phone
get_google_business_attributesRead its attributes, or what Google offers
update_google_business_attributesSet attributes on the location
get_google_business_menusRead its food menus
replace_google_business_menusReplace the whole menu set
get_google_business_servicesRead its service list
replace_google_business_servicesReplace the whole service list
list_google_business_mediaList the location's photos
add_google_business_mediaAdd a photo from the media library
delete_google_business_mediaRemove a photo
list_google_business_place_actionsList the Book, Order and Reserve buttons
create_google_business_place_actionAdd an action link to the listing
update_google_business_place_actionChange an action link
delete_google_business_place_actionRemove an action link
get_google_business_verificationList the ways it can be verified
start_google_business_verificationStart verifying the location
complete_google_business_verificationFinish it with the PIN Google sent
get_google_business_performanceDaily impressions, calls, clicks and search terms
list_blogsList the blogs on a connected WordPress site or Shopify store
list_articlesList the articles already on a blog, drafts included
get_articleRead one article on a connected site in full
create_articleWrite a new article to a blog on a connected site
update_articleChange a live article in place, never as a duplicate
delete_articleRemove an article from a connected site
list_productsList a connected store's products
update_productChange a product on a connected store
unpublish_postTake a published post down on every network (needs publish)
create_connect_sessionMint a hosted connect link for one of your end users
get_connect_sessionPoll a hosted connect link for the connected account
list_webhooksList webhooks with their events, state and failure count
create_webhookRegister an endpoint for workspace events (secret returned once)
update_webhookChange a webhook, rotate its secret, or re-enable it
delete_webhookDelete a webhook
test_webhookSend a test post.published payload to one webhook
list_webhook_deliveriesEvery delivery attempt to a webhook, newest first
get_webhook_deliveryOne delivery attempt, with the payload that was sent
redeliver_webhook_deliverySend a delivery again with the identical body
list_queue_slotsList the weekly posting slots of a workspace
create_queue_slotAdd a weekly posting slot
update_queue_slotChange a posting slot; moved posts come back in moved
delete_queue_slotRemove a posting slot; moved posts come back in moved
get_queue_nextThe time a post added to the queue now would get
preview_queueThe next free slot occurrences, in order
list_automationsList automations with trigger type, state and run count
get_automationRead one automation with its graph and steps
list_automation_versionsEvery saved version of an automation graph, newest first
get_automation_versionThe graph as it was saved at one version
restore_automation_versionSave an old version's graph as a new version on top

Claude Code plugin

This repo is also a Claude Code plugin. Installing it wires up FoPost's hosted MCP server at https://api.fopost.com/mcp: no API key to copy, no local process. It also adds the fopost skill and three skills for the flows people run every week.

claude plugin marketplace add fopost/fopost-mcp
claude plugin install fopost@fopost

Claude Code opens your browser to sign in the first time a tool runs. Pick the workspace the assistant works in; the connection stays locked to it.

SkillFires when you ask to
fopostPost, schedule, queue or cross-post; check accounts; read analytics
schedule-a-weekFill next week's calendar, draft a batch of posts, top up the queue
triage-the-inboxTriage or clear the inbox, draft replies, find what needs an answer
weekly-reportSummarise the week, recap performance, see what failed

The hosted server serves the same tools as the FoPost Agent, and anything that publishes, schedules or sends waits for your approval.

Prefer to run the server yourself? The stdio package below is the same product, driven by an API key.

ToolWhat it does
list_postsList posts in a workspace, filter by status
get_postFetch a post by id
schedule_postCreate a post for accounts or an account group
edit_postUpdate an existing post
get_upload_limitsLargest file the account may upload, and the allowed types
cancel_postCancel a scheduled post
delete_postPermanently delete a post
list_post_deliveriesPer-account delivery status for a post
list_accountsList connected social accounts, optionally by group
get_account_healthCheck token freshness and rate-limit headroom
list_workspacesList workspaces the user can access
rename_accountSet or clear an account's display name
list_account_groupsList account groups and their members
get_account_groupFetch an account group
create_account_groupCreate an account group
rename_account_groupRename an account group
set_account_group_membersReplace the accounts in a group
delete_account_groupDelete a group (its accounts stay connected)
create_telegram_connect_codeMint a one-time code to connect a Telegram chat
get_telegram_connect_statusCheck whether a Telegram connect code was used
get_telegram_bot_commandsList the bot command menu in a Telegram chat
set_telegram_bot_commandsReplace the bot command menu in a Telegram chat
clear_telegram_bot_commandsClear the bot command menu in a Telegram chat
list_slack_channelsList the channels a Slack account can post to
list_slack_membersList members of a Slack workspace, for DMs
get_slack_identityShow the name and icon a Slack account posts under
set_slack_identitySet the name and icon a Slack account posts under
list_pinterest_boardsList the boards a Pinterest account can pin to
create_pinterest_boardCreate a board on a Pinterest account
list_youtube_playlistsList a channel's playlists, with its default marked
create_youtube_playlistCreate a playlist on a YouTube channel
set_default_youtube_playlistSet the playlist new videos join by default
list_youtube_captionsList the caption tracks on a published video
upload_youtube_captionsUpload an SRT or WebVTT track to a published video
read_youtube_transcriptRead one caption track back as text
get_bluesky_languagesShow a Bluesky connection's default post languages
set_bluesky_languagesSet a Bluesky connection's default post languages
get_tiktok_creator_infoRead the switches TikTok enforces at publish time
search_tiktok_musicSearch TikTok's Commercial Music Library
search_tiktok_locationsSearch the places a TikTok post can be tagged with
lookup_tiktok_videoResolve a share link to one of the account's own videos
search_instagram_audioSearch the tracks a Reel can carry
get_instagram_publishing_limitPosts left before Instagram refuses the next one
list_instagram_storiesList the stories still inside their 24 hours
get_instagram_story_insightsRead the insight set for one live story
search_linkedin_mentionsFind the organizations a LinkedIn post can mention
follow_x_userFollow a user from a connected X account
unfollow_x_userUnfollow a user from a connected X account
get_x_postLook up one X post by id
search_x_postsSearch recent X posts, paged by next_token
generate_captionAI-generate or improve a caption (1 credit)
rewrite_for_platformsRewrite content per target platform (1 credit each)
repurpose_urlTurn a blog URL into N platform-optimized posts (6 credits)
get_ai_creditsShow current AI credit balance
list_inboxList comments, mentions and DMs with filters
list_inbox_threadsList comment threads under your posts, or mentions
list_inbox_conversationsList DM conversations
get_inbox_unread_countCount unread inbox items
mark_inbox_thread_readMark a comment thread or DM conversation read
resolve_inboxResolve every unanswered item of one type
reply_to_inbox_itemReply on the platform, with media or quick replies on a DM
edit_inbox_commentEdit your own comment on the platform
update_inbox_itemSet an item to unread, read, resolved or snoozed
hide_inbox_itemHide a comment on the platform
unhide_inbox_itemUnhide a comment on the platform
delete_inbox_itemDelete a comment, or your own reply, on the platform
like_inbox_itemLike a comment or message on the platform
unlike_inbox_itemRemove your like
repost_inbox_itemRepost a post on X, where can_repost is true
unrepost_inbox_itemUndo your repost on X
bookmark_inbox_itemBookmark a post on X, where can_bookmark is true
unbookmark_inbox_itemRemove your bookmark on X
pin_inbox_itemPin your own comment
unpin_inbox_itemUnpin your own comment
react_to_inbox_itemReact to a DM, or remove your reaction
start_inbox_conversationSend a new DM, or answer a comment privately
set_inbox_typingShow or clear the typing indicator in a DM
list_inbox_approvalsList drafted replies waiting for approval
approve_inbox_replyApprove and send a drafted reply
reject_inbox_replyReject a drafted reply
refresh_inboxPoll every inbox-capable account now
list_adsList boosts and ads created through FoPost
list_external_adsList ads on connected ad accounts made elsewhere
list_boostable_postsList published posts that can be boosted
list_ad_sourcesList ad connections, ad accounts and pages
boost_postBoost a published post (starts paused, needs publish)
create_adCreate an ad (starts paused, needs publish)
set_ad_statusPause or resume an ad (needs publish)
refresh_adRe-read delivery status and insights
delete_adEnd delivery and delete an ad (needs publish)
list_audiencesList saved audiences and pixels on an ad account
search_ad_targetingSearch locations, interests, behaviors and income brackets
list_lead_formsList lead forms on connected pages
list_leadsList one page of leads from a lead form
get_ad_account_treeRead campaigns, ad sets and ads on an ad account
create_ad_campaignCreate a campaign (starts paused, needs publish)
get_ad_campaignRead one campaign
update_ad_campaignRename, pause or resume a campaign (needs publish)
delete_ad_campaignDelete a campaign and its contents (needs publish)
duplicate_ad_campaignCopy a campaign (starts paused, needs publish)
create_ad_setCreate an ad set (starts paused, needs publish)
get_ad_setRead one ad set
update_ad_setChange an ad set's status, budget or targeting (needs publish)
delete_ad_setDelete an ad set and its ads (needs publish)
duplicate_ad_setCopy an ad set (starts paused, needs publish)
create_network_adCreate an ad inside an ad set (starts paused, needs publish)
get_network_adRead one ad inside an ad set
update_network_adRename, pause, resume or swap an ad's creative (needs publish)
delete_network_adDelete an ad inside an ad set (needs publish)
duplicate_network_adCopy an ad (starts paused, needs publish)
bulk_set_ad_statusPause or resume up to 50 objects (needs publish)
list_ad_creativesList creatives on an ad account
create_ad_creativeCreate an image, video or carousel creative
get_ad_creativeRead one creative
delete_ad_creativeDelete a creative
get_audienceRead one saved audience
update_audienceRename or redescribe a saved audience
delete_audienceDelete a saved audience
add_audience_usersAdd customer emails to a custom audience
estimate_ad_reachEstimate the reach of a targeting
get_ad_object_insightsInsights for a campaign, ad set or ad
get_ad_insightsInsights for an ad created through FoPost
get_lead_formRead one lead form
archive_lead_formArchive a lead form
list_leads_feedList stored leads from subscribed pages
list_lead_pagesList pages subscribed to new leads
subscribe_lead_pageSubscribe a page to new leads and backfill
unsubscribe_lead_pageUnsubscribe a page from new leads
list_ad_networksList the ad networks and what each one supports
add_audience_companiesAdd companies to a company-list audience
get_ad_bid_pricingQuote what an audience costs at auction
get_ad_supply_forecastForecast what a budget would deliver
list_conversion_rulesList the conversion rules on an ad account
create_conversion_ruleCreate a conversion rule
get_conversion_ruleRead one conversion rule
update_conversion_ruleChange a conversion rule
delete_conversion_ruleTurn a conversion rule off
set_conversion_rule_ad_setAttach or detach a conversion rule and an ad set
get_conversion_metricsRead what a conversion rule recorded
send_conversion_eventsSend off-site conversions back to the network
upload_ad_conversionsSend offline conversions against a pixel
list_conversion_eventsList the conversion batches sent to the network
list_pixelsList the pixels on an ad account
create_pixelCreate a pixel and get its install script
get_pixelRead one pixel
update_pixelRename a pixel or change its data-use setting
get_pixel_statsWhat a pixel fired over the last 28 days
get_event_match_qualityHow well each pixel event matches people
list_custom_conversionsList the custom conversions on an ad account
create_custom_conversionCreate a custom conversion on a pixel
delete_custom_conversionDelete a custom conversion
get_content_decayHow long a post keeps earning, by age band
get_posting_frequencyWhat each weekly posting cadence earned per post
get_post_timelineEvery metric reading held for one post, oldest first
get_analytics_changesReadings since a cursor, for mirroring metrics elsewhere
collect_post_analyticsRefresh one post's metrics now
list_native_postsPosts on an account that never went out through FoPost

Setup

1. Get an API key

Generate one at https://fopost.com/dashboard/api-keys with the scopes you need (posts, publish, accounts, workspaces are most common; publish is required to publish, retry or cancel a post). Inbox tools need inbox, and liking, pinning, reacting, editing, starting a conversation, the typing indicator, reply media and quick replies, and deleting your own reply also need publish; ads tools need ads, and boost_post, create_ad, set_ad_status, delete_ad, bulk_set_ad_status and every create, update, delete and duplicate tool for campaigns, ad sets and network ads also need publish. A boost, ad, campaign, ad set or copy starts paused unless paused is false. The analytics tools need analytics; collect_post_analytics needs posts too, and list_native_posts needs accounts. Blog tools read with posts, and create_article, update_article, delete_article and update_product also need publish, because a change there is visible to the site's own readers.

2. Add to your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "fopost": {
      "command": "npx",
      "args": ["-y", "@fopost/mcp"],
      "env": {
        "FOPOST_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Continue / Other

Use the same npx -y @fopost/mcp command with FOPOST_API_KEY in the environment.

Configuration

VariableRequiredDefault
FOPOST_API_KEYyesrequired
FOPOST_API_URLnohttps://api.fopost.com

Self-hosted? Point FOPOST_API_URL at your instance. It must be a bare https:// host; plain http:// is accepted for localhost and 127.0.0.1 only, so the key never crosses a network in clear text.

Security

  • Use the narrowest key you can. Create a key bound to one workspace with only the scopes your workflow needs; scopes are enforced by the API, and this server never widens them.
  • Destructive tools are annotated. Every tool carries MCP readOnlyHint / destructiveHint annotations. Leave your client's confirmation prompt on for destructive tools (deletes, publishing, replies, ad spend, webhooks): content the server reads back, such as inbox messages, can contain instructions written by someone else.
  • Bursts are capped. More than 30 destructive calls in a minute are refused until the window clears, so a looping agent stops and asks.
  • file_paths reads local files with the permissions of the MCP process. Only image and video extensions are accepted, judged after following symlinks.

The threat model is in docs/security/threat-model.md.

Slash commands

The server ships ready-made prompts that MCP clients show as slash commands. Pick one, fill in the blanks, and the assistant does the rest. Nothing is published, sent or switched on until you approve it in the conversation.

CommandWhat it doesArguments
draft-postOne idea, shaped into a post for each networkidea, networks
schedule-weekPlan a week of posts in your posting slotsfocus, week
repurposeTurn an article, video or link into posts for every networksource, networks
launch-featureA launch pack: posts per network, an image and a video scriptfeature, link, audience
create-workflowDescribe an automation in plain words, built switched offdescription
triage-inboxSort unread comments and DMs, draft the repliesscope
weekly-reportWhat published, how it did, what failed, what to do nextperiod
check-accountsWhich accounts are healthy and which need reconnectingnone

In Claude Code they appear as /mcp__fopost__draft-post and so on (the middle part is the name you gave the server). The hosted server serves the same commands.

Example prompts

"List my failed posts from this week and tell me which accounts are unhealthy."

"Take this URL and turn it into a Twitter thread, a LinkedIn post, and a dev.to summary: https://example.com/blog/post"

"How many AI credits do I have left this period?"

"How long do my posts keep earning, and what cadence gets the most per post?"

"Show me the metric readings for this post over time: https://x.com/acme/status/1"

Contributing

Issues and pull requests are welcome at fopost/fopost-mcp.

npm install
npm run lint     # tsc --noEmit
npm run build    # tsup -> dist/

License

MIT

Google Ads

The shared ads tools work across networks. What only Google has is its own set: list_google_recommendations, get_google_optimization_score, apply_google_recommendations, dismiss_google_recommendations, list_google_keywords, create_google_keyword, set_google_keyword_status, delete_google_keyword, google_keyword_ideas, list_google_search_terms, list_google_negative_keywords, list_google_assets, create_google_asset, list_google_asset_groups, list_google_local_services_leads, list_google_conversion_actions, and run_google_ads_query for a raw read-only GAQL SELECT.

Each names connection_id and customer_id; the customer has to be an account the connection's grant reaches. Changes need the publish scope as well as ads. Applying a recommendation changes what the live account serves or bids straight away; dismissing one only hides it.