setsmart-mcp

Instagram MCP Server (also WhatsApp and Messenger)

An MCP server that lets Claude, Cursor, Claude Code and any other MCP client read and reply to Instagram DMs, WhatsApp messages and Facebook Messenger conversations, through the official Meta Business APIs.

Ask your assistant to "find the lead who asked about pricing on Instagram and send them the booking template", and it happens on the real account.

Why this one is different

Most Instagram and WhatsApp MCP servers drive a personal account: a browser automation session, an unofficial bridge, or a reverse engineered mobile API. They break when Meta changes something, and they put the account at risk of being disabled.

This one talks to the official Instagram Messaging API, WhatsApp Cloud API and Messenger Platform, through SetSmart's Meta-approved Business app. Messaging Instagram, WhatsApp or Messenger programmatically is not possible without an approved app, which is why this bridge requires a SetSmart workspace rather than your Instagram password.

That is the tradeoff, stated plainly: it is not self-hostable against your own account, and it needs a SetSmart API key.

Requirements

• Node.js 18 or newer
• A SetSmart workspace with at least one channel connected (Instagram, WhatsApp or Messenger)
• Your workspace API key, from Settings then Integrations

Quick start

Claude Desktop / Claude Code

Add this to your MCP config (claude_desktop_config.json, or .mcp.json for Claude Code):

{
  "mcpServers": {
    "setsmart": {
      "command": "npx",
      "args": ["-y", "setsmart-mcp"],
      "env": {
        "SETSMART_API_KEY": "your-workspace-api-key"
      }
    }
  }
}

Cursor

Same block, in ~/.cursor/mcp.json.

Remote MCP, without this bridge

The SetSmart MCP server is also reachable directly over Streamable HTTP with OAuth, so clients that support remote MCP can skip this package entirely:

https://setsmart.io/api/mcp

Use this bridge when your client only speaks stdio, or when you would rather authenticate with a static API key than an interactive OAuth consent.

Tools

30 tools, grouped by what they touch.

Messaging

Tool	What it does
message_send_text	Send a text message on Instagram, WhatsApp or Messenger
message_send_image	Send an image
message_send_video	Send a video
message_send_audio	Send a voice message
message_send_template	Send an approved WhatsApp template
message_send_reaction	React to a message

Conversations

Tool	What it does
conversation_list	List conversations in the workspace
conversation_search	Search conversations by name, number or content
conversation_get	Read one conversation and its status
conversation_get_messages	Read the message history
conversation_add_tag	Tag a conversation
conversation_remove_tag	Remove a tag
conversation_set_notes	Write internal notes

Contacts

Tool	What it does
contact_find	Find a contact by phone, email, Instagram username or tag
contact_get	Read one contact
contact_import	Create a contact
contact_add_tags	Add tags
contact_remove_tags	Remove tags

AI control

Tool	What it does
ai_get_all_status	See where the AI assistant is active
ai_pause_conversation	Stop the assistant on one conversation, for a human handover
ai_resume_conversation	Hand it back to the assistant
ai_pause_channel	Pause a whole channel
ai_resume_channel	Resume a channel

Instagram

Tool	What it does
instagram_post_list	List the account's posts
instagram_post_get_triggers	Read the comment triggers on a post
comment_reply_get_auto_reply	Read the automatic comment reply setup

Scheduling, templates and stats

Tool	What it does
scheduled_list	List messages scheduled but not sent
scheduled_cancel	Cancel a scheduled message
template_list	List message templates
analytics_stats	Read conversation and reply stats

What it deliberately cannot do

An API key is a long lived static secret, so it gets a restricted surface. These are reachable through interactive OAuth on the remote server, never through this bridge:

• billing and subscription changes
• workspace settings
• connecting or disconnecting a channel
• creating or rewriting AI assistants
• bulk deletion, blacklists, blocked countries

Rotating the key in your SetSmart settings revokes access immediately, on the next request.

Configuration

Variable	Default	Purpose
SETSMART_API_KEY	required	Your workspace API key
SETSMART_MCP_URL	https://setsmart.io/api/mcp	Override the upstream endpoint

How it works

This package contains no messaging logic. It is a stdio to Streamable HTTP pipe: your client speaks MCP over stdin and stdout, the bridge forwards each request to the hosted SetSmart MCP server with your key in the Authorization header, and streams the answer back. Around 150 lines, in src/index.js, so you can read all of it before trusting it with an account.

Links

• SetSmart
• REST API documentation
• Model Context Protocol

License

MIT