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"]
}
}
}jsonRestart 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"]
}
}
}jsonOr install as a skill:
claude mcp add social-neuron npx @socialneuron/mcp-serverbash
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"]
}
}
}jsonWindsurf
In Windsurf, go to Settings > MCP and add:
{
"social-neuron": {
"command": "npx",
"args": ["-y", "@socialneuron/mcp-server"]
}
}jsonVS 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"]
}
}
}jsonAuthentication
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
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 reviewplain
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 workedplain
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 schedulingplain
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+ |
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
| 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 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.