Copy page

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

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

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

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 75 tools automatically based on your request.

Claude Code

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

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

Or install as a skill:

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

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:

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

Windsurf

In Windsurf, go to Settings > MCP and add:

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

VS Code (Copilot MCP)

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

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

Authentication

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

Three Methods

Method	Best For	Command
Device Code (recommended)	Desktop apps, quick setup	npx @socialneuron/mcp-server login --device
Browser Flow	When you want to log in via your browser	npx @socialneuron/mcp-server login
API Key Paste	CI/CD, scripts, headless environments	npx @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

Code
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

Performance Analysis

Code
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

Cross-Platform Repurposing

Code
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

Available Tools by Scope

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

Scope	Tools	Tier Required
mcp:read	Analytics, insights, brand profiles, plans, credits	Starter+
mcp:write	Generate content (video, image, text), save profiles	Pro+
mcp:distribute	Schedule posts, publish plans	Pro+
mcp:analytics	Refresh analytics, YouTube deep analytics	Starter+
mcp:comments	List, reply, moderate comments	Pro+
mcp:autopilot	Configure automated scheduling	Pro+
mcp:full	All of the above	Pro+

Troubleshooting

Issue	Solution
"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 found	Ensure Node.js 20+ is installed, run npx @socialneuron/mcp-server --version
Connection timeout	Check your internet connection, try npx @socialneuron/mcp-server status

Next Steps

• Browse the full MCP Tools API Reference to see all 75 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.