Instant Reply MCP

Conecte agentes de IA às caixas de entrada do Instagram, WhatsApp Business e Messenger, sujeito ao acesso do workspace e aos limites do plano.

GitHubExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://api.instantreply.co/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Servidor MCP Instant Reply para agentes de IA do WhatsApp, Instagram e Messenger

O Instant Reply MCP conecta Claude, ChatGPT, Cursor, Claude Code ou qualquer agente compatível com MCP a uma caixa de entrada social real. O agente pode parear um workspace no navegador, responder perguntas com Barq, auditar conversas, qualificar leads, validar modelos do WhatsApp e operar fluxos de trabalho aprovados.

Nenhuma chave de API é necessária para a primeira execução. Instale-o, diga ao seu agente para conectar o Instant Reply e siga o link de pareamento no navegador.

Instalação para um agente de IA

Claude Code, Claude Desktop, Cursor, Windsurf ou Zed

Adicione este servidor à configuração MCP do cliente e reinicie ou reconecte:

{
  "mcpServers": {
    "instantreply": {
      "command": "npx",
      "args": ["-y", "@instantreply.co/mcp"]
    }
  }
}

Se você já tiver uma chave de API do Instant Reply, passe-a como uma variável de ambiente:

{
  "mcpServers": {
    "instantreply": {
      "command": "npx",
      "args": ["-y", "@instantreply.co/mcp"],
      "env": { "INSTANTREPLY_API_KEY": "ir_live_..." }
    }
  }
}

ChatGPT e outros clientes MCP remotos

Use a URL do conector remoto:

https://api.instantreply.co/mcp

O servidor remoto anuncia OAuth 2.1 com PKCE. Um usuário aprova o acesso na página de consentimento do Instant Reply; o cliente não precisa de uma chave de API copiada manualmente.

Diga ao seu agente o que fazer

Após a instalação, envie uma solicitação em linguagem natural, como:

Connect InstantReply for my business. Use the developer persona, pair my Instagram and WhatsApp accounts if eligible, and then tell me what is ready and what Meta still requires.

Para uma conexão existente:

Audit my conversations from the last 30 days. Identify high-intent leads, explain the signals, draft a compliant follow-up for each segment, estimate WhatsApp costs, and ask me before sending anything.

O agente deve seguir esta sequência de configuração:

Chame get_connection_guide antes de recomendar um canal ou caminho de configuração.
Se nenhuma chave estiver disponível, chame start_setup com o canal e a persona solicitados: creator, business, developer ou agency.
Mostre ao usuário a URL de pareamento e o código curto. Nunca peça ao usuário para colar um segredo no chat.
Chame check_setup até que a aprovação no navegador seja concluída e, em seguida, reconecte com a chave armazenada.
Chame get_developer_capabilities, get_developer_onboarding e get_developer_limits para que a resposta reflita o workspace, o plano, os escopos e os canais conectados.
Valide modelos, jornadas e elegibilidade do destinatário antes de qualquer envio. Peça confirmação explícita antes de uma ação destrutiva ou cobrável.
Use recommend_plan quando o usuário estiver escolhendo um plano; explique a opção mais barata e qualquer dependência de aprovação da Meta.

A chave de pareamento do dispositivo é salva localmente em ~/.instantreply/config.json. Defina INSTANTREPLY_API_KEY explicitamente para CI, Docker, máquinas compartilhadas ou implantações determinísticas.

O que o agente pode fazer

Trabalho de caixa de entrada: liste e inspecione conversas, mensagens, contatos, canais, análises e uso.
Assistência Barq: faça perguntas sobre produtos e workspaces com ask_barq; use ferramentas de aprovação para fluxos de trabalho baseados em terminal.
Inteligência de leads: audite conversas recentes, encontre sinais de compra, segmente contatos, rascunhe acompanhamentos personalizados e estime o custo da campanha.
Operações do WhatsApp: valide, crie, envie, inspecione e exclua modelos; valide jornadas; acione jornadas individuais ou em lote; inspecione falhas de entrega.
Operações de desenvolvimento: inspecione capacidades, requisitos de integração, limites, adequação do plano e orientação de solução de problemas.
Segurança: ferramentas que alteram o estado são marcadas como destrutivas para que um cliente cuidadoso possa solicitar confirmação primeiro.

O pacote atualmente expõe 34 ferramentas, 11 prompts reutilizáveis e recursos de conversa/contato. O esquema exato da ferramenta é a fonte da verdade; as descrições são escritas para que os agentes escolham a ferramenta certa sem adivinhar.

Requisitos de canal e Meta

A disponibilidade do Instagram, Messenger e WhatsApp depende do plano do workspace, escopos, ativos conectados e estado de aprovação da Meta. Os recursos da API do WhatsApp Business podem exigir Verificação de Negócios da Meta, uma Conta Comercial do WhatsApp conectada, modelos aprovados e configuração de cobrança da Meta. O agente deve chamar get_connection_guide e inspecionar a prontidão em vez de prometer que todos os recursos do WhatsApp estão imediatamente disponíveis.

O Instant Reply usa fluxos de trabalho oficiais conectados à Meta. Não use o servidor MCP para enviar mensagens não solicitadas, contornar o consentimento ou evadir as regras de modelo e janela de mensagens da Meta.

Planos e acesso

Não codifique direitos de plano em um prompt de agente. Preços, elegibilidade do WhatsApp, escopos de API, cotas e status de teste podem mudar. Use recommend_plan, get_developer_capabilities e get_developer_limits e, em seguida, vincule o usuário aos preços atuais.

Todo plano pago atualmente começa com um teste de 10 dias sem cartão. As taxas de conversa da Meta, requisitos de aprovação e limitações de canal conectado são separados do preço da assinatura do Instant Reply.

Variáveis de ambiente

Variável	Padrão	Finalidade
`INSTANTREPLY_API_KEY`	nenhum	Pular o pareamento no navegador e autenticar diretamente
`INSTANTREPLY_API_URL`	`https://api.instantreply.co`	Apontar o cliente para outro ambiente

Desenvolvimento

npm install
npm run build   # compile dist/
npm test        # run the MCP test suite
npm run dev     # watch mode

Antes de publicar, execute npm test, npm run build e valide server.json com as ferramentas oficiais do MCP Registry. Mantenha package.json, package-lock.json, server.json, o README e a cópia do backend MCP incluída na mesma versão de lançamento.

Licença

MIT