Build with MCP. Verify every action.

Quick Start

For Claude Code, add the hosted HTTP endpoint and complete OAuth in the client. The local npm package is a separate fallback, not a second step in the hosted setup.

1. Add the endpoint: claude mcp add --transport http socialneuron https://mcp.socialneuron.com/mcp
2. Run /mcp, choose socialneuron, and complete browser authorization.
3. Begin read-only: verify the returned account and project context, granted scopes, connected-account readiness, and available tools.

For local or CI requirements, read the MCP quickstart before choosing device login or API-key authentication. For the hosted connector, use the Social Neuron MCP setup page.

OpenAI Codex hosted OAuth

1. Add the hosted server: codex mcp add socialneuron --url https://mcp.socialneuron.com/mcp
2. Request read-only access: codex mcp login socialneuron --scopes mcp:read
3. The authorization screen has no project chooser. It uses your current Social Neuron project when one is available; otherwise the grant has no default project.
4. After login, call get_account_status. Verify the returned default_project_id and granted scopes before any write.

If login returns invalid_grant, run codex mcp logout socialneuron, then run codex mcp login socialneuron --scopes mcp:read again.

Selected Tool Categories

• Ideation: project context, research, and draft planning
• Content Creation: video, image, script, and carousel generation
• Distribution: account-scoped scheduling and publishing operations
• Analytics and Insights: source-linked performance reads and recommendations
• Brand and Quality: project context and pre-publication review aids
• Planning and Approvals: content plans, review states, and scheduling boundaries

Inspect the live server card or OpenAPI document for the authoritative hosted catalog.

Pricing

MCP API access requires a Pro plan or higher. The 14-day trial includes read, write, distribute, and analytics MCP scopes with 300 credits; it does not include every paid MCP scope. Free and Starter plans do not include MCP/API access.

• Pro: $49/month — Read + Analytics + Write + Distribute MCP scopes, REST API, 1,500 credits, 2 keys
• Team: $99/month — Full MCP, REST API, multi-user, 3,500 credits, 5 keys
• Agency: $249/month — Full MCP, REST API, multi-brand, 10,000 credits, 20 keys

API Credit Packs start at $9.99 for 1,000 credits and are available from Settings > Billing after sign-in. Subscription and consumer add-on pricing is listed separately on the pricing page.

Authentication

Hosted OAuth is the recommended interactive path. Device login belongs to the local package flow, and API keys are intended for reviewed automation and CI environments. Never put a key in a public URL or repository.

Approval and External Proof

An OAuth scope allows a call to be attempted; it is not editorial approval. Keep initial tests read-only. Before any distribution call, record the exact artifact version, destination, approver, allowed action, and expiry. Treat a write as successful only when the external provider returns a durable receipt and final state.

REST API and machine-readable resources

The REST API is a typed projection of the same tool catalog. Read the REST API guide, inspect the live OpenAPI specification, or fetch the public tool listing before writing an integration.

• llms.txt — concise agent-readable site guide
• llms-full.txt — complete product and tool reference
• Protected-resource metadata — OAuth issuer and supported scopes
• Official npm CLI package — local and CI integrations

Self-serve access

Sign up without contacting sales and start the 14-day trial, which includes read, write, distribute, and analytics scopes. Generate API credentials from Settings > Developer. The OpenAPI document and public tool listing require no credential, so clients can validate discovery and schemas before making authenticated calls. Social Neuron does not currently advertise a separate public execution sandbox.