{
  "markdown": "# @socialneuron/mcp-server\n\n> 91 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.\n\n[![npm version](https://img.shields.io/npm/v/@socialneuron/mcp-server)](https://www.npmjs.com/package/@socialneuron/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### 1. Authenticate\n\n```bash\nnpx -y @socialneuron/mcp-server login --device\n```\n\nThis opens your browser to authorize access. Requires a Social Neuron Pro plan or higher. See [pricing](https://socialneuron.com/pricing).\n\n### 2. Add to Claude Code\n\n```bash\nclaude mcp add socialneuron -- npx -y @socialneuron/mcp-server\n```\n\n<details>\n<summary><strong>Claude Desktop</strong></summary>\n\nAdd to your `claude_desktop_config.json`:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"socialneuron\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@socialneuron/mcp-server\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>VS Code</strong></summary>\n\nAdd to `.vscode/mcp.json` in your workspace:\n\n```json\n{\n  \"servers\": {\n    \"socialneuron\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@socialneuron/mcp-server\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><strong>Cursor</strong></summary>\n\nAdd to `.cursor/mcp.json` in your workspace:\n\n```json\n{\n  \"mcpServers\": {\n    \"socialneuron\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@socialneuron/mcp-server\"]\n    }\n  }\n}\n```\n</details>\n\n### 3. Start using\n\nAsk Claude: \"What content should I post this week?\" or \"Schedule my latest video to YouTube and TikTok\"\n\n## What You Can Do\n\nAsk Claude things like:\n\n- \"Generate 5 content ideas about sustainable fashion for Gen Z\"\n- \"Create a 30-second video ad for my product launch\"\n- \"Schedule this post to X and Bluesky at 9am tomorrow\"\n- \"Show me my best-performing content this month\"\n- \"What are the trending topics in my niche right now?\"\n- \"Check my analytics and suggest improvements\"\n- \"Set up autopilot to post 3 times per week\"\n\n## Tool Categories\n\nThe hosted endpoint and npm stdio server each expose **91 public tools**. Their surfaces differ intentionally: hosted HTTP includes the Content Calendar and Analytics Pulse MCP Apps, while stdio includes 2 local screen-capture tools instead. The live hosted count is published by the [server card](https://mcp.socialneuron.com/.well-known/mcp/server-card.json). A small set of internal service tools used by Social Neuron's own automation are registered but not part of the public surface.\n\nThese tools are available to AI agents (Claude, Cursor, etc.) via the MCP protocol.\n\n### Content Lifecycle\n\n| Category | Tools | What It Does |\n|----------|-------|-------------|\n| Ideation | generate_content, fetch_trends, adapt_content, get_ideation_context | AI-powered content ideas and trend research |\n| Content | generate_video, generate_image, generate_voiceover, generate_carousel, check_status, create_storyboard | Video, image, voiceover, and carousel creation with 20+ AI models |\n| 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 |\n| Analytics | fetch_analytics, refresh_platform_analytics | Performance tracking across all platforms |\n| Insights | get_performance_insights, get_best_posting_times | Data-driven content optimization |\n\n### Management & Optimization\n\n| Category | Tools | What It Does |\n|----------|-------|-------------|\n| Brand | extract_brand, get_brand_profile, save_brand_profile, update_platform_voice | Brand identity and voice management |\n| Comments | list_comments, reply_to_comment, post_comment, moderate_comment, delete_comment | Social engagement management |\n| 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 |\n| Planning | plan_content_week, save_content_plan, get_content_plan, update_content_plan, submit_content_plan_for_approval | Content calendar and approval workflows |\n| Plan Approvals | create_plan_approvals, respond_plan_approval, list_plan_approvals | Review and approve content plans |\n| Autopilot | list_autopilot_configs, get_autopilot_status, update_autopilot_config | Automated content scheduling |\n| Quality | quality_check, quality_check_plan | Pre-publish content validation |\n| Credits | get_credit_balance, get_budget_status | Usage and budget tracking |\n| Loop | get_loop_summary | Closed-loop optimization feedback |\n\n### Utilities\n\n| Category | Tools | What It Does |\n|----------|-------|-------------|\n| Extraction | extract_url_content | Extract content from URLs, YouTube, articles |\n| Screenshots | capture_app_page, capture_screenshot | Visual documentation and monitoring |\n| Remotion | list_compositions, render_demo_video | Programmatic video rendering |\n| Usage | get_mcp_usage | API usage monitoring |\n| YouTube | fetch_youtube_analytics | YouTube-specific deep analytics |\n| Discovery | search_tools | Find tools by keyword with progressive detail levels (saves 98% tokens vs loading all tools) |\n\n### Interactive MCP Apps (hosted HTTP)\n\n| App | Open tool | Purpose |\n|-----|-----------|---------|\n| Content Calendar | `open_content_calendar` | Project-scoped calendar, quick create, and drag-to-reschedule |\n| Analytics Pulse | `open_analytics_pulse` | Project-scoped KPI, platform-mix, and top-post performance dashboard |\n\nApps 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.\n\n## Authentication\n\nThree auth methods, in order of recommendation:\n\n### Device Code (Recommended)\n\n```bash\nnpx -y @socialneuron/mcp-server login --device\n```\n\nOpens browser, you approve, CLI receives API key automatically.\n\n### Browser Flow\n\n```bash\nnpx -y @socialneuron/mcp-server login\n```\n\nBrowser-based OAuth flow.\n\n### API Key Paste\n\n```bash\nnpx -y @socialneuron/mcp-server login --paste\n```\n\nGenerate a key at socialneuron.com/settings/developer, paste it in.\n\nKeys 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.\n\n> **Windows users**: The file fallback (`~/.config/social-neuron/credentials.json`) does not have strong permission enforcement on NTFS. For production use on Windows, set the `SOCIALNEURON_API_KEY` environment variable instead.\n\n## Pricing\n\nMCP/API access requires a Pro plan or higher:\n\n| Plan | Price | Credits/mo | MCP/API Access |\n|------|-------|-----------|------------|\n| Free | $0 | 50 | — |\n| Starter | $19/mo | 500 | — |\n| Pro | $49/mo | 1,500 | MCP/API: Read + Analytics + Write + Distribute |\n| Team | $99/mo | 3,500 | Full MCP/API + 5 keys |\n| Agency | $249/mo | 10,000 | Full MCP/API + 20 keys |\n\nSign up at [socialneuron.com/pricing](https://socialneuron.com/pricing).\n\n## Scopes\n\nEach API key inherits scopes from your plan. Tools require specific scopes to execute.\n\n| Scope | What you can do |\n|-------|----------------|\n| `mcp:read` | Analytics, insights, brand profiles, content plans, quality checks, screenshots, usage stats, credit balance |\n| `mcp:write` | Generate content (video, image, voiceover, carousel), create storyboards, save brand profiles, plan content |\n| `mcp:distribute` | Schedule posts, publish content plans |\n| `mcp:analytics` | Refresh analytics, YouTube deep analytics |\n| `mcp:comments` | List, reply, post, moderate, delete comments |\n| `mcp:autopilot` | Configure and monitor automated scheduling |\n| `mcp:full` | All of the above |\n\n## CLI Reference\n\nThese commands run directly in your terminal — no AI agent needed. Useful for scripts, CI/CD, and quick checks.\n\n> After global install (`npm i -g @socialneuron/mcp-server`), use `socialneuron-mcp` directly.\n> Otherwise, prefix with `npx @socialneuron/mcp-server`.\n\n```bash\n# Auth\nsocialneuron-mcp login [--device|--paste]\nsocialneuron-mcp logout\n\n# Deterministic CLI (no LLM)\nsocialneuron-mcp sn publish --media-url <url> --caption <text> --platforms <list> --confirm\nsocialneuron-mcp sn status --job-id <id>\nsocialneuron-mcp sn posts --days 7 --platform youtube\nsocialneuron-mcp sn refresh-analytics\nsocialneuron-mcp sn preflight --check-urls\nsocialneuron-mcp sn oauth-health --json\nsocialneuron-mcp sn oauth-refresh --platform instagram\nsocialneuron-mcp sn quality-check --content \"your text here\"\nsocialneuron-mcp sn autopilot\nsocialneuron-mcp sn usage\nsocialneuron-mcp sn loop\nsocialneuron-mcp sn credits\n\n# Agent-native CLI v2\nsocialneuron-mcp sn tools [--module ideation] [--scope mcp:write]  # List/filter available tools\nsocialneuron-mcp sn info                                            # Version, auth, credits, tool count\nsocialneuron-mcp sn plan list|view|approve                          # Content plan management\nsocialneuron-mcp sn preset list|show|save|delete                    # Platform presets (6 built-in)\n\n# Interactive REPL\nsocialneuron-mcp repl\n\n# Add --json to any command for machine-readable output\n```\n\n## Automation Flow (E2E Loop)\n\nThe full autonomous content loop using MCP tools:\n\n1. `get_loop_summary` — assess project state (content count, scheduled posts, insights)\n2. `plan_content_week` — generate a content plan based on insights and trends\n3. `generate_video` / `generate_image` — create media assets from the plan\n4. `check_status` — poll async jobs until assets are ready\n5. `schedule_post` — distribute content to connected platforms\n6. _(wait for analytics collection)_ — platform data is fetched automatically\n7. `refresh_platform_analytics` — trigger a manual analytics refresh\n8. `get_performance_insights` — read what worked and what didn't\n9. Loop back to step 1 with new insights\n\nEach iteration produces smarter content as performance data feeds back into the planning step.\n\n## Security\n\n- All API keys are hashed before storage — we never store plaintext keys\n- Credentials stored in your OS keychain (macOS Keychain, Linux secret-tool) or environment variable\n- SSRF protection on all URL parameters with DNS rebinding prevention\n- Rate limiting per user with per-tool limits for expensive operations\n- Agent loop detection prevents runaway automation\n- Set `DO_NOT_TRACK=1` to disable anonymous usage telemetry\n\nSee [SECURITY.md](./SECURITY.md) for our vulnerability disclosure policy and credential safety details.\n\n## Telemetry\n\nThis 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.\n\n**To disable**: Set `DO_NOT_TRACK=1` or `SOCIALNEURON_NO_TELEMETRY=1` in your environment.\n\nNo personal content, API keys, or request payloads are ever collected.\n\n## Examples\n\nSee the [examples repo](https://github.com/socialneuron/examples) for prompt-driven workflow templates:\n\n- Weekly content batch planning\n- Cross-platform content repurposing\n- Performance review and optimization loops\n- Brand-aligned content generation\n- Comment engagement automation\n\n## Links\n\n- [Social Neuron](https://socialneuron.com)\n- [For Developers](https://socialneuron.com/for-developers)\n- [Documentation](https://socialneuron.com/docs)\n- [Examples](https://github.com/socialneuron/examples)\n- [Agent Protocol](https://socialneuron.com/system-prompt.txt)\n- [Developer Settings](https://socialneuron.com/settings/developer)\n- [Pricing](https://socialneuron.com/pricing)\n\n## License\n\nMIT - see [LICENSE](./LICENSE)\n",
  "bytes": 12176,
  "sha": "950669ddda4658984d3c9b0d1843acb7cddd40181e1a1e2e7a9117f1b55d02cb",
  "repo_slug": "socialneuron/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_socialneuron_mcp_server_76e4f7a3/readme"
}