ReplyAtlas README

ReplyAtlas MCP Server

Manage your ReplyAtlas account from Claude, Cursor or any Model Context Protocol client: Instagram comment-to-DM automations, leads, analytics, conversations and broadcasts.

ReplyAtlas auto-sends an Instagram DM to anyone who comments a keyword on your posts, Reels, Lives or story replies, using Instagram's official API. This server lets an AI assistant run that account for you: "create an automation that DMs my free guide to everyone who comments GUIDE", "who were my hottest leads this week?", "export leads tagged webinar".

Requires a ReplyAtlas plan with API access. Create an API key in ReplyAtlas → Settings → API Keys.

Install

No install needed. Your MCP client runs it with npx (Node.js 18+).

Claude Desktop (`claude_desktop_config.json`)

config.json

{
  "mcpServers": {
    "replyatlas": {
      "command": "npx",
      "args": ["-y", "replyatlas-mcp"],
      "env": { "REPLYATLAS_API_KEY": "mf_live_your_key_here" }
    }
  }
}

Cursor (`~/.cursor/mcp.json`)

config.json

{
  "mcpServers": {
    "replyatlas": {
      "command": "npx",
      "args": ["-y", "replyatlas-mcp"],
      "env": { "REPLYATLAS_API_KEY": "mf_live_your_key_here" }
    }
  }
}

Claude Code

Terminal

claude mcp add replyatlas -e REPLYATLAS_API_KEY=mf_live_your_key_here -- npx -y replyatlas-mcp

Config

Env var	Required	Default	Notes
`REPLYATLAS_API_KEY`	yes	—	Your `mf_live_…` API key.
`REPLYATLAS_BASE_URL`	no	`https://replyatlas.com`	Override the API host.

On start the server calls /api/v1/me to check the key and exits with a clear message if the key is invalid or the plan has no API access.

Tools

Area	Tools
Account	`get_account`, `list_ig_accounts`
Automations	`list_automations`, `get_automation`, `create_automation`, `update_automation`, `delete_automation`
Leads	`list_leads`, `get_lead`, `list_tags`, `tag_lead`, `export_leads`
Analytics	`get_dashboard`, `get_analytics`, `list_dm_logs`
Conversations	`list_conversations`, `reply_to_conversation`
Broadcasts	`list_broadcasts`, `create_broadcast`, `send_broadcast`

Safety

Anything that messages real people is two-step. reply_to_conversation and send_broadcast first return a preview and a confirmToken; nothing is sent until the tool is called again with that token. The server only talks to the ReplyAtlas REST API over HTTPS with your API key. It never sees your Instagram password or tokens.

Development

bash

pnpm install
pnpm test        # vitest
pnpm build       # tsup → dist/index.js

License

MIT