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 guide is a setup walkthrough. Already connected? Jump to the API reference below.

ChatGPT App

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

Cursor

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

Claude Code

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

Claude

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

Codex

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

Gemini CLI

Gemini extension config for Google's CLI agent.
MCP

Any MCP Client

Generic HTTP MCP server works with any compliant client.
MCP

GPT Actions

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

REST / cURL

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

CLI

Terminal tool for brand data, metrics, and workflows.
CLI

Salesforce AgentForce

Consume the OpenAPI spec as an AgentForce action.
Coming soon

Google Agent Directory

List SocialCRM tools in the Google agent marketplace.
Coming soon

LangChain / CrewAI

Use the MCP client SDK to call tools from any framework.
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 GuideProtocol 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

OpenAPI

/api/mcp-app/openapi.json

Widget

Brand Snapshot — renders inside ChatGPT

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

Repair Estimator (Beta)

Repair Estimator API (Beta)

Other

Changelog

Don't see your platform?

If your framework speaks MCP or OpenAPI, it connects. Tell us which guide to write next.

Talk to us about MCPGitHub