# 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`

```json
{
  "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.

:::tip
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 91 tools automatically based on your request.

## Claude Code

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

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

Or install as a skill:

```bash
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:

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

## Windsurf

In Windsurf, go to **Settings > MCP** and add:

```json
{
  "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`:

```json
{
  "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

```
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

```
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

```
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 | Trial, Pro+ |
| `mcp:write` | Generate content (video, image, text), save profiles | Trial, Pro+ |
| `mcp:distribute` | Schedule posts, publish plans | Trial, Pro+ |
| `mcp:analytics` | Refresh analytics, YouTube deep analytics | Trial, Pro+ |
| `mcp:comments` | List, reply, moderate comments | Team+ |
| `mcp:autopilot` | Configure automated scheduling | Team+ |
| `mcp:full` | All of the above | Team+ |

:::note
Free and Starter tier users cannot access MCP tools. Your 14-day trial includes full MCP access (read, write, distribute, and analytics scopes, 15 requests/min, no autopilot). Pro ($49/mo) includes the same read, write, distribute, and analytics scopes. Team ($99/mo) and Agency ($249/mo) include full MCP access plus Autopilot.
:::

## 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](/tools-api) to see all 91 tools
- Learn about the [Credit System](/docs/guides/credit-system) to understand costs
- Set up your [Brand Brain](/docs/brand-brain) for consistent AI-generated content
- Explore [Workflow Recipes](/docs/recipes) for common automation patterns

Ready to try this? [Sign up free](https://socialneuron.com) and get 50 free credits to start.