Developer API
Social Neuron provides 60+ tools via the Model Context Protocol (MCP) server. Control the complete content lifecycle from Claude Code, Claude Desktop, or any MCP-compatible client using natural language.
Quick Start
1. Authenticate
npx -y @socialneuron/mcp-server login --devicebash
A browser window opens for authentication and the CLI receives your API key automatically.
2. Add to Claude Code
claude mcp add socialneuron -- npx -y @socialneuron/mcp-serverbash
3. Start Using
Ask Claude: "Generate 5 content ideas about sustainable fashion" -- Claude will use the registered MCP tools to execute the request.
API access requires a paid plan. Starter ($29/mo) includes Read + Analytics scopes. Pro and Team plans include full API access. See the MCP Quickstart for detailed setup instructions.
What You Can Do
Ask Claude things like:
- "Generate 5 content ideas about sustainable fashion for Gen Z"
- "Create a 30-second video ad for my product launch"
- "Schedule this image to Instagram and LinkedIn at 9am tomorrow"
- "Show me my best-performing content this month"
- "Set up autopilot to post 3 times per week"
Tool Categories
60+ tools across 20 modules covering the full content lifecycle:
| Category | Tools | What It Does |
|---|---|---|
| Ideation | 4 tools | AI-powered content ideas and trend research |
| Content | 6 tools | Video, image, voiceover, and carousel creation with 20+ AI models |
| Distribution | 5 tools | Multi-platform publishing, scheduling, and slot optimization |
| Analytics | 2 tools | Performance tracking across all platforms |
| Insights | 2 tools | Data-driven content optimization |
| Brand | 4 tools | Brand identity and voice management |
| Comments | 5 tools | Social engagement management |
| Planning | 5 tools | Content calendar and approval workflows |
| Autopilot | 3 tools | Automated content scheduling |
| Quality | 2 tools | Pre-publish content validation |
| Credits | 2 tools | Usage and budget tracking |
For the full tool reference with parameters and response schemas, see the MCP Tools API.
For the REST API reference, see the REST API.
Authentication Methods
| Method | Best For | How |
|---|---|---|
| Device Code (recommended) | Local development | npx @socialneuron/mcp-server login --device |
| Browser Flow | Environments with browser access | npx @socialneuron/mcp-server login |
| API Key Paste | CI/CD and automated workflows | npx @socialneuron/mcp-server login --paste |
API keys are stored securely in your OS keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service). They are never written to disk in plaintext.
See the Authentication Guide for full details.
Scopes
| Scope | Description |
|---|---|
mcp:full | All operations |
mcp:read | Read content, brand profiles, plans, settings |
mcp:write | Create and edit content, brand profiles, plans |
mcp:distribute | Schedule, publish, and manage posts |
mcp:analytics | Read analytics, insights, and performance data |
mcp:comments | Read, reply, moderate, and delete comments |
mcp:autopilot | Configure and manage automated scheduling |
Rate Limits
| Plan | Requests/Minute |
|---|---|
| Starter | 30 |
| Pro | 60 |
| Team | 120 |
Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response. Exceeding the limit returns HTTP 429.
Error Reference
| Code | Cause | Fix |
|---|---|---|
| 401 | API key expired or invalid | Re-authenticate with login --device |
| 402 | Insufficient credits | Purchase credits or upgrade plan |
| 403 | Missing required scope | Generate new key with correct scopes |
| 404 | Resource not found | Verify ID with a list operation first |
| 422 | Invalid parameters | Check parameter types in the MCP Tools API |
| 429 | Rate limited | Wait until X-RateLimit-Reset, then retry |
| 500 | Server error | Retry once; report if persistent |
Agent Discovery Resources
- system-prompt.txt -- Copy-pasteable agent protocol
- llms-full.txt -- Full product and API reference
- .well-known/ai-plugin.json -- Agent discovery manifest