npx socialcrm

Connect SocialCRM to any agent

One MCP server, one OpenAPI spec, 21 tools. Pick how your agent connects — we handle the rest.

MCP (JSON-RPC 2.0)OpenAPI 3.1REST endpointsCLI

Integrations

How does your agent connect?

Each card links to a setup guide. Already connected? Jump to the API reference below.

Cursor

MCP

Auto-configures .cursor/mcp.json with one command.

View setup guide

Claude Code

MCP

MCP server config for Claude Code and Claude Desktop.

View setup guide

Gemini CLI

MCP

Gemini extension config for Google's CLI agent.

View setup guide

ChatGPT

OpenAPI

Import the OpenAPI spec as a Custom GPT Action.

View setup guide

Any MCP Client

MCP

Generic HTTP MCP server works with any compliant client.

View setup guide

REST / cURL

REST

Per-tool REST endpoints and JSON-RPC 2.0 directly.

View setup guide

CLI

CLI

Terminal tool for brand data, metrics, and workflows.

View setup guide

Salesforce AgentForce

OpenAPI

Consume the OpenAPI spec as an AgentForce action.

Guide coming soon

Google Agent Directory

Coming soon

List SocialCRM tools in the Google agent marketplace.

Guide coming soon

LangChain / CrewAI

MCP

Use the MCP client SDK to call tools from any framework.

Guide coming soon

Quick start

Make your first API call

Generate an API key in Settings > API Keys, then pick your method:

MCP (recommended)

$ npx socialcrm auth sk_live_YOUR_KEY
$ npx socialcrm init
✔ Detected Cursor — wrote .cursor/mcp.json
✔ 21 tools available

REST / cURL

curl -X POST https://socialcrm.com/api/mcp-app \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"1","method":"tools/call",
       "params":{"name":"list_brand_profiles","arguments":{}}}'
Authentication GuideProtocol Reference

At a glance

Protocol

JSON-RPC 2.0 / MCP-compatible

REST

Per-tool endpoints + OpenAPI 3.1 spec

Auth

Bearer token (sk_live_...)

Tools

21 — brand data, metrics, insights, workflows

Server

https://socialcrm.com/api/mcp-app

OpenAPI

/api/mcp-app/openapi.json

Reference

API documentation

Grouped by what you need to do next. Each doc works as a standalone guide.

🔑

Getting Started

Authentication, JSON-RPC 2.0 Protocol, Errors & Rate Limiting

🔧

Tool Reference

Tools Overview, list_brand_profiles, get_brand_profile, ...

🔌

MCP Integrations

CLI (npx socialcrm), Cursor, Claude Code, ...

🌐

OpenAPI / REST Integrations

ChatGPT Actions, OpenAPI Consumers

📋

Other

Changelog

Don't see your platform?

SocialCRM speaks MCP and OpenAPI. If your agent framework supports either protocol, it already works. Need a specific integration guide? Let us know.

See the full MCP pitch GitHub