Copy page

Developer

MCP Quickstart

The Social Neuron MCP server gives AI agents access to 92 tools for content creation, scheduling, analytics, and optimization. This guide starts with the hosted connector and then covers local CLI clients.

Recommended: the hosted connector (https://mcp.socialneuron.com/mcp). It signs in with OAuth — no API key, no Node.js — and it is the only transport that renders the interactive Content Calendar and Analytics Pulse MCP Apps inside Claude and ChatGPT. Use the npm/stdio install only for CLI-first setups or local development.

Prerequisites

• A Social Neuron account on a Pro plan or above, or an active 14-day trial. Trials include Read, Write, Distribute, and Analytics scopes, but not every paid MCP scope.
• For the hosted connector: nothing else. The currently published npm/stdio package supports Node.js 20.20.x or Node.js 22.22 and newer.

Option A: Hosted connector (Claude & ChatGPT — recommended)

Claude (claude.ai, Claude Desktop, mobile)

1. Open Settings → Connectors → Add custom connector
2. Paste the connector URL: https://mcp.socialneuron.com/mcp
3. Click Connect and sign in — pick your project and scopes on the consent page

The connector syncs across Claude web, desktop, and mobile. In a new chat, try: "What can Social Neuron do? Check my account status first." — then "Open my content calendar." to see the interactive calendar render in the conversation.

ChatGPT

1. Open Settings → Apps → Advanced → Developer mode (paid plans, web)
2. Create an app with the MCP URL: https://mcp.socialneuron.com/mcp
3. Sign in with OAuth when prompted

Claude Code (hosted, no API key)

Code
claude mcp add --transport http socialneuron https://mcp.socialneuron.com/mcp

Then run /mcp inside Claude Code and pick socialneuron to sign in. (Claude Code renders text summaries rather than the interactive apps.)

Option B: npm / stdio (CLI clients & local dev)

Step 1: Authenticate

Code
npx -y @socialneuron/mcp-server login --device

This opens your browser to authorize access. After you approve, the CLI receives your API key automatically and stores it in your OS keychain.

Step 2: Add to your client

Claude Code (local stdio)

Code
claude mcp add socialneuron -- npx -y @socialneuron/mcp-server

Claude Desktop (local stdio)

Prefer the hosted connector above (Settings → Connectors). For a local stdio install instead, add to your claude_desktop_config.json:

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

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

VS Code

Add to .vscode/mcp.json in your workspace:

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

Cursor

Add to .cursor/mcp.json in your workspace:

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

Start Using

Ask Claude things like:

• "What content should I post this week?"
• "Generate 5 content ideas about sustainable fashion for Gen Z"
• "Schedule my latest video to YouTube and TikTok"
• "Show me my best-performing content this month"
• "Check my analytics and suggest improvements"

CLI Reference

After global install (npm i -g @socialneuron/mcp-server), you can use the socialneuron-mcp command directly. Otherwise, prefix with npx @socialneuron/mcp-server.

Code
# Authentication
socialneuron-mcp login --device     # Device code flow (recommended)
socialneuron-mcp login              # Browser OAuth flow
socialneuron-mcp login --paste      # Paste API key manually
socialneuron-mcp logout             # Clear stored credentials

# Quick commands (no LLM needed)
socialneuron-mcp sn credits         # Check credit balance
socialneuron-mcp sn posts --days 7  # Recent posts
socialneuron-mcp sn usage           # API usage breakdown
socialneuron-mcp sn info            # Version, auth, credits, tool count
socialneuron-mcp sn tools           # List all available tools

# Interactive mode
socialneuron-mcp repl               # Start interactive REPL

Add --json to any command for machine-readable output.

Troubleshooting

Authentication fails

Make sure you have a Pro plan or above, or an active trial. Free and Starter plans do not include API access.

"Command not found" after install

Use npx @socialneuron/mcp-server instead of socialneuron-mcp, or install globally with npm i -g @socialneuron/mcp-server.

Windows credential storage

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.

Next Steps

• Authentication Guide -- OAuth2, scopes, and security details
• Credit System -- How credits work and cost per operation
• Workflow Recipes -- Common multi-step automation patterns
• MCP Tools API -- Full tool reference with parameters and schemas