Ermöglicht es AI-Clients, Social-Media-Content über mehrere Plattformen hinweg mit 93 spezialisierten Tools zu erstellen, zu planen, zu verteilen und zu analysieren.
Auch bekannt als socialneuron/mcp-server, @socialneuron/mcp-server
- Stars
- 5
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.6.0
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
Was ist Social Neuron MCP?
Social Neuron ist ein MCP server. Ermöglicht es AI-Clients, Social-Media-Content über mehrere Plattformen hinweg mit 93 spezialisierten Tools zu erstellen, zu planen, zu verteilen und zu analysieren.
Zusammenfassung generiert aus dem README des Projekts
Über Social Neuron MCP server
Das Management der Social-Media-Präsenz durch AI-Agents ist das Kerngebiet dieses Servers für Content Creator und Marketing-Teams. Durch die Verbindung mit Clients wie Claude Code, Cursor oder Claude Desktop können Nutzer 93 spezialisierte Tools nutzen, um den gesamten Content-Lifecycle abzubilden. Das System unterstützt die Generierung von Videos, Bildern, Musik und Voiceovers sowie das Scheduling von Posts auf Plattformen wie X, Bluesky, YouTube und TikTok.
Das Setup erfordert einen Social Neuron Pro Plan oder höher sowie eine Authentifizierung via Device Code, Browser-Flow oder API-Key. Sobald die Verbindung steht, stellt der Server Tools für Ideengenerierung, Brand Voice Management und automatisiertes Engagement durch Comment Moderation bereit. Er enthält zudem fortgeschrittene Features wie Autopilot für wiederkehrende Posts und interaktive Apps, um einen Content-Kalender oder Analytics-Dashboards in den unterstützten Hosts anzuzeigen.
Über das einfache Posten hinaus ermöglicht der Server einen geschlossenen Optimierungsprozess. Er kann Trends abrufen, Media-Assets erstellen, Content verteilen und anschließend Performance-Daten analysieren, um Verbesserungen für die zukünftige Planung vorzuschlagen. Dies erlaubt es einer AI, als vollständiger Social-Media-Manager zu agieren, der aus den Plattform-Analytics lernt, um seine Strategie kontinuierlich zu verfeinern.
Was du damit machen kannst
- 1Automatisierte Content-ErstellungFordere deinen AI-Client auf, verschiedene Medientypen wie Videos, Bilder und Carousels für deine Brand zu generieren.
- 2Plattformübergreifendes SchedulingWeise einen AI-Agent an, spezifische Posts zu einem festgelegten Zeitpunkt in mehreren sozialen Netzwerken zu verteilen.
- 3Performance-Analyse und OptimierungLasse eine Auswertung deiner aktuellen Social-Media-Metriken erstellen, um High-Performing Content und Verbesserungspotenziale zu identifizieren.
- 4Autonome Content-LoopsRichte ein wiederkehrendes System ein, das Content basierend auf Trending Topics und vergangener Performance plant, erstellt und postet.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Social Neuron MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenSocial Neuron MCP in Claude Code installieren
$ claude mcp add --env 'SOCIALNEURON_API_KEY=<YOUR_SOCIALNEURON_API_KEY>' mcp-server -- npx -y @socialneuron/mcp-serverSocial Neuron MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
],
"env": {
"SOCIALNEURON_API_KEY": "<YOUR_SOCIALNEURON_API_KEY>"
}
}
}
}Social Neuron MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
],
"env": {
"SOCIALNEURON_API_KEY": "<YOUR_SOCIALNEURON_API_KEY>"
}
}
}
}Social Neuron MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@socialneuron/mcp-server"],"env":{"SOCIALNEURON_API_KEY":"<YOUR_SOCIALNEURON_API_KEY>"}}'Social Neuron MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
],
"env": {
"SOCIALNEURON_API_KEY": "<YOUR_SOCIALNEURON_API_KEY>"
}
}
}
}Social Neuron MCP in Codex installieren
$ codex mcp add mcp-server --env 'SOCIALNEURON_API_KEY=<YOUR_SOCIALNEURON_API_KEY>' -- npx -y @socialneuron/mcp-serverSocial Neuron MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@socialneuron/mcp-server"] [mcp_servers.mcp-server.env] SOCIALNEURON_API_KEY = "<YOUR_SOCIALNEURON_API_KEY>"
Social Neuron MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'SOCIALNEURON_API_KEY=<YOUR_SOCIALNEURON_API_KEY>' mcp-server npx -- -y @socialneuron/mcp-serverSocial Neuron MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@socialneuron/mcp-server"
],
"env": {
"SOCIALNEURON_API_KEY": "<YOUR_SOCIALNEURON_API_KEY>"
}
}
}
}Konfiguration
SOCIALNEURON_API_KEYErforderlichSecretYour Social Neuron API key. Generate at https://socialneuron.com/settings/developer
| Name | Beschreibung | Typ |
|---|---|---|
| SOCIALNEURON_API_KEY | Your Social Neuron API key. Generate at https://socialneuron.com/settings/developer | ErforderlichSecret |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertNicht geprüft
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehen@socialneuron/mcp-server
93 public MCP tools for AI-powered social media management. Create content, schedule posts, track analytics, and optimize performance — all from Claude Code or any MCP client.
Quick Start
1. Authenticate
npx -y @socialneuron/mcp-server login --device
This opens your browser to authorize access. Requires a Social Neuron Pro plan or higher. See pricing.
2. Add to Claude Code
claude mcp add socialneuron -- npx -y @socialneuron/mcp-server
Add to your claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"socialneuron": {
"command": "npx",
"args": ["-y", "@socialneuron/mcp-server"]
}
}
}
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"socialneuron": {
"command": "npx",
"args": ["-y", "@socialneuron/mcp-server"]
}
}
}
Add to .cursor/mcp.json in your workspace:
{
"mcpServers": {
"socialneuron": {
"command": "npx",
"args": ["-y", "@socialneuron/mcp-server"]
}
}
}
3. Start using
Ask Claude: "What content should I post this week?" or "Schedule my latest video to YouTube and TikTok"
What You Can Do
Ask Claude things like:
- "Generate 5 content ideas about sustainable fashion for Gen Z"
- "Create a 30-second video ad for my product launch"
- "Schedule this post to X and Bluesky at 9am tomorrow"
- "Show me my best-performing content this month"
- "What are the trending topics in my niche right now?"
- "Check my analytics and suggest improvements"
- "Set up autopilot to post 3 times per week"
Tool Categories
The npm package exposes 93 public tools per transport. The separately versioned hosted service exposes 92 public tools, including hosted-only get_account_status. Hosted HTTP includes the Content Calendar and Analytics Pulse MCP Apps; npm stdio includes 2 local screen-capture tools instead. The live hosted count is published by the server card. The npm package supports Node 20.20+ and Node 22.22+ under its declared engine ranges. The hosted service runs its separate 3.0.0 contract; its version is recorded alongside its reviewed tool inventory in server.json.hosted.
These tools are available to AI agents (Claude, Cursor, etc.) via the MCP protocol.
Content Lifecycle
| Category | Tools | What It Does |
|---|---|---|
| Ideation | generate_content, fetch_trends, adapt_content, get_ideation_context | AI-powered content ideas and trend research |
| Content | generate_video, generate_image, generate_music, generate_voiceover, generate_carousel, check_status, create_storyboard | Video, image, music, voiceover, and carousel creation across multiple AI model families |
| Distribution | schedule_post, reschedule_post, schedule_content_plan, find_next_slots, list_connected_accounts, list_recent_posts | Project-scoped multi-platform publishing, scheduling, rescheduling, and slot optimization |
| Analytics | fetch_analytics, refresh_platform_analytics | Performance tracking across all platforms |
| Insights | get_performance_insights, get_best_posting_times | Data-driven content optimization |
Management & Optimization
| Category | Tools | What It Does |
|---|---|---|
| Brand | extract_brand, get_brand_profile, save_brand_profile, update_platform_voice | Brand identity and voice management |
| Comments | list_comments, reply_to_comment, post_comment, moderate_comment, delete_comment | Social engagement management |
| Lifecycle | cancel_async_job, cancel_scheduled_post, delete_carousel, delete_content_plan, delete_autopilot_config | Confirmed, project-scoped cancellation and cleanup with explicit refund status |
| Planning | plan_content_week, save_content_plan, get_content_plan, update_content_plan, submit_content_plan_for_approval | Content calendar and approval workflows |
| Plan Approvals | create_plan_approvals, respond_plan_approval, list_plan_approvals | Review and approve content plans |
| Autopilot | list_autopilot_configs, get_autopilot_status, update_autopilot_config | Automated content scheduling |
| Quality | quality_check, quality_check_plan | Pre-publish content validation |
| Credits | get_credit_balance, get_budget_status, get_generation_options | Usage and budget tracking |
| Loop | get_loop_summary | Closed-loop optimization feedback |
Utilities
| Category | Tools | What It Does |
|---|---|---|
| Extraction | extract_url_content | Extract content from URLs, YouTube, articles |
| Screenshots | capture_app_page, capture_screenshot | Visual documentation and monitoring |
| Remotion | list_compositions, render_demo_video | Programmatic video rendering |
| Usage | get_mcp_usage | API usage monitoring |
| YouTube | fetch_youtube_analytics | YouTube-specific deep analytics |
| Discovery | search_tools | Find tools by keyword with progressive detail levels (saves 98% tokens vs loading all tools) |
Interactive MCP Apps (hosted HTTP)
| App | Open tool | Purpose |
|---|---|---|
| Content Calendar | open_content_calendar |
Project-scoped calendar, quick create, and drag-to-reschedule |
| Analytics Pulse | open_analytics_pulse |
Project-scoped KPI, platform-mix, and top-post performance dashboard |
Apps render only in MCP hosts that support the MCP Apps extension. All underlying data and write operations remain ordinary scoped tools, so hosts without interactive UI can use the same workflows through text/tool calls.
Authentication
Three auth methods, in order of recommendation:
Device Code (Recommended)
npx -y @socialneuron/mcp-server login --device
Opens browser, you approve, CLI receives API key automatically.
Browser Flow
npx -y @socialneuron/mcp-server login
Browser-based OAuth flow.
API Key Paste
npx -y @socialneuron/mcp-server login --paste
Generate a key at socialneuron.com/settings/developer, paste it in.
Keys are stored in your OS keychain (macOS Keychain, Linux secret-tool) or a file fallback created with owner-only permissions where the operating system supports them.
Windows users: The file fallback (
~/.config/social-neuron/credentials.json) does not have strong permission enforcement on NTFS. For production use on Windows, set theSOCIALNEURON_API_KEYenvironment variable instead.
Pricing
MCP/API access requires a Pro plan or higher:
| Plan | Price | Credits/mo | MCP/API Access |
|---|---|---|---|
| Free | $0 | 50 | — |
| Starter | $19/mo | 500 | — |
| Pro | $49/mo | 1,500 | MCP/API: Read + Analytics + Write + Distribute |
| Team | $99/mo | 3,500 | Full MCP/API + 5 keys |
| Agency | $249/mo | 10,000 | Full MCP/API + 20 keys |
Sign up at socialneuron.com/pricing.
Scopes
Each API key inherits scopes from your plan. Tools require specific scopes to execute.
| Scope | What you can do |
|---|---|
mcp:read |
Analytics, insights, brand profiles, content plans, quality checks, screenshots, usage stats, credit balance |
mcp:write |
Generate content (video, image, voiceover, carousel), create storyboards, save brand profiles, plan content |
mcp:distribute |
Schedule posts, publish content plans |
mcp:analytics |
Refresh analytics, YouTube deep analytics |
mcp:comments |
List, reply, post, moderate, delete comments |
mcp:autopilot |
Configure and monitor automated scheduling |
mcp:full |
All of the above |
CLI Reference
These commands run directly in your terminal — no AI agent needed. Useful for scripts, CI/CD, and quick checks.
After global install (
npm i -g @socialneuron/mcp-server), usesocialneuron-mcpdirectly. Otherwise, prefix withnpx @socialneuron/mcp-server.
# Auth
socialneuron-mcp login [--device|--paste]
socialneuron-mcp logout
# Deterministic CLI (no LLM)
socialneuron-mcp sn publish --media-url <url> --caption <text> --platforms <list> --confirm
socialneuron-mcp sn status --job-id <id>
socialneuron-mcp sn posts --days 7 --platform youtube
socialneuron-mcp sn refresh-analytics
socialneuron-mcp sn preflight --check-urls
socialneuron-mcp sn oauth-health --json
socialneuron-mcp sn oauth-refresh --platform instagram
socialneuron-mcp sn quality-check --content "your text here"
socialneuron-mcp sn autopilot
socialneuron-mcp sn usage
socialneuron-mcp sn loop
socialneuron-mcp sn credits
# Agent-native CLI v2
socialneuron-mcp sn tools [--module ideation] [--scope mcp:write] # List/filter available tools
socialneuron-mcp sn info # Version, auth, credits, tool count
socialneuron-mcp sn plan list|view|approve # Content plan management
socialneuron-mcp sn preset list|show|save|delete # Platform presets (6 built-in)
# Interactive REPL
socialneuron-mcp repl
# Add --json to any command for machine-readable output
Automation Flow (E2E Loop)
The full autonomous content loop using MCP tools:
get_loop_summary— assess project state (content count, scheduled posts, insights)plan_content_week— generate a content plan based on insights and trendsgenerate_video/generate_image— create media assets from the plancheck_status— poll async jobs until assets are readyschedule_post— distribute content to connected platforms- (wait for analytics collection) — platform data is fetched automatically
refresh_platform_analytics— trigger a manual analytics refreshget_performance_insights— read what worked and what didn't- Loop back to step 1 with new insights
Each iteration produces smarter content as performance data feeds back into the planning step.
Security
- All API keys are hashed before storage — we never store plaintext keys
- Credentials stored in your OS keychain (macOS Keychain, Linux secret-tool) or environment variable
- SSRF protection on all URL parameters with DNS rebinding prevention
- Rate limiting per user with per-tool limits for expensive operations
- Agent loop detection prevents runaway automation
- Set
DO_NOT_TRACK=1to disable anonymous usage telemetry
See SECURITY.md for our vulnerability disclosure policy and credential safety details.
Telemetry
This package collects operational usage metrics (tool name, duration, success/failure) to improve reliability. It does not send tool inputs, outputs, generated content, API keys, emails, or upstream error bodies. When a deployment configures POSTHOG_PSEUDONYMIZATION_KEY, the user identifier is HMAC-pseudonymized; otherwise an ephemeral per-process key prevents stable cross-session correlation.
To disable: Set DO_NOT_TRACK=1 or SOCIALNEURON_NO_TELEMETRY=1 in your environment.
No personal content, API keys, or request payloads are ever collected.
Examples
See the examples repo for prompt-driven workflow templates:
- Weekly content batch planning
- Cross-platform content repurposing
- Performance review and optimization loops
- Brand-aligned content generation
- Comment engagement automation
Use Social Neuron in your assistant
This npm package is one of several ways to connect. The Social Neuron organization page keeps the current table for Grok Build, ChatGPT, Claude, Cursor and local MCP clients, with the status of each listing.
The Grok Build plugin lives in this repository at plugins/socialneuron/. It uses the hosted server with browser sign-in and adds skills. Its connection is named socialneuron-hosted, so it can be set up alongside this npm server, and it is versioned separately from the npm package. Free MIT plugin; requires a Social Neuron account. Generation uses your plan's credits.
Links
License
MIT - see LICENSE
Social Neuron MCP Fragen
Wie füge ich Social Neuron MCP zu Claude Code hinzu?
Führe claude mcp add --env 'SOCIALNEURON_API_KEY=<YOUR_SOCIALNEURON_API_KEY>' mcp-server -- npx -y @socialneuron/mcp-server in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Social Neuron MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Art von Content kann ich generieren?
Der Server bietet Tools zur Generierung von Video, Bildern, Musik, Voiceovers und Carousels unter Verwendung verschiedener AI-Modellfamilien.
Ist hierfür ein kostenpflichtiges Abonnement erforderlich?
Ja, der MCP- und API-Zugriff erfordert einen Social Neuron Pro Plan oder höher.
Kann ich meine Social-Media-Posts automatisieren?
Ja, du kannst Autopilot einrichten, um Content nach einem Zeitplan zu posten, oder Tools nutzen, um Content auf Plattformen wie X und Bluesky zu planen und zu terminieren.