SetSmart
Instagram, WhatsApp and Messenger DMs through official Meta Business APIs.
Que pouvez-vous faire avec SetSmart ?
- billing and subscription changes
- workspace settings
- connecting or disconnecting a channel
- creating or rewriting AI assistants
- bulk deletion, blacklists, blocked countries
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http setsmart 'https://setsmart.io/api/mcp'{
"mcpServers": {
"setsmart": {
"type": "http",
"url": "https://setsmart.io/api/mcp"
}
}
}setsmart-mcpclaude mcp add setsmart -e 'SETSMART_API_KEY=<your setsmart_api_key>' -- npx -y setsmart-mcp@0.1.1{
"mcpServers": {
"setsmart": {
"command": "npx",
"args": [
"-y",
"setsmart-mcp@0.1.1"
],
"env": {
"SETSMART_API_KEY": "<your setsmart_api_key>"
}
}
}
}Variables d'environnement
SETSMART_API_KEYobligatoire secret Your SetSmart workspace API key, from Settings then Integrations
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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/mcpUse 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 |
| 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
License
MIT
Questions fréquentes
Qu'est-ce que SetSmart ?
Instagram, WhatsApp and Messenger DMs through official Meta Business APIs.
Comment installer SetSmart ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http setsmart 'https://setsmart.io/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour SetSmart ?
Oui. Il attend SETSMART_API_KEY, à renseigner dans sa configuration.
SetSmart est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient SetSmart ?
Il est publié par setsmart-git. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.