SetSmart

io.github.setsmart-git由 GitHub 账号 setsmart-git 发布v0.1.2更新于 Oct 25, 2026

Instagram, WhatsApp and Messenger DMs through official Meta Business APIs.

已验证Streamable HTTP可网页运行沟通与协作商业与电商

概览

AI 生成的概览

SetSmart 通过官方 Meta API 让助手接入 Instagram、WhatsApp 和 Messenger 商务消息，可读取会话并发送消息或打标签。

可以做什么
在 Instagram、WhatsApp 或 Messenger 会话中发送文本、图片、视频、语音、模板消息和表情回应。列出、搜索并读取会话，添加或移除标签，写入内部备注。查找、读取、导入联系人并管理联系人标签。按会话或按渠道暂停或恢复 AI 助手。列出 Instagram 帖子和评论触发规则，列出并取消定时消息，列出模板并读取会话统计。
适用场景
适合通过 SetSmart 工作区在 Instagram、WhatsApp 或 Messenger 上处理客户会话的团队，希望助手起草、发送和整理回复、转交人工处理或获取基本消息统计时使用。
运行要求
可使用带交互式 OAuth 的远程端点，或在本地以 Node.js 18 或更高版本运行 npm 包 setsmart-mcp。需要一个至少连接一个渠道的 SetSmart 工作区，并通过 SETSMART_API_KEY 提供工作区 API 密钥；可选 SETSMART_MCP_URL 覆盖上游端点。
安装前请注意
API 密钥是长期有效的静态密钥，可访问真实消息账号；在 SetSmart 设置中轮换密钥可立即撤销访问。助手能向真实客户发送消息、创建联系人、修改标签和备注、取消定时消息以及暂停 AI 处理，使用前请确认。消息和联系人数据会经过 SetSmart 托管服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 SetSmart，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.setsmart-git%2Finstagram-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "setsmart": {
      "type": "http",
      "url": "https://setsmart.io/api/mcp"
    }
  }
}

README

[SetSmart]

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):

json
{  "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

ToolWhat it does
message_send_textSend a text message on Instagram, WhatsApp or Messenger
message_send_imageSend an image
message_send_videoSend a video
message_send_audioSend a voice message
message_send_templateSend an approved WhatsApp template
message_send_reactionReact to a message

Conversations

ToolWhat it does
conversation_listList conversations in the workspace
conversation_searchSearch conversations by name, number or content
conversation_getRead one conversation and its status
conversation_get_messagesRead the message history
conversation_add_tagTag a conversation
conversation_remove_tagRemove a tag
conversation_set_notesWrite internal notes

Contacts

ToolWhat it does
contact_findFind a contact by phone, email, Instagram username or tag
contact_getRead one contact
contact_importCreate a contact
contact_add_tagsAdd tags
contact_remove_tagsRemove tags

AI control

ToolWhat it does
ai_get_all_statusSee where the AI assistant is active
ai_pause_conversationStop the assistant on one conversation, for a human handover
ai_resume_conversationHand it back to the assistant
ai_pause_channelPause a whole channel
ai_resume_channelResume a channel

Instagram

ToolWhat it does
instagram_post_listList the account's posts
instagram_post_get_triggersRead the comment triggers on a post
comment_reply_get_auto_replyRead the automatic comment reply setup

Scheduling, templates and stats

ToolWhat it does
scheduled_listList messages scheduled but not sent
scheduled_cancelCancel a scheduled message
template_listList message templates
analytics_statsRead 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

VariableDefaultPurpose
SETSMART_API_KEYrequiredYour workspace API key
SETSMART_MCP_URLhttps://setsmart.io/api/mcpOverride 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

来源：README.md，提交 d41fd7f

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分