Social Neuron REST API

The Social Neuron REST API is a typed HTTP projection of the same 91-tool catalog exposed by the hosted MCP server. Use it from curl, Python, JavaScript, Zapier, Make, CI/CD, or any other client that can send JSON over HTTPS.

Machine-readable contract

Base URL: https://mcp.socialneuron.com/v1
OpenAPI 3.1 specification — typed request and response schemas for every public operation
Public tool listing — names, descriptions, modules, and required scopes
OAuth protected-resource metadata — authorization server and supported scopes

Authentication and scopes

Read-only discovery endpoints are public. Tool execution requires an OAuth 2.1 access token or a Social Neuron API key. Request only the least-privilege scope needed: mcp:read, mcp:write, mcp:distribute, mcp:analytics, mcp:comments, or mcp:autopilot.

Calling a tool

Send a JSON body to POST /v1/tools/{name}. For example, POST /v1/tools/get_credit_balance uses the same input and output schema as the MCP tool. Every operation has a unique operationId, a description, typed parameters, and response schemas.

Errors and next steps

REST errors are JSON objects with a stable code, human-readable message, and recovery hint. Start with the Social Neuron Developer Portal, then use the MCP API guide or CLI guide for integration examples.