Social Media
runsocial.ai
MCP server for managing social media projects, brand voice, strategy, and onboarding workflows.
ENDPOINT 1
https://runsocial.ai/api/mcp
MCP server metadata
- Name
- runsocial-operator
- Version
- 0.1.0
Known tools 131
create_projectCreate a new project (inserts the site + bootstraps its brand voice).
Potential side effectsget_contextRead a project's brief: brand voice, channels, and current guardrails (autonomy, dry-run).
Inferred read-onlynext_stepTHE onboarding/run conductor — call it in a loop and you never need to know any other tool.
Inferred read-onlylist_content_ideasDeterministic content ideas filled with this brand's niche, rotated across categories (storytelling / how-to / tips / authority).
Inferred read-onlylist_gatesEvery pipeline run of this project currently SUSPENDED at a checkpoint, waiting for a decision.
Inferred read-onlyget_gateOne gate in full: status, evidence, price, and (once decided) who decided it through which door and why.
Inferred read-onlyedit_gateChange the words on a pending STORYBOARD gate (visual, voiceover, screenText per scene) or VOICE gate (on-screen lines, spoken lines) without deciding it yet.
Inferred read-onlyset_sourcesConfigure where content comes from: the site's RSS/sitemap URL and the own-vs-trending mix.
Inferred read-onlyset_launch_profileFill the product profile used to submit to directories (Product Hunt etc.).
Inferred read-onlyset_guardrailsTurn the agent on/off (autonomous) and choose review-before-publishing (true = you approve each post; false = auto-publish).
Potential side effectsset_ga4_propertySet the numeric GA4 Property ID so per-post stats (sessions/conversions) can be measured.
Potential side effectsset_engagement_ratioSet what % of a channel's posts are no-link ENGAGEMENT posts (takes/questions/commentary) vs link-share posts.
Inferred read-onlyset_channelEnable or disable a connected channel and set its weekly post cadence.
Potential side effectspromote_linkDraft one link-share post per connected channel for a SPECIFIC promotable link, immediately — for launches ('we're live on Product Hunt').
Potential side effectspromote_urlPaste ONE blog-post URL: fetches the article, writes a facts-only AI summary, saves it as a promotable link (smart redirect + tracking), and drafts one post per connected channel from that summary.
Potential side effectsconnect_farcasterConnect the project's Farcaster account for direct-protocol auto-posting: pass the FID and the ed25519 app-key private key (created/approved in Warpcast).
Inferred read-onlyfarcaster_statusWhether this project has Farcaster connected (fid, hub, default channel).
Inferred read-onlyrun_agent_nowTrigger one full cycle (ingest -> generate -> publish/amplify), honoring the account's autonomy + dry-run guardrails.
Potential side effectsget_recent_activityReturns recent publish_log entries — the per-channel outcomes of the last run(s): action (ingest | generate | publish | skip | error), result (ok | fail), and detail (the human-readable reason, e.g.
Potential side effectsget_setup_statusReturns each setup step with done + required flags + how-to instructions, plus `nextStep` (first undone REQUIRED step) and `ready`.
Inferred read-onlyconnect_bufferStore the project's Buffer personal API key (encrypted) and pull its connected channels in one call.
Inferred read-onlysync_channelsPull connected social accounts from the project's Buffer and register any new ones (disabled by default).
Inferred read-onlyupload_imageAdd an image the agent provides — base64 bytes (data) OR a public image URL — to the project's asset library, so it gets ATTACHED to posts when image mode is 'attach'.
Inferred read-onlyupload_videoAdd a video the agent provides — base64 bytes (data) OR a public video URL — to the project's asset library (kind 'video'), for UGC/testimonial assets.
Inferred read-onlygenerate_imagesBulk-generate on-brand images or banners with AI (FAL) and store them in the asset library so they get attached to posts.
Inferred read-onlypreview_reelPreview a faceless reel before rendering it: the words that will be spoken (written now when you pass none; pass them back as narration to make_promo_reel so the render matches), the beats, the scene plan (headline card, footage, stat card, closing ask), the look, and a length estimate.
Inferred read-onlymake_carouselQueue a swipe-through PROMO CAROUSEL for the account, in one of TWO deck shapes (see `deck`).
Inferred read-onlymake_motion_promoTake a promo video this project ALREADY made and re-render its approved storyboard as a designed motion graphic: animated typography, a marker underline on the key word, and stat beats where a number rolls up on an odometer.
Inferred read-onlylist_motion_promosThe project's motion-graphic promos, newest first: id, status, the shot list in words, the finished video URL once rendered, and durationSec — the video's length, so an edit can place a trim without guessing at the range.
Potential side effectsdesign_mascotGenerate a three-pose model sheet for a recurring brand character and save it as this project's mascot, which every image generator then uses as a reference.
Inferred read-onlystart_promoStart the GATE-NATIVE promo-video pipeline: intake check → site research → an LLM-written scene-by-scene storyboard (hook → problem → product → proof → CTA).
Inferred read-onlyset_bricks_defaultRecord this project's default five bricks: format (the story shape), idea (brief/sourceUrl/topic), hook ('auto' or a pinned intro hook id), script (the CTA and whether money is mentioned), look (the edit: captions, cuts, music, b-roll source).
Potential side effectsget_bricks_defaultThis project's default five bricks, plus a plain-language 'what you'll get' preview of them.
Inferred read-onlyset_avatar_modeChoose how this project's UGC reel avatar (the on-camera 'person') is made: 'auto' (mint a unique synthetic avatar from the brand voice, default), 'custom' (mint from your own `description` of the look), or 'pin' (reuse an existing avatar by pointing `pinnedSiteId` at another of your projects — share ONE 'person' across projects).
Inferred read-onlyset_effect_stylePick which named STYLE SET the project's reels draw their effects from: 'hybrid' (everything — a fresh seeded mix of caption animations + b-roll text styles per reel, default), 'clean' (subtle, editorial captions), 'hype' (kinetic slams, glitch, neon energy), or 'dev' (code-flavored, typewriter feel).
Inferred read-onlyset_youtube_channelLink the YouTube channel this project publishes to, so a reel that goes live records its own watch URL and its views attribute back to the reel that earned them.
Inferred read-onlyset_reel_experimentsHave the project test its reel settings on its own audience: up to perDay faceless test reels a day (0 = off, max 48), spaced evenly through the day (24 a day is one an hour).
Inferred read-onlyget_reel_experimentsThe project's reel settings experiment: for each format, look and closing ask, how many reels used it, how many are old enough to judge, their summed views, likes and comments, a score, and whether the setting is leading, kept, still testing or retired.
Inferred read-onlyset_sfx_themePick which named SET of transition SOUND EFFECTS the project's reels play on their cuts: 'studio' (the classic riser under the hook, reveal as b-roll blooms in, and whoosh on the cut back — default), 'punchy' (core hit + vine-boom), 'cinematic' (violin screech + bell), 'hype' (fahh riser + boom energy), or 'silent' (no transition sounds at all).
Inferred read-onlylist_musicSee every music BED this project can put under its reels — the shared public-domain library plus anything uploaded to this project — and what the project is currently set to.
Inferred read-onlyset_reel_musicChoose the music BED under this project's faceless reels and promo videos: 'none' (narration only — the default), 'auto' (rotate the library, keeping the same bed for a given reel across re-renders), or 'track' with a trackId from list_music.
Inferred read-onlyfind_questionsDISTRIBUTION: scan Reddit and Quora for REAL questions this project could answer, and draft a genuinely-helpful reply for each.
Inferred read-onlyconfigure_reddit_karmaDISTRIBUTION: configure genuine, PACED commenting that builds a Reddit account's karma/standing so it can eventually post in gated communities.
Potential side effectsget_leaderboardRead the public ratings leaderboard — projects ranked by auto-tracked, bot-filtered tracked-link CLICKS over the last 28 days (the signal an agent generates by publishing content with tracked links; views are excluded because they need a human to paste live URLs).
Inferred read-onlyset_leaderboard_optinTurn THIS project's participation on the public leaderboard on or off — the agent controls it, no human login.
Inferred read-onlyset_intro_hookPick the OPENER every future reel's script is built around, so you can A/B-test which hook wins (the analytics panel attributes views per hook).
Inferred read-onlyadd_reel_publicationAFTER posting a finished reel somewhere yourself (or for the user), register the live URL here — once per platform per reel.
Inferred read-onlylist_reel_publicationsWhere this project's reels were posted (registered live URLs) with their refreshed platform counts (views/likes/comments) and per-project totals.
Inferred read-onlylist_visual_stylesThe looks generated images can be rendered in, each with what it suits.
Inferred read-onlylist_agent_rolesThe agency org chart: each role, what it is for, and how many tools it can call.
Inferred read-onlylist_agentsLive agent credentials for this workspace, with when each was last used.
Inferred read-onlyplan_launchThe CEO agent reads what is already in flight, decides what is next, and assigns it to the specialists who can actually do it.
Inferred read-onlylist_tasksEvery task the CEO has assigned, with its role, status and the specialist's reported result.
Inferred read-onlyclaim_taskA specialist claims the oldest task addressed to ITS OWN role — you cannot take another agent's work.
Inferred read-onlymake_longform_videoTurn a written script into a 16:9 YouTube video: the script is narrated, the project's b-roll is cut against it on a rhythm, captions are burned in, and chapters are generated from any markdown headings.
Inferred read-onlyget_conversationEverything sent to a contact and everything they said back, interleaved into one timeline.
Inferred read-onlylist_contactsEveryone this project has emailed or heard from, assembled across campaigns, suppression state and inbound messages.
Inferred read-onlycontent_studioReads what this project's audience is asking publicly and what its sources published, then proposes content ideas — every one citing the exact source it came from, and every number in it checked against that source.
Inferred read-onlyfind_winning_videosSearches YouTube for the videos performing best in the project's niche (for a help desk: other help desk software, AI chatbot software) and ranks them by views per day since publish, one per channel, the project's own channel excluded.
Potential side effectsrewrite_winning_videoTakes a video that performed in the niche and writes a NEW script for this product that keeps its shape (the kind of opening, the order of the beats, where the proof lands, how it closes) and none of its words: every claim is about this product, and a draft that repeats eight consecutive words of the source is rewritten once and then flagged.
Inferred read-onlyhook_taxonomyTags every hook this project has published by style (question, before-after, numbered list, contrarian, mistake/warning, stat-first, how-to, personal story, bare tease) and reports which style actually holds viewers HERE, with the sample size behind each claim.
Inferred read-onlysync_bundle_channelsTurns the Bundle team's connected social accounts into channels.
Inferred read-onlymake_variantsFleet posting: turns ONE rendered video into N genuinely different edits (small speed changes, head/tail trims, optional reframe and captions) queued as edit jobs.
Potential side effectsprepare_production_batchOne call runs the whole prep pipeline: researches the topic (your sources + audience questions + Firecrawl web pages) → generates CITED ideas (every idea traceable to a research item, numeric claims checked) → writes a script per idea → generates a style-aware thumbnail per idea → stores the batch marked ready.
Inferred read-onlylist_production_batchesThis project's production batches, newest first, with status.
Inferred read-onlyget_production_batchThe batch's items: hook, angle, script, thumbnail, source citation, and which builder turns each into media.
Inferred read-onlydiscover_companiesFirecrawl-research PUBLIC business directories and web search for companies matching a profile (icp).
Inferred read-onlylist_company_prospectsThe companies discover_companies has stored for this project, newest first.
Inferred read-onlylist_videosEvery video this project has finished, from every pipeline (reels, promos, long-form, clips, earlier edits), newest first, with the CDN url create_edit_job takes as sourceUrl.
Inferred read-onlycreate_edit_jobApply edit operations to a video this project rendered (its URL must be on the project's CDN — find one via list_clips, list_reel_publications, or a done edit job).
Potential side effectsget_edit_jobStatus, output_url (when done) and failure reason for one edit job.
Potential side effectscreate_clip_jobSubmit a long video (podcast, gaming session, talk) and Auto Clip transcribes it, scores the most clippable moments, and cuts them to vertical.
Inferred read-onlylist_clip_jobsThis project's clip jobs with a plain-language status, plus the reframe strategy chosen for each and WHY it was chosen (e.g.
Inferred read-onlylist_clipsThe candidate clips from one job, each with its timestamps, score, the transcript of what is said in it, and whyChosen — the scorer's own reasons.
Inferred read-onlyset_clip_approvedMark a candidate clip as kept (approved=true) or dropped (approved=false).
Inferred read-onlypublish_clipsTurn every KEPT clip in a job into draft posts — one per connected channel, each with its own platform-tailored caption and the clip attached as video.
Inferred read-onlylist_outreach_campaignsThis project's cold-outreach campaigns with their lead/queued/sent/suppressed counts, whether their claims have been verified, and — importantly — `blockers`: every reason a campaign is not sending, in plain language.
Inferred read-onlyoptimization_briefCall this at the START of every optimization session — one read with everything needed to improve the account's content: insights (hooks/style sets/post modes/platforms that measurably work), topPosts (by tracked clicks + GA4 sessions), reelPublications (registered live URLs + view counts), learnings (the active playbook), fewshotWinners (copy already feeding generation), and suggestions — deterministic, data-derived next moves naming the exact tool to use (set_effect_style, add_reel_publication, record_learning, …).
Potential side effectsrecord_learningRecord a data-VALIDATED insight about what content works for this account — it is injected into every future post + reel-script prompt and steers generation.
Potential side effectsretire_learningRetire a learning by id (from list_learnings) so it stops steering generation — use when newer data contradicts it or it stopped mattering.
Inferred read-onlyset_image_modeSet the project's image mode: 'off' (no images), 'attach' (use images uploaded via upload_image), 'generate' (AI-generate on-brand images via FAL — needs set_fal_key first), or 'branded' (FREE composited brand image per post: stock photo or brand-color card + mascot + promo headline + logo — no key needed).
Potential side effectsset_account_styleSet the project's post mix — how often posts are human posts (reads like a real person in the niche), conversation starters, or promotional.
Potential side effectssuggest_sourcesPropose niche sources for human posts — subreddits + news keywords inferred from the project's website.
Inferred read-onlylist_promotable_linksList the project's promotable links with their detected per-platform destinations and homepage fallback.
Inferred read-onlydelete_promotable_linkDelete a promotable link by its id (from list_promotable_links).
Potential side effectsleaderboard_standingsLive standings for the current stake-and-pool period: who is winning, on how many VERIFIED clicks, and how big the pool is.
Inferred read-onlyleaderboard_enterEnter the open period by staking service credits on a reel you made.
Inferred read-onlyset_fal_keyStore the project's FAL API key (encrypted) to enable image mode 'generate' (AI-generated on-brand images).
Inferred read-onlycreate_upload_linkMint a signed, short-lived link a human can open in a browser to drag-drop images + video straight into the project's asset library.
Potential side effectsasset_setup_statusREAD the project's image-door state: current imageMode (off/attach/generate), whether a FAL key is set (falKeySet), whether image storage is configured (storageReady), which brand-asset roles exist + the next role to ask the user for.
Inferred read-onlycheck_signup_providersCheap smoke-test of the autonomous-signup providers — confirms each configured key works (SMSPool / GrizzlySMS / CapSolver balance reads + an AgentMail inbox provision).
Inferred read-onlyapprove_postApprove a generated post by id and publish it live (held posts go to Buffer via shareNow).
Potential side effectstop_resultsGA4 sessions + conversions for the account's top posts (empty until analytics is connected), plus a content-insights object (hooks/style sets/post modes that work — zero-valued until measured, attributed data exists; null if insights can't be computed).
Potential side effectslist_launch_targetsDirectories this account can be submitted to, with each one's current state.
Inferred read-onlystart_directory_submissionsStart a background run submitting the product listing to directories.
Inferred read-onlyreview_submissionApprove (queue to submit) or reject a high-authority submission awaiting review.
Inferred read-onlyget_listing_draftComposed, paste-ready listing content for one directory/community target (name, taglines, descriptions, category, pricing, URL, bio, and the community post for Reddit/Show-HN).
Potential side effectsgenerate_listing_draftsGenerate the community posts (Reddit/Show-HN) for the account; directory drafts compose automatically from the launch profile.
Inferred read-onlylist_reddit_repliesRead the project's unread Reddit inbox: post replies, comment replies, DMs, and modmail.
Potential side effectsreply_to_redditPost an approved reply to a Reddit message (post reply, comment reply, DM, or modmail) by its id.
Potential side effectsCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.runsocial-operator]
url = "https://runsocial.ai/api/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"runsocial-operator": {
"type": "http",
"url": "https://runsocial.ai/api/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: runsocial-operator
Remote MCP URL: https://runsocial.ai/api/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"runsocial-operator": {
"url": "https://runsocial.ai/api/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"runsocial-operator": {
"type": "http",
"url": "https://runsocial.ai/api/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "runsocial-operator",
"transport": "streamable-http",
"url": "https://runsocial.ai/api/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.