Skip to content
Conduit

mcp server

socials

Claude Code plugin + MCP server: connect Claude to the Socials browser extension for X, LinkedIn & Reddit (Agent Mode, local WebSocket bridge).

Brainrot-Creations/socialscommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • Node.js 20 or newer
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "socials": {
      "command": "npx",
      "args": [
        "-y",
        "@brainrotcreations/socials"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 21, 2026

Socials MCP

Give Claude superpowers on X, LinkedIn, and Reddit.

Install

  1. Install the Socials Chrome extension
  2. In Claude Code:
/plugin marketplace add Brainrot-Creations/plugins

/plugin install socials@brainrot-creations

/reload-plugins

Done. Talk to Claude naturally:

  • "Connect with 100 LinkedIn recruiters hiring for React roles"
  • "Find Reddit threads about note-taking and mention my app naturally"
  • "Reply to 50 X posts about indie hacking and promote my SaaS"

How it works

The MCP server runs locally and bridges Claude to your browser via a WebSocket connection to the Socials extension. All actions happen through your real browser session — no API keys, no rate limits.

Troubleshooting

  • Port 9847 in use — Kill stale node processes or set SOCIALS_MCP_RECLAIM_PORT=1
  • Extension not connecting — Open the Socials side panel, then reload
  • Tools not working — Make sure you're signed into Socials

Development

npm install
npm run build       # build dist/
npm run typecheck   # type check
npm run release:dry # preview a release without publishing

Use local MCP in plugin dev mode

  1. Build local MCP:
cd socials/mcp
npm run build
  1. Set dev mode in claude-plugins/plugins/socials/.mcp.json:
{
  "mcpServers": {
    "socials": {
      "env": {
        "SOCIALS_MCP_DEV_MODE": "1",
        "SOCIALS_MCP_DEV_MCP_PATH": "/absolute/path/to/socials/mcp/dist/index.cjs"
      }
    }
  }
}
  1. Restart Claude Code.

To switch back to published npm package, set "SOCIALS_MCP_DEV_MODE": "0" and restart.

Releases are automated via CI — push to main with [release:patch], [release:minor], or [release:major] in the commit message to fast-track publishing.

MIT License · Security · contact@brainrotcreations.com

↑↓ navigate openesc close