# Socials MCP

**Give Claude superpowers on X, LinkedIn, and Reddit.**



---

## Install

1. Load the Socials browser extension in your browser (companion app, distributed separately)
2. Build and run this MCP server from source (see [Development](#development) below)
3. Register the server with Claude Code by pointing your MCP config at `dist/index.cjs`

Then 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

```bash
npm install
npm run build       # build dist/
npm run typecheck   # type check
```

### Use local MCP in plugin dev mode

1. Build local MCP:

```bash
npm run build
```

1. Point your MCP client config at the local build:

```json
{
  "mcpServers": {
    "socials": {
      "env": {
        "SOCIALS_MCP_DEV_MODE": "1",
        "SOCIALS_MCP_DEV_MCP_PATH": "/absolute/path/to/dist/index.cjs"
      }
    }
  }
}
```

1. Restart Claude Code.

To switch back to the default bundled server, set `"SOCIALS_MCP_DEV_MODE": "0"` and restart.

---

[MIT License](./LICENSE) · [Security](./SECURITY.md) · [contact@brainrotcreations.com](mailto:contact@brainrotcreations.com)