← Registry

Social Media

runsocial.ai

MCP server for managing social media projects, brand voice, strategy, and onboarding workflows.

1 endpoint131 known toolsFirst detected September 18, 2026Last detected September 18, 2026

ENDPOINT 1

https://runsocial.ai/api/mcp

No auth detected

MCP server metadata

Name
runsocial-operator
Version
0.1.0
Capabilities
tools.listChanged

Known tools 131

list_projects

List the projects (sites) you operate.

Inferred read-only
create_project

Create a new project (inserts the site + bootstraps its brand voice).

Potential side effects
get_context

Read a project's brief: brand voice, channels, and current guardrails (autonomy, dry-run).

Inferred read-only
next_step

THE onboarding/run conductor — call it in a loop and you never need to know any other tool.

Inferred read-only
get_strategy

The social media manager's first call.

Inferred read-only
set_strategy

Record strategy answers.

Inferred read-only
list_content_ideas

Deterministic content ideas filled with this brand's niche, rotated across categories (storytelling / how-to / tips / authority).

Inferred read-only
pipeline_readiness

FREE.

Inferred read-only
list_gates

Every pipeline run of this project currently SUSPENDED at a checkpoint, waiting for a decision.

Inferred read-only
get_gate

One gate in full: status, evidence, price, and (once decided) who decided it through which door and why.

Inferred read-only
approve_gate

Decide one pending gate.

Inferred read-only
edit_gate

Change 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-only
set_brand_voice

Fill/update the brand voice.

Potential side effects
set_sources

Configure where content comes from: the site's RSS/sitemap URL and the own-vs-trending mix.

Inferred read-only
set_launch_profile

Fill the product profile used to submit to directories (Product Hunt etc.).

Inferred read-only
set_guardrails

Turn the agent on/off (autonomous) and choose review-before-publishing (true = you approve each post; false = auto-publish).

Potential side effects
set_ga4_property

Set the numeric GA4 Property ID so per-post stats (sessions/conversions) can be measured.

Potential side effects
set_engagement_ratio

Set what % of a channel's posts are no-link ENGAGEMENT posts (takes/questions/commentary) vs link-share posts.

Inferred read-only
set_channel

Enable or disable a connected channel and set its weekly post cadence.

Potential side effects
generate_draft

Generate one social post in the account's brand voice.

Potential side effects
promote_link

Draft one link-share post per connected channel for a SPECIFIC promotable link, immediately — for launches ('we're live on Product Hunt').

Potential side effects
promote_url

Paste 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 effects
connect_farcaster

Connect 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-only
farcaster_status

Whether this project has Farcaster connected (fid, hub, default channel).

Inferred read-only
disconnect_farcaster

Forget the stored Farcaster app key.

Inferred read-only
run_agent_now

Trigger one full cycle (ingest -> generate -> publish/amplify), honoring the account's autonomy + dry-run guardrails.

Potential side effects
list_queue

List recent generated posts.

Inferred read-only
get_recent_activity

Returns 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 effects
get_setup_status

Returns each setup step with done + required flags + how-to instructions, plus `nextStep` (first undone REQUIRED step) and `ready`.

Inferred read-only
connect_buffer

Store the project's Buffer personal API key (encrypted) and pull its connected channels in one call.

Inferred read-only
sync_channels

Pull connected social accounts from the project's Buffer and register any new ones (disabled by default).

Inferred read-only
upload_image

Add 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-only
upload_video

Add 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-only
generate_images

Bulk-generate on-brand images or banners with AI (FAL) and store them in the asset library so they get attached to posts.

Inferred read-only
make_promo_reel

Queue a vertical promo reel.

Inferred read-only
preview_reel

Preview 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-only
make_carousel

Queue a swipe-through PROMO CAROUSEL for the account, in one of TWO deck shapes (see `deck`).

Inferred read-only
make_motion_promo

Take 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-only
list_motion_promos

The 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 effects
design_mascot

Generate 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-only
start_promo

Start the GATE-NATIVE promo-video pipeline: intake check → site research → an LLM-written scene-by-scene storyboard (hook → problem → product → proof → CTA).

Inferred read-only
set_bricks_default

Record 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 effects
get_bricks_default

This project's default five bricks, plus a plain-language 'what you'll get' preview of them.

Inferred read-only
set_avatar_mode

Choose 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-only
set_effect_style

Pick 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-only
set_youtube_channel

Link 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-only
set_reel_experiments

Have 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-only
get_reel_experiments

The 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-only
set_sfx_theme

Pick 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-only
list_music

See 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-only
set_reel_music

Choose 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-only
find_questions

DISTRIBUTION: scan Reddit and Quora for REAL questions this project could answer, and draft a genuinely-helpful reply for each.

Inferred read-only
configure_reddit_karma

DISTRIBUTION: configure genuine, PACED commenting that builds a Reddit account's karma/standing so it can eventually post in gated communities.

Potential side effects
run_reddit_karma

Run ONE paced tick of the Reddit karma builder immediately (e.g.

Inferred read-only
get_leaderboard

Read 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-only
set_leaderboard_optin

Turn THIS project's participation on the public leaderboard on or off — the agent controls it, no human login.

Inferred read-only
set_intro_hook

Pick 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-only
add_reel_publication

AFTER posting a finished reel somewhere yourself (or for the user), register the live URL here — once per platform per reel.

Inferred read-only
list_reel_publications

Where this project's reels were posted (registered live URLs) with their refreshed platform counts (views/likes/comments) and per-project totals.

Inferred read-only
list_visual_styles

The looks generated images can be rendered in, each with what it suits.

Inferred read-only
set_visual_style

Pick the look generated images are rendered in.

Inferred read-only
list_agent_roles

The agency org chart: each role, what it is for, and how many tools it can call.

Inferred read-only
hire_agent

Create a scoped credential for one specialist.

Potential side effects
list_agents

Live agent credentials for this workspace, with when each was last used.

Inferred read-only
fire_agent

Immediately revoke one agent's token.

Inferred read-only
plan_launch

The 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-only
list_tasks

Every task the CEO has assigned, with its role, status and the specialist's reported result.

Inferred read-only
claim_task

A specialist claims the oldest task addressed to ITS OWN role — you cannot take another agent's work.

Inferred read-only
complete_task

Close a task you claimed.

Inferred read-only
make_longform_video

Turn 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-only
list_longform_videos

This project's long-form renders.

Inferred read-only
get_conversation

Everything sent to a contact and everything they said back, interleaved into one timeline.

Inferred read-only
reply_to_contact

Send a reply to someone who has already emailed this project.

Potential side effects
list_contacts

Everyone this project has emailed or heard from, assembled across campaigns, suppression state and inbound messages.

Inferred read-only
content_studio

Reads 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-only
find_winning_videos

Searches 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 effects
rewrite_winning_video

Takes 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-only
hook_taxonomy

Tags 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-only
connect_bundle

Bundle.social is the multi-account posting backend.

Inferred read-only
sync_bundle_channels

Turns the Bundle team's connected social accounts into channels.

Inferred read-only
make_variants

Fleet 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 effects
prepare_production_batch

One 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-only
list_production_batches

This project's production batches, newest first, with status.

Inferred read-only
get_production_batch

The batch's items: hook, angle, script, thumbnail, source citation, and which builder turns each into media.

Inferred read-only
discover_companies

Firecrawl-research PUBLIC business directories and web search for companies matching a profile (icp).

Inferred read-only
list_company_prospects

The companies discover_companies has stored for this project, newest first.

Inferred read-only
list_videos

Every 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-only
create_edit_job

Apply 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 effects
get_edit_job

Status, output_url (when done) and failure reason for one edit job.

Potential side effects
list_edit_jobs

All edit jobs newest-first with status and output URLs.

Potential side effects
create_clip_job

Submit a long video (podcast, gaming session, talk) and Auto Clip transcribes it, scores the most clippable moments, and cuts them to vertical.

Inferred read-only
list_clip_jobs

This 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-only
list_clips

The 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-only
set_clip_approved

Mark a candidate clip as kept (approved=true) or dropped (approved=false).

Inferred read-only
publish_clips

Turn 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-only
list_outreach_campaigns

This 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-only
create_outreach_campaign

Create a cold-email campaign.

Potential side effects
add_outreach_leads

Add prospects to a campaign.

Inferred read-only
pause_outreach_campaign

Stop a campaign sending, immediately.

Inferred read-only
optimization_brief

Call 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 effects
record_learning

Record 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 effects
list_learnings

The recorded validated learnings (the playbook).

Inferred read-only
retire_learning

Retire a learning by id (from list_learnings) so it stops steering generation — use when newer data contradicts it or it stopped mattering.

Inferred read-only
set_image_mode

Set 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 effects
set_account_style

Set 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 effects
suggest_sources

Propose niche sources for human posts — subreddits + news keywords inferred from the project's website.

Inferred read-only
add_source

Add one content source the project ingests from.

Inferred read-only
add_promotable_link

Add one promotable link the agent can share on posts.

Inferred read-only
list_promotable_links

List the project's promotable links with their detected per-platform destinations and homepage fallback.

Inferred read-only
delete_promotable_link

Delete a promotable link by its id (from list_promotable_links).

Potential side effects
leaderboard_standings

Live standings for the current stake-and-pool period: who is winning, on how many VERIFIED clicks, and how big the pool is.

Inferred read-only
leaderboard_balance

How many service credits you hold.

Inferred read-only
leaderboard_enter

Enter the open period by staking service credits on a reel you made.

Inferred read-only
set_fal_key

Store the project's FAL API key (encrypted) to enable image mode 'generate' (AI-generated on-brand images).

Inferred read-only
create_upload_link

Mint 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 effects
asset_setup_status

READ 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-only
check_signup_providers

Cheap smoke-test of the autonomous-signup providers — confirms each configured key works (SMSPool / GrizzlySMS / CapSolver balance reads + an AgentMail inbox provision).

Inferred read-only
start_signup

Queue an autonomous account creation.

Inferred read-only
get_signup_status

Poll a start_signup job by id.

Inferred read-only
approve_post

Approve a generated post by id and publish it live (held posts go to Buffer via shareNow).

Potential side effects
reject_post

Reject (delete) a generated post by id.

Potential side effects
top_results

GA4 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 effects
list_launch_targets

Directories this account can be submitted to, with each one's current state.

Inferred read-only
start_directory_submissions

Start a background run submitting the product listing to directories.

Inferred read-only
get_submission_run

Per-directory states + screenshot URLs for a run.

Inferred read-only
review_submission

Approve (queue to submit) or reject a high-authority submission awaiting review.

Inferred read-only
list_handoffs

Directories that need a human (CAPTCHA/login/paid) for a run.

Inferred read-only
get_listing_draft

Composed, 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 effects
generate_listing_drafts

Generate the community posts (Reddit/Show-HN) for the account; directory drafts compose automatically from the launch profile.

Inferred read-only
list_reddit_replies

Read the project's unread Reddit inbox: post replies, comment replies, DMs, and modmail.

Potential side effects
reply_to_reddit

Post an approved reply to a Reddit message (post reply, comment reply, DM, or modmail) by its id.

Potential side effects

CONNECT 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.

Indexed

Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.