SocialNeuronSocialNeuronSocialNeuron
  • Docs
  • REST API
  • MCP Tools API
Product
  • Dashboard
  • Pricing
  • What's New
Developers
  • REST API
  • MCP Tools API
  • CLI Reference
  • npm Package
  • GitHub
Support
  • Help & Support
  • FAQ
  • Email Support
Community
  • X / Twitter
  • GitHub
  • Privacy Policy
  • Terms of Service

​MCP Agent Examples

Social Neuron's MCP server lets AI agents manage your entire content workflow — from ideation to publishing to analytics. Here's how to connect it to popular AI tools.

​Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "social-neuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}
json

Restart Claude Desktop. On first run, it will prompt you to authenticate with your Social Neuron API key.

Use the device code flow for the smoothest setup. Run npx @socialneuron/mcp-server login --device in your terminal first if you want to authenticate before connecting.

​What You Can Do in Claude Desktop

Once connected, ask Claude things like:

  • "Plan my content for next week across Instagram and LinkedIn"
  • "Show me my top-performing posts from the last 30 days"
  • "Generate a TikTok script about sustainable fashion"
  • "Schedule this post for tomorrow at 9am on YouTube"
  • "Check my credit balance"

Claude will use Social Neuron's 64 tools automatically based on your request.

​Claude Code

Add to your project's .claude/settings.json or global config:

{
  "mcpServers": {
    "social-neuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}
json

Or install as a skill:

claude mcp add social-neuron npx @socialneuron/mcp-server
bash

​Cursor

In Cursor, go to Settings > MCP Servers > Add Server:

  • Name: Social Neuron
  • Command: npx
  • Args: -y @socialneuron/mcp-server

Or add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "social-neuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}
json

​Windsurf

In Windsurf, go to Settings > MCP and add:

{
  "social-neuron": {
    "command": "npx",
    "args": ["-y", "@socialneuron/mcp-server"]
  }
}
json

​VS Code (Copilot MCP)

For VS Code with GitHub Copilot MCP support, add to .vscode/mcp.json:

{
  "servers": {
    "social-neuron": {
      "command": "npx",
      "args": ["-y", "@socialneuron/mcp-server"]
    }
  }
}
json

​Authentication

All agents use the same authentication flow. The first time you connect, the MCP server will prompt you to authenticate.

​Three Methods

MethodBest ForCommand
Device Code (recommended)Desktop apps, quick setupnpx @socialneuron/mcp-server login --device
Browser FlowWhen you want to log in via your browsernpx @socialneuron/mcp-server login
API Key PasteCI/CD, scripts, headless environmentsnpx @socialneuron/mcp-server login --paste

Your API key is stored securely in your OS keychain (macOS Keychain, Linux secret-tool, or an encrypted local file on Windows).

​Example Workflows

​Weekly Content Planning

You: "Plan my content for next week. I'm a fitness coach targeting 
women 25-35 on Instagram and TikTok. Focus on home workouts and 
meal prep."

Social Neuron will:
1. Analyze your brand profile for voice consistency
2. Check your best posting times
3. Generate a 7-day plan with platform-specific content
4. Save the plan for your review
plain

​Performance Analysis

You: "What content performed best last month? Give me actionable 
insights and suggest what to create next."

Social Neuron will:
1. Pull analytics across all connected platforms
2. Identify top-performing posts and patterns
3. Generate performance insights with recommendations
4. Suggest content themes based on what worked
plain

​Cross-Platform Repurposing

You: "Take my latest YouTube video and create content for Instagram, 
TikTok, LinkedIn, and X."

Social Neuron will:
1. Extract key points from the video
2. Generate platform-adapted versions (reel script, carousel, 
   LinkedIn article, tweet thread)
3. Apply your brand voice to each version
4. Queue them for your review before scheduling
plain

​Available Tools by Scope

Your API key's tier determines which tools are available:

ScopeToolsTier Required
mcp:readAnalytics, insights, brand profiles, plans, creditsStarter+
mcp:writeGenerate content (video, image, text), save profilesPro+
mcp:distributeSchedule posts, publish plansPro+
mcp:analyticsRefresh analytics, YouTube deep analyticsStarter+
mcp:commentsList, reply, moderate commentsPro+
mcp:autopilotConfigure automated schedulingPro+
mcp:fullAll of the abovePro+

Free and Trial tier users cannot access MCP tools. Upgrade to Starter ($29/mo) for read-only access, or Pro ($79/mo) for full access.

​Troubleshooting

IssueSolution
"Authentication required"Run npx @socialneuron/mcp-server login --device
"Insufficient credits"Check balance with get_credit_balance, upgrade plan
"Scope not allowed"Your tier doesn't include this tool — check the scope table above
MCP server not foundEnsure Node.js 20+ is installed, run npx @socialneuron/mcp-server --version
Connection timeoutCheck your internet connection, try npx @socialneuron/mcp-server status

​Next Steps

  • Browse the full MCP Tools API Reference to see all 64 tools
  • Learn about the Credit System to understand costs
  • Set up your Brand Brain for consistent AI-generated content
  • Explore Workflow Recipes for common automation patterns

Ready to try this? Sign up free and get 100 credits to start.


On this page
  • Claude Desktop
    • What You Can Do in Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • VS Code (Copilot MCP)
  • Authentication
    • Three Methods
  • Example Workflows
    • Weekly Content Planning
    • Performance Analysis
    • Cross-Platform Repurposing
  • Available Tools by Scope
  • Troubleshooting
  • Next Steps