npx socialcrm

Connect SocialCRM to any agent

One MCP server, one OpenAPI spec, 28 tools. Pick how your agent connects.

Coming soon: SocialCRM as a native ChatGPT app with OAuth account linking, the Brand Snapshot widget, and all 28 tools inside ChatGPT. Available now via connector URL. View setup guide

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.

ChatGPT App

Coming SoonMCP

Coming soon to the ChatGPT app store. Available now via connector URL with OAuth linking, the Brand Snapshot widget, and the current tool catalog.

View setup guide

Cursor

MCP

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

View setup guide

Claude Code

MCP

MCP server config for the Claude Code CLI (.mcp.json).

View setup guide

Claude

MCP

OAuth custom connector for analytics, prompt sets, workflows, and reusable agents.

View setup guide

Codex

MCP

Step-by-step MCP setup for the Codex desktop app.

View setup guide

Gemini CLI

MCP

Gemini extension config for Google's CLI agent.

View setup guide

Any MCP Client

MCP

Generic HTTP MCP server works with any compliant client.

View setup guide

GPT Actions

OpenAPI

Legacy path. Import the OpenAPI spec into a Custom GPT if you need API-key-based access.

View setup guide

REST / cURL

REST

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

View setup guide

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

Three ways to connect

Use ChatGPT with OAuth, or generate an API key in Settings > API Keys for MCP and REST access:

ChatGPT

No API key needed

ChatGPT (zero config — coming soon)
1. Add SocialCRM via connector URL: https://socialcrm.com/mcp
2. Ask: "Show me a brand snapshot for [your brand]"
3. Approve the OAuth consent -> widget renders inline

Coming soon to the ChatGPT app store. Until the listing is live, paste the connector URL in ChatGPT developer mode.

MCP (recommended)

$ npx socialcrm auth sk_live_YOUR_KEY
$ npx socialcrm init
✔ Detected Cursor — wrote .cursor/mcp.json
✔ 28 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 Guide Protocol Reference

At a glance

Protocol

JSON-RPC 2.0 / MCP-compatible

REST

Per-tool endpoints + OpenAPI 3.1 spec

Auth

OAuth 2.1 (ChatGPT) · API key (all others)

Tools

28 — brand data, metrics, insights, workflows

Server

https://socialcrm.com/mcp