MCP Integrations

Cursor

Connect SocialCRM to Cursor as an MCP server.

Connect SocialCRM to Cursor as an MCP server. Query brand profiles, visibility metrics, and trigger optimization workflows from your editor.

Prerequisites

  • Cursor installed
  • Node.js 18+
  • SocialCRM account with API key (get one from Settings > API Keys)

Quick Start

1. Authenticate

npx socialcrm auth sk_live_YOUR_KEY

Saves your API key to ~/.socialcrm/config.json with 600 permissions.

2. Connect to Cursor

npx socialcrm init --cursor

This creates .cursor/mcp.json in your project root with the SocialCRM MCP server config.

3. Restart Cursor

Fully close and restart Cursor. Wait 3–5 seconds for the MCP server to connect. You should see 21 tools available in Cursor's tool panel.

What You Can Ask

Once connected, ask Cursor questions in natural language. Cursor translates these into SocialCRM API calls automatically:

  • "List my brand profiles"
  • "What is my visibility score on ChatGPT and Claude?"
  • "Get recent mentions of Acme across all platforms"
  • "Run the AI Citation Builder workflow for brand_456"
  • "Check my credit balance and workflow history"

Config File

The init --cursor command writes this to .cursor/mcp.json:

{
  "mcpServers": {
    "socialcrm": {
      "url": "https://socialcrm.com/api/mcp-app",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_KEY"
      }
    }
  }
}

You can also create or edit this file manually.

Troubleshooting

Tools not showing in Cursor — Fully close and restart Cursor (not just reload). Wait 3–5 seconds for the MCP server to connect. Check Cursor's MCP panel for connection status.

Authentication error — Run npx socialcrm auth again with a fresh API key. Verify the key hasn't expired in Settings > API Keys.

Verify connection — Run npx socialcrm status to confirm the CLI can reach the MCP server and your key is valid.

Config file not created — Make sure you're in a project root directory. The .cursor directory must exist or be creatable. If Cursor hasn't created it yet, create it manually: mkdir .cursor.