audit_brand_colorsLABSCO SUMMARY
search_tools first, because 91 definitions will not fit comfortably.
The discovery tool exists so an agent finds the handful it needs rather than carrying the whole surface — the project puts the saving at 98% of what loading them all would cost. Cancellation and deletion tools are project-scoped and report refund status explicitly, which is what you want when generation spends credits.
What it is
Social Neuron's server, available as a hosted HTTP endpoint or an npm stdio package. 91 public tools spanning ideation, generation, distribution, analytics, brand and autopilot.
What you get
- 91 public tools, plus search_tools to find the right one by keyword instead of loading them all
- Ideation and trends — generate_content, fetch_trends, adapt_content, get_ideation_context
- Generation — generate_video, generate_image, generate_voiceover, generate_carousel, create_storyboard, check_status
- Distribution — schedule_post, reschedule_post, schedule_content_plan, find_next_slots, list_connected_accounts, list_recent_posts
- Analytics and insight — fetch_analytics, refresh_platform_analytics, get_performance_insights, get_best_posting_times, fetch_youtube_analytics
- Brand — extract_brand, get_brand_profile, save_brand_profile, update_platform_voice, check_brand_consistency, audit_brand_colors, export_design_tokens
- Planning and approvals — plan_content_week, save_content_plan, get_content_plan, submit_content_plan_for_approval, create_plan_approvals, respond_plan_approval
- Autopilot, credits and quality — list_autopilot_configs, get_autopilot_status, update_autopilot_config, get_credit_balance, get_budget_status, quality_check, quality_check_plan
- Two interactive apps on the hosted endpoint — open_content_calendar and open_analytics_pulse — for hosts that render MCP Apps
Requirements
A Social Neuron account. Authenticate by device code, browser flow or a pasted API key. The hosted endpoint is mcp.socialneuron.com; the npm package installs as @socialneuron/mcp-server and provides the socialneuron-mcp and sn commands over stdio. The two surfaces differ deliberately — hosted carries the two interactive apps, stdio carries two local screen-capture tools instead. Scopes such as mcp:read are tied to plan tier.
Setup effort
Follow the published steps — npx -y @socialneuron/mcp-server login --device
USE CASES
01
Going from an idea to a scheduled post
Generate the content against your brand voice, run the quality check, find a slot that does not clash, and schedule it.
02
Keeping output on-brand
Extract the brand from a URL once, then check every draft against its voice, vocabulary and palette before it goes out.
03
Deciding what to make next from what worked
Refresh the platform numbers, read the performance insights and best posting times, and let the plan follow the data.
04
Running a week of content past someone first
Plan the week, submit it for approval, and let reviewers respond — the plan does not publish until it clears.
05
Not overspending on generation
Check the credit balance and the per-session budget before a run, and cancel jobs or scheduled posts with the refund status reported back.
91 tools
Listed in project docs. Your client may show a different list.
capture_app_pagecapture_screenshotcheck_brand_consistencycheck_pipeline_readinesscheck_statusexplain_brand_systemexport_design_tokensextract_brandextract_url_contentfetchfetch_analyticsfetch_trendsfind_next_slotsfind_winning_contentget_best_posting_timesget_brand_profileget_brand_runtimeget_budget_statusget_content_planget_credit_balanceget_ideation_contextget_loop_summaryget_mcp_usageget_media_urlget_performance_insightsget_pipeline_statusget_recipe_detailsget_recipe_run_statusget_skilllist_compositionslist_connected_accountslist_hyperframes_blockslist_plan_approvalslist_recent_postslist_recipeslist_skillsquality_checkquality_check_plansearchsearch_toolssuggest_next_contentvisual_gate_constraintsvisual_quality_checkwait_for_connectiondetect_anomaliesfetch_youtube_analyticsgenerate_performance_digestrefresh_platform_analyticsadapt_contentcancel_async_jobcreate_carouselcreate_plan_approvalscreate_storyboarddelete_carouseldelete_content_planexecute_recipegenerate_carouselgenerate_contentgenerate_imagegenerate_videogenerate_voiceoverplan_content_weekrender_demo_videorender_hyperframesrender_template_videorespond_plan_approvalrun_skillsave_brand_profilesave_content_plansubmit_content_plan_for_approvalupdate_content_planupdate_platform_voiceupload_mediacancel_scheduled_postreschedule_postschedule_content_planschedule_poststart_platform_connectiondelete_commentlist_commentsmoderate_commentpost_commentreply_to_commentauto_approve_plancreate_autopilot_configdelete_autopilot_configget_autopilot_statuslist_autopilot_configsrun_content_pipelineupdate_autopilot_configBEFORE YOU INSTALL
What to know first
Tools you get
91 tools named in the project's documentation.
Requires
A Social Neuron Pro plan or higher
Where it runs
Of the 6 documented setups, 4 run the server on your machine and 2 connect to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
Setup
TERMINAL
npx -y @socialneuron/mcp-server login --device
claude mcp add socialneuron -- npx -y @socialneuron/mcp-serverHosted endpoint
ENDPOINT URL
https://mcp.socialneuron.com/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Claude Code — HTTP
CLAUDE CODE — HTTP · TERMINAL
claude mcp add --transport http socialneuron https://mcp.socialneuron.com/mcpThe local (npx) setups need a key: sign in once with npx -y @socialneuron/mcp-server login --device, which stores it in your OS keychain, so those configurations carry none — on Windows, the project recommends setting SOCIALNEURON_API_KEY in the environment instead. The hosted endpoint needs no login step: your client follows its OAuth sign-in the first time it connects.
Claude Code — local
CLAUDE CODE — LOCAL · TERMINAL
claude mcp add socialneuron -- npx -y @socialneuron/mcp-serverThe local (npx) setups need a key: sign in once with npx -y @socialneuron/mcp-server login --device, which stores it in your OS keychain, so those configurations carry none — on Windows, the project recommends setting SOCIALNEURON_API_KEY in the environment instead. The hosted endpoint needs no login step: your client follows its OAuth sign-in the first time it connects.
Claude Desktop, Cursor
JSON
{
"mcpServers": {
"socialneuron": {
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
]
}
}
}The local (npx) setups need a key: sign in once with npx -y @socialneuron/mcp-server login --device, which stores it in your OS keychain, so those configurations carry none — on Windows, the project recommends setting SOCIALNEURON_API_KEY in the environment instead. The hosted endpoint needs no login step: your client follows its OAuth sign-in the first time it connects.
VS Code
VS CODE · JSON
{
"servers": {
"socialneuron": {
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
]
}
}
}The local (npx) setups need a key: sign in once with npx -y @socialneuron/mcp-server login --device, which stores it in your OS keychain, so those configurations carry none — on Windows, the project recommends setting SOCIALNEURON_API_KEY in the environment instead. The hosted endpoint needs no login step: your client follows its OAuth sign-in the first time it connects.
ChatGPT — OAuth
CHATGPT — OAUTH · URL
https://mcp.socialneuron.com/mcpThe local (npx) setups need a key: sign in once with npx -y @socialneuron/mcp-server login --device, which stores it in your OS keychain, so those configurations carry none — on Windows, the project recommends setting SOCIALNEURON_API_KEY in the environment instead. The hosted endpoint needs no login step: your client follows its OAuth sign-in the first time it connects.
