Social Neuron CLI Guide

The official @socialneuron/mcp-server npm package includes the socialneuron-mcp and sn command-line tools. Use them for local MCP connections, device-code authentication, scripted checks, and JSON-first CI/CD automation.

Install and inspect

Run npx -y @socialneuron/mcp-server --help to use the CLI without a global install. Run npx -y @socialneuron/mcp-server sn --help to list commands, or npx -y @socialneuron/mcp-server sn tools --json to inspect the local tool catalog.

Authentication

Use npx -y @socialneuron/mcp-server login --device for the recommended device-code flow, or configure an API key through the CLI setup command. Credentials are stored in the operating system keychain when available. Never commit keys to source control or pass them in a public URL.

Machine-readable output

Append --json to supported commands for stable JSON envelopes suitable for agents and automation. The CLI uses the same OAuth scopes, API limits, and credit pool as the hosted MCP and REST surfaces.

Developer resources

Developer Portal — quickstarts, API keys, scopes, and discovery resources
REST API guide — HTTP integration contract
OpenAPI specification — generated schema
npm package — published CLI and MCP server