Connection check
local install
socialneuron-mcp-server
52 MCP tools for AI social media: create, distribute, analyze, and optimize content.
Tools
91
GitHub stars
—
Installs / wk
1k
Licence
—
Transport
stdio
Last checked
never
Tools & capabilities
91 toolsRead from the published package source — this server runs locally, so there is no endpoint to query. Names are taken from the code, not observed at runtime, and descriptions are often absent.
adapt_content
from source
Rewrite existing content for a different platform \u2014 adjusts character limits, hashtag style, tone, and CTA format automatically. Use after generate_content when you need the s… Rewrite existing content for a different platform \u2014 adjusts character limits, hashtag style, tone, and CTA format automatically. Use after generate_content when you need the same message across multiple platforms. Pass project_id to apply platform-specific voice overrides from your brand profile.
audit_brand_colors
from source
Audit content colors against the brand palette using perceptual color distance (Delta E 2000). Returns per-color compliance scores and identifies the closest brand color for each i… Audit content colors against the brand palette using perceptual color distance (Delta E 2000). Returns per-color compliance scores and identifies the closest brand color for each input.
auto_approve_plan
from source
Batch auto-approve posts in a content plan that meet quality thresholds. Posts below the threshold are flagged for manual review. Batch auto-approve posts in a content plan that meet quality thresholds. Posts below the threshold are flagged for manual review.
cancel_async_job
from source
Cancel an owned pending async generation/render job before a worker starts it. If credits were already debited, the backend attempts an idempotent refund and reports the result. Pr… Cancel an owned pending async generation/render job before a worker starts it. If credits were already debited, the backend attempts an idempotent refund and reports the result. Processing or terminal jobs are not cancellable.
cancel_scheduled_post
from source
Cancel an owned draft, pending, or scheduled post before publishing starts. This closes its pending schedule job first; it refuses once a worker has claimed the publication. Cancel an owned draft, pending, or scheduled post before publishing starts. This closes its pending schedule job first; it refuses once a worker has claimed the publication.
capture_app_page
from source
Navigate to a Social Neuron app page and take a full-page screenshot. Logs in with test credentials, navigates to the specified page, waits for content to load, then captures a scr… Navigate to a Social Neuron app page and take a full-page screenshot. Logs in with test credentials, navigates to the specified page, waits for content to load, then captures a screenshot. Output is saved to public/assets/screenshots/.
capture_screenshot
from source
Take a screenshot of any URL. Launches a headless Chromium browser, navigates to the URL, and captures either the full page or a specific CSS selector. No login is performed. Take a screenshot of any URL. Launches a headless Chromium browser, navigates to the URL, and captures either the full page or a specific CSS selector. No login is performed.
check_brand_consistency
from source
Check if content text is consistent with the brand voice, vocabulary, messaging, and factual claims. Returns per-dimension scores (0-100) and specific issues found. Use this to val… Check if content text is consistent with the brand voice, vocabulary, messaging, and factual claims. Returns per-dimension scores (0-100) and specific issues found. Use this to validate scripts, captions, or post copy before publishing.
check_pipeline_readiness
from source
Pre-flight check before run_content_pipeline. Verifies: sufficient credits for estimated_posts, active OAuth on target platforms, brand profile exists, no stale insights. Returns p… Pre-flight check before run_content_pipeline. Verifies: sufficient credits for estimated_posts, active OAuth on target platforms, brand profile exists, no stale insights. Returns pass/fail with specific issues to fix before running the pipeline.
check_status
from source
Poll an async job started by generate_video or generate_image. Returns status (queued/processing/completed/failed), progress %, and result URL on completion. Poll every 10-30s for… Poll an async job started by generate_video or generate_image. Returns status (queued/processing/completed/failed), progress %, and result URL on completion. Poll every 10-30s for video, 5-15s for images. On
create_autopilot_config
from source
Create a new autopilot configuration for automated content pipeline execution. Defines schedule, credit budgets, and approval mode. Create a new autopilot configuration for automated content pipeline execution. Defines schedule, credit budgets, and approval mode.
create_carousel
from source
create_plan_approvals
from source
Create pending approval rows for each post in a content plan \u2014 one row per post, status= Create pending approval rows for each post in a content plan \u2014 one row per post, status=
create_storyboard
from source
Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame. Use before generate_video or generate_image to create cohesive mul… Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame. Use before generate_video or generate_image to create cohesive multi-shot content. Include brand_context from get_brand_profile and project_id for consistent, project-scoped production. Costs 10 credits.
delete_autopilot_config
from source
Permanently delete an owned autopilot configuration in one project. Historical runs and already-published posts are retained. Permanently delete an owned autopilot configuration in one project. Historical runs and already-published posts are retained.
delete_carousel
from source
Delete an owned carousel content-history record from one project. Stored media is retained until the normal retention cleanup; this does not delete already-published platform posts… Delete an owned carousel content-history record from one project. Stored media is retained until the normal retention cleanup; this does not delete already-published platform posts.
delete_comment
from source
Delete a YouTube comment (YouTube only today). Only works for comments owned by the authenticated channel. Delete a YouTube comment (YouTube only today). Only works for comments owned by the authenticated channel.
delete_content_plan
from source
Permanently delete an owned content plan in one project. This does not cancel posts that were already scheduled from the plan. Permanently delete an owned content plan in one project. This does not cancel posts that were already scheduled from the plan.
detect_anomalies
from source
Detect significant performance changes: spikes, drops, viral content, trend shifts. Compares current period against previous equal-length period. No AI call, no credit cost. Detect significant performance changes: spikes, drops, viral content, trend shifts. Compares current period against previous equal-length period. No AI call, no credit cost.
execute_recipe
from source
Execute a recipe template with the provided inputs. This creates a recipe run that processes each step sequentially. Long-running recipes will return a run_id you can check with ge… Execute a recipe template with the provided inputs. This creates a recipe run that processes each step sequentially. Long-running recipes will return a run_id you can check with get_recipe_run_status. Recipes containing a distribution step (publishing or webhook egress) additionally require the mcp:distribute scope.
explain_brand_system
from source
Explains what brand data is available vs missing for a project. Returns a human-readable summary of completeness, confidence levels, and recommendations for improving the brand pro… Explains what brand data is available vs missing for a project. Returns a human-readable summary of completeness, confidence levels, and recommendations for improving the brand profile.
export_design_tokens
from source
Export brand palette and typography as design tokens. Supports CSS custom properties, Tailwind config, and Figma Tokens JSON formats. Export brand palette and typography as design tokens. Supports CSS custom properties, Tailwind config, and Figma Tokens JSON formats.
extract_brand
from source
Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo. Uses AI-powered analysis of the page HTML. Useful for und… Analyze a website URL and extract brand identity data including brand name, colors, voice/tone, target audience, and logo. Uses AI-powered analysis of the page HTML. Useful for understanding a brand before generating content for it.
extract_url_content
from source
Extract text content from any URL \u2014 YouTube video transcript + metadata (title/views/channel), or article text, or product page features/benefits/USP. YouTube URLs auto-route… Extract text content from any URL \u2014 YouTube video transcript + metadata (title/views/channel), or article text, or product page features/benefits/USP. YouTube URLs auto-route to transcript+metadata extraction; channel URLs return a recent-video list. Use before generate_content to repurpose existing content, or before plan_content_week to base a content plan on a source URL.
fetch
from source
fetch_analytics
from source
Get project-scoped post performance metrics \u2014 views, likes, comments, shares, and engagement rate. Filter by platform, time range (default 30 days), or specific content_id. Ca… Get project-scoped post performance metrics \u2014 views, likes, comments, shares, and engagement rate. Filter by platform, time range (default 30 days), or specific content_id. Call refresh_platform_analytics first if data seems stale. Results sorted by most recent capture.
fetch_trends
from source
Get current trending topics for content inspiration. Source Get current trending topics for content inspiration. Source
fetch_youtube_analytics
from source
Fetch YouTube channel analytics. Supports channel overview, daily breakdown, video-specific metrics, and top-performing videos. Requires a connected YouTube account. Fetch YouTube channel analytics. Supports channel overview, daily breakdown, video-specific metrics, and top-performing videos. Requires a connected YouTube account.
find_next_slots
from source
Find optimal posting time slots for one brand/project based on preferred posting times and that project Find optimal posting time slots for one brand/project based on preferred posting times and that project
find_winning_content
from source
Find QA-gated high-performing short-form videos in the project Find QA-gated high-performing short-form videos in the project
generate_carousel
from source
Generate carousel slide content (headlines, body text, emphasis words per slide). Supports Hormozi-style authority format and educational templates. Returns structured slide data \… Generate carousel slide content (headlines, body text, emphasis words per slide). Supports Hormozi-style authority format and educational templates. Returns structured slide data \u2014 render visually then publish via schedule_post with media_type=CAROUSEL_ALBUM and 2-10 media_urls on Instagram.
generate_content
from source
generate_image
from source
Start an async AI image generation job \u2014 returns a job_id immediately. Poll with check_status every 10-15s until complete. Costs 15-50 credits depending on model. Use for soci… Start an async AI image generation job \u2014 returns a job_id immediately. Poll with check_status every 10-15s until complete. Costs 15-50 credits depending on model. Use for social media posts, carousel slides, or as input to generate_video (image-to-video). Pass project_id so the asset is stored with the correct brand/project.
generate_performance_digest
from source
Generate a performance summary for a time period. Includes metrics, trends vs previous period, top/bottom performers, platform breakdown, and actionable recommendations. No AI call… Generate a performance summary for a time period. Includes metrics, trends vs previous period, top/bottom performers, platform breakdown, and actionable recommendations. No AI call, no credit cost.
generate_video
from source
generate_voiceover
from source
Generate a voiceover audio file for video narration. Returns an R2-hosted audio URL. Use after create_storyboard to add narration to each scene, or standalone for podcast intros an… Generate a voiceover audio file for video narration. Returns an R2-hosted audio URL. Use after create_storyboard to add narration to each scene, or standalone for podcast intros and ad reads. Pass project_id to keep the asset with the correct brand/project. Costs 15 credits per generation. If a prior call returned
get_autopilot_status
from source
Get autopilot system overview: active config count, recent execution results, credits consumed, and next scheduled run time. Use as a dashboard check before modifying autopilot set… Get autopilot system overview: active config count, recent execution results, credits consumed, and next scheduled run time. Use as a dashboard check before modifying autopilot settings.
get_best_posting_times
from source
Analyze project-scoped post analytics data to find the best times to post for maximum engagement. Returns the top 5 time slots (day of week + hour) ranked by average engagement. Analyze project-scoped post analytics data to find the best times to post for maximum engagement. Returns the top 5 time slots (day of week + hour) ranked by average engagement.
get_brand_profile
from source
Load the active persisted brand profile for a project from brand_profiles. Load the active persisted brand profile for a project from brand_profiles.
get_brand_runtime
from source
Fetches a project Fetches a project
get_budget_status
from source
Check how much of the per-session budget has been consumed. Tracks credits spent and assets created in this MCP session against configured limits. Use to avoid hitting budget caps… Check how much of the per-session budget has been consumed. Tracks credits spent and assets created in this MCP session against configured limits. Use to avoid hitting budget caps mid-workflow.
get_content_plan
from source
Load a persisted content plan by its UUID \u2014 returns the full plan including all posts, scheduling status, and approval state. Use to inspect a plan before update_content_plan… Load a persisted content plan by its UUID \u2014 returns the full plan including all posts, scheduling status, and approval state. Use to inspect a plan before update_content_plan or schedule_content_plan. plan_id comes from save_content_plan, plan_content_week (when persisted), or list_plan_approvals. For just the approval state, list_plan_approvals is cheaper.
get_credit_balance
from source
Check remaining credits, monthly limit, spending cap, and plan tier. Call this before expensive operations \u2014 generate_video costs 15-80 credits, generate_image costs 2-10. Ret… Check remaining credits, monthly limit, spending cap, and plan tier. Call this before expensive operations \u2014 generate_video costs 15-80 credits, generate_image costs 2-10. Returns current balance, monthly allocation, and spending cap (2.5x allocation).
get_ideation_context
from source
Get synthesized ideation context from performance insights. Returns the same prompt-injection context used by ideation generation. Get synthesized ideation context from performance insights. Returns the same prompt-injection context used by ideation generation.
get_loop_summary
from source
Get a one-call dashboard summary of the feedback loop state (brand profile, recent content, and current insights). Get a one-call dashboard summary of the feedback loop state (brand profile, recent content, and current insights).
get_mcp_usage
from source
Get your MCP API usage breakdown for the current billing month. Shows per-tool call counts and credit usage. Useful for monitoring API consumption and staying within tier limits. Get your MCP API usage breakdown for the current billing month. Shows per-tool call counts and credit usage. Useful for monitoring API consumption and staying within tier limits.
get_media_url
from source
Get a fresh signed URL for R2 media. Use when a previously returned signed URL has expired (they last 1 hour). Pass the r2_key from upload_media or check_status, or the job_id from… Get a fresh signed URL for R2 media. Use when a previously returned signed URL has expired (they last 1 hour). Pass the r2_key from upload_media or check_status, or the job_id from check_status (the job row resolves the key server-side \u2014 works for legacy key formats too).
get_performance_insights
from source
Query project-scoped performance insights derived from post analytics. Returns metrics like engagement rate, view velocity, and click rate aggregated over time. Use this to underst… Query project-scoped performance insights derived from post analytics. Returns metrics like engagement rate, view velocity, and click rate aggregated over time. Use this to understand what content is performing well.
get_pipeline_status
from source
Check status of a pipeline run, including stages completed, pending approvals, and scheduled posts. Check status of a pipeline run, including stages completed, pending approvals, and scheduled posts.
get_recipe_details
from source
Get full details of a recipe template including all steps, input schema, and estimated costs. Use this before execute_recipe to understand what inputs are required. Get full details of a recipe template including all steps, input schema, and estimated costs. Use this before execute_recipe to understand what inputs are required.
get_recipe_run_status
from source
Check the status of a running recipe execution. Shows progress, current step, credits used, and outputs when complete. Check the status of a running recipe execution. Shows progress, current step, credits used, and outputs when complete.
get_skill
from source
Fetch the full body of a single Social Neuron skill by slug \u2014 the hand-maintained strategy/specs plus the machine-maintained Fetch the full body of a single Social Neuron skill by slug \u2014 the hand-maintained strategy/specs plus the machine-maintained
list_autopilot_configs
from source
List autopilot configurations showing schedules, credit budgets, last run times, and active/inactive status. Use to check what is automated before creating new configs, or to find… List autopilot configurations showing schedules, credit budgets, last run times, and active/inactive status. Use to check what is automated before creating new configs, or to find config_id for update_autopilot_config.
list_comments
from source
List YouTube comments (YouTube only today) \u2014 pass video_id (11-char string, e.g. List YouTube comments (YouTube only today) \u2014 pass video_id (11-char string, e.g.
list_compositions
from source
List all available Remotion video compositions defined in Social Neuron. Returns composition IDs, dimensions, duration, and descriptions. Use this to discover what videos can be re… List all available Remotion video compositions defined in Social Neuron. Returns composition IDs, dimensions, duration, and descriptions. Use this to discover what videos can be rendered with render_demo_video.
list_connected_accounts
from source
Check which social platforms have active OAuth connections for posting. Call this before schedule_post to verify credentials. Pass project_id to list the accounts for a specific br… Check which social platforms have active OAuth connections for posting. Call this before schedule_post to verify credentials. Pass project_id to list the accounts for a specific brand/project, then pass the returned account id as account_id/account_ids when posting. If a platform is missing or expired, the user needs to reconnect at socialneuron.com/settings/connections.
list_hyperframes_blocks
from source
List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) the agent can compose into an HTML video composition. Returns… List the curated subset of pre-built Hyperframes blocks (transitions, social overlays, data-viz, branding, decorative) the agent can compose into an HTML video composition. Returns block IDs with categories + 1-line descriptions. No network call \u2014 returns a static catalog.
list_plan_approvals
from source
List approval items for a content plan, optionally filtered by status (pending / approved / rejected / edited). Use to check what needs review before scheduling, or to audit decisi… List approval items for a content plan, optionally filtered by status (pending / approved / rejected / edited). Use to check what needs review before scheduling, or to audit decisions after the fact. plan_id comes from get_content_plan or save_content_plan. For a single item
list_recent_posts
from source
List recent published and scheduled posts with status, platform, title, and timestamps. Use to check what has been posted before planning new content, or to find post IDs for fetch… List recent published and scheduled posts with status, platform, title, and timestamps. Use to check what has been posted before planning new content, or to find post IDs for fetch_analytics. Filter by platform or status to narrow results.
list_recipes
from source
List available recipe templates. Recipes are pre-built multi-step workflows like List available recipe templates. Recipes are pre-built multi-step workflows like
list_skills
from source
List Social Neuron content workflow skills available to the authenticated user. A skill is a brand-locked multi-step pipeline (research \u2192 hook \u2192 script \u2192 visuals \u2… List Social Neuron content workflow skills available to the authenticated user. A skill is a brand-locked multi-step pipeline (research \u2192 hook \u2192 script \u2192 visuals \u2192 voice \u2192 captions \u2192 assembly \u2192 quality gate \u2192 schedule) inspired by documented viral patterns (MrBeast 3-second hook, Hormozi pattern interrupt, etc.). Use this tool when the user asks
moderate_comment
from source
Moderate a YouTube comment on your channel (YouTube only today) \u2014 set status to Moderate a YouTube comment on your channel (YouTube only today) \u2014 set status to
plan_content_week
from source
Generate a full content plan with platform-specific drafts, hooks, angles, and optimal schedule times. Pass a topic or source_url \u2014 brand context and performance insights auto… Generate a full content plan with platform-specific drafts, hooks, angles, and optimal schedule times. Pass a topic or source_url \u2014 brand context and performance insights auto-load via project_id. Output feeds directly into quality_check_plan then schedule_content_plan. Costs ~5-15 credits depending on post count.
post_comment
from source
quality_check
from source
Score post quality across 7 categories: Hook Strength, Message Clarity, Platform Fit, Brand Alignment, Novelty, CTA Strength, and Safety/Claims. Each scored 0-5, total 35. Default… Score post quality across 7 categories: Hook Strength, Message Clarity, Platform Fit, Brand Alignment, Novelty, CTA Strength, and Safety/Claims. Each scored 0-5, total 35. Default pass threshold is 26 (~75%). Run after generate_content and before schedule_post. Include hashtags in caption if they will be published \u2014 they affect Platform Fit and Safety scores.
quality_check_plan
from source
Batch quality check all posts in a content plan. Returns per-post scores and aggregate pass/fail summary. Use after plan_content_week and before schedule_content_plan to catch low-… Batch quality check all posts in a content plan. Returns per-post scores and aggregate pass/fail summary. Use after plan_content_week and before schedule_content_plan to catch low-quality posts before publishing.
refresh_platform_analytics
from source
Queue analytics refresh jobs for posts from the last 7 days in one project across its connected platforms. Call this before fetch_analytics if you need fresh data. Returns immediat… Queue analytics refresh jobs for posts from the last 7 days in one project across its connected platforms. Call this before fetch_analytics if you need fresh data. Returns immediately \u2014 data updates asynchronously over the next 1-5 minutes.
render_demo_video
from source
Render a Remotion composition to an MP4 or GIF file locally. Uses the Remotion bundler and renderer from the root project. This can take 30-120 seconds depending on composition len… Render a Remotion composition to an MP4 or GIF file locally. Uses the Remotion bundler and renderer from the root project. This can take 30-120 seconds depending on composition length. Output is saved to public/videos/.
render_hyperframes
from source
render_template_video
from source
reply_to_comment
from source
Reply to a YouTube comment (YouTube only today). Get the parent_id from list_comments results. Reply appears as the authenticated channel. Use for community engagement after checki… Reply to a YouTube comment (YouTube only today). Get the parent_id from list_comments results. Reply appears as the authenticated channel. Use for community engagement after checking list_comments for questions or feedback.
reschedule_post
from source
Move an existing pending or scheduled post to a new future time without creating a duplicate. Pass project_id for the post Move an existing pending or scheduled post to a new future time without creating a duplicate. Pass project_id for the post
respond_plan_approval
from source
Approve, reject, or edit a single pending plan approval item. Use to act on items surfaced by list_plan_approvals. decision= Approve, reject, or edit a single pending plan approval item. Use to act on items surfaced by list_plan_approvals. decision=
run_content_pipeline
from source
run_skill
from source
save_brand_profile
from source
save_content_plan
from source
Save a content plan to the database for team review, approval workflows, and scheduled publishing. Creates a plan_id you can reference in get_content_plan, update_content_plan, and… Save a content plan to the database for team review, approval workflows, and scheduled publishing. Creates a plan_id you can reference in get_content_plan, update_content_plan, and schedule_content_plan.
schedule_content_plan
from source
Schedule all posts in a content plan. Optionally auto-assigns time slots and runs quality checks before scheduling. Supports dry-run mode. Schedule all posts in a content plan. Optionally auto-assigns time slots and runs quality checks before scheduling. Supports dry-run mode.
schedule_post
from source
Publish or schedule a post to connected social platforms. ALWAYS call Publish or schedule a post to connected social platforms. ALWAYS call
search
from source
search_tools
from source
Search available tools by name, description, module, or scope. Use Search available tools by name, description, module, or scope. Use
start_platform_connection
from source
submit_content_plan_for_approval
from source
Create pending approval items for each post in a plan and mark plan status as in_review. Create pending approval items for each post in a plan and mark plan status as in_review.
suggest_next_content
from source
Suggest next content topics based on performance insights, past content, and competitor patterns. No AI call, no credit cost \u2014 purely data-driven recommendations. Suggest next content topics based on performance insights, past content, and competitor patterns. No AI call, no credit cost \u2014 purely data-driven recommendations.
update_autopilot_config
from source
Update an existing autopilot configuration. Can enable/disable, change schedule, or modify credit budgets. Update an existing autopilot configuration. Can enable/disable, change schedule, or modify credit budgets.
update_content_plan
from source
Edit individual posts in a persisted content plan \u2014 change caption, title, hashtags, hook, or angle. Use after get_content_plan when the user wants to revise drafts before sch… Edit individual posts in a persisted content plan \u2014 change caption, title, hashtags, hook, or angle. Use after get_content_plan when the user wants to revise drafts before scheduling. Each post_updates entry must include post_id from the loaded plan; only the fields you pass get updated, others stay as-is. Does NOT trigger publishing \u2014 call schedule_content_plan separately when ready.
update_platform_voice
from source
Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy). Update platform-specific voice overrides (samples, tone/style, CTA/hashtag strategy).
upload_media
from source
visual_gate_constraints
from source
Read the per-layout field constraints used by the visual QA gate (font size, effective width, max lines per field). Useful when generating slide text \u2014 lets you produce conten… Read the per-layout field constraints used by the visual QA gate (font size, effective width, max lines per field). Useful when generating slide text \u2014 lets you produce content that fits the first time. Returns the same TEMPLATE_FIELD_CONSTRAINTS table used at publish-time.
visual_quality_check
from source
wait_for_connection
from source