instantKOM MCP Server
instantKOM/mcp-server
MCP server para automação completa da plataforma instantKOM via Claude
Ver no GitHubServidor Model Context Protocol que integra a API REST da instantKOM ao Claude e assistentes IA. Oferece 230+ ferramentas para gerenciar canais, contatos, mensagens, newsletters, bots, fluxos e análises diretamente via chamadas estruturadas e type-safe.
Instalação
npx convez-ai instantKOM/mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de campanhas de newsletter para segmentos específicos
- Gerenciamento de contatos e canais multicanal via Claude
- Criação e execução de fluxos de automação e bots conversacionais
- Consulta de KPIs e analytics de broadcasts em tempo real
Veredito

MCP server maduro e bem documentado que expõe a plataforma instantKOM de forma completa ao ecossistema Claude. Ideal para empresas que usam instantKOM e querem delegar automação de comunicação a assistentes IA, com autenticação segura e cobertura abrangente de recursos.
README
A tradução para o português deste README ainda está na fila.
instantKOM MCP-Server
Model Context Protocol (MCP) server for the instantKOM REST API. Lets AI assistants like Claude Code and Claude Desktop drive your instantKOM messengerzentrale through structured, type-safe tool calls.
Features
- 230+ tools covering full CRUD for Channels, Contacts, Messages, Newsletters, Bots, Flows, Analytics and more
- Type-safe — written in TypeScript, runs on Node.js 18+
- Bearer-token auth via your instantKOM API key
- Standardized — implements the official Model Context Protocol
- MIT-licensed — self-hosted use is welcome
Quick start
1. Get an API key
- Sign up at instantkom.app
- Settings → API Keys → create a new key
- Copy the key (format:
ik_live_...)
2. Configure your MCP client
Add to your Claude Code / Claude Desktop config:
Claude Code: project-local .mcp.json or ~/.config/claude/claude_desktop_config.json
Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"instantkom": {
"command": "npx",
"args": ["-y", "@instantkom/mcp-server"],
"env": {
"INSTANTKOM_API_KEY": "ik_live_..."
}
}
}
}
3. Restart your client
Claude will now see the instantkom MCP server with all available tools.
Configuration
| Environment variable | Description | Default |
|---|---|---|
INSTANTKOM_API_KEY | Bearer token for the instantKOM API (required) | — |
INSTANTKOM_API_URL | Override API base URL | https://api.instantkom.app |
LOG_LEVEL | error / warn / info / debug | info |
Tool overview
Tools are grouped by resource type. Each REST endpoint at api.instantkom.app/api-docs has a corresponding MCP tool.
| Category | Examples | Tools |
|---|---|---|
| Channels | list_channels, create_channel, update_channel | 7 |
| Contacts | list_contacts, create_contact, update_contact | 5 |
| Messaging | send_message, list_messages, get_message | 10 |
| Newsletters / Broadcasts | list_broadcasts, create_broadcast, send_broadcast | 6 |
| Bots & Flows | bot CRUD, flow nodes, flow edges | 38 |
| Templates & Tags | template + tag CRUD, tag assignment | 21 |
| Analytics | dashboard, broadcast, contact, message KPIs | 5 |
| Segmentation & QR | segmentation CRUD, QR codes, shortlinks | 13 |
| Tickets / Webhooks / Polls / Events / Media / Custom Fields / ... | full CRUD | 100+ |
Examples
Once configured, you can prompt Claude in natural language:
> Send a newsletter to all "Premium" segment contacts.
⏺ I'll create the newsletter via WhatsApp.
⤷ create_broadcast(channel: "whatsapp", segment: "premium")
↳ 247 recipients · sending now.
⏺ Done. Sent to 247 Premium contacts. Show live analytics?
Development
git clone https://github.com/instantKOM/mcp-server.git
cd mcp-server
npm install
npm run build
INSTANTKOM_API_KEY=ik_live_... node dist/index.public.js
To wire up your local build with Claude Code instead of npm:
{
"mcpServers": {
"instantkom": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/dist/index.public.js"],
"env": {
"INSTANTKOM_API_KEY": "ik_live_..."
}
}
}
}
Security
- API keys are passed as Bearer tokens. Treat them as secrets.
- All API calls go over HTTPS to
api.instantkom.appby default. - The MCP server runs locally on your machine — no instantKOM data passes through any third-party host.
- Audit log of every tool call is recorded server-side in your instantKOM account.
Resources
- API Documentation: https://api.instantkom.app/api-docs
- MCP Protocol Spec: https://modelcontextprotocol.io
- API Code Examples: https://github.com/instantKOM/api-examples
- Issues / Feature Requests: https://github.com/instantKOM/mcp-server/issues
License
MIT — see LICENSE.
About instantKOM
instantKOM is a multi-channel messenger platform for B2B marketing and customer communication. WhatsApp, Telegram, Signal, Threema, SMS — DSGVO-compliant, hosted in Germany. Learn more at instantkom.app.