nodus-mcp

MCP (Model Context Protocol) server for the Nodus Platform — an omnichannel customer service platform with AI-powered bot automation.

This package allows Claude Code (and any MCP-compatible client) to manage the entire Nodus platform: conversations, contacts, channels, bot flows, analytics, broadcasts, and more.

Quick Start

1. Install

npm install -g nodus-mcp

2. Get your API token

1. Log in to Nodus
2. Go to Settings > API Keys
3. Create a new key with the scopes you need
4. Copy the ndk_* token

3. Configure Claude Code

Add to your .mcp.json (project root or ~/.claude/.mcp.json for global):

{
  "mcpServers": {
    "nodus-platform": {
      "command": "npx",
      "args": ["-y", "nodus-mcp"],
      "env": {
        "NODUS_URL": "https://api-nodus.zek.app.br",
        "NODUS_TOKEN": "ndk_your_token_here"
      }
    }
  }
}

4. Use it

Open Claude Code and start managing your Nodus platform:

"List all open conversations"
"Create a new queue called 'VIP Support'"
"Show analytics for the last 30 days"
"Create a bot flow that greets the customer and asks their name"

Available Tools (100+)

| Category | Tools | Description | |----------|-------|-------------| | Auth | 2 | Login, whoami | | Conversations | 8 | List, detail, messages, assign, transfer, close | | Contacts | 9 | CRUD, notes, search | | Channels | 7 | CRUD, test connection, sync WhatsApp templates | | Queues | 7 | CRUD, members management | | Users | 5 | List, invite, update, delete | | Bot Flows | 10 | CRUD, publish, validate, versions, import BLiP, simulator | | Analytics | 5 | Overview, daily stats, agents, channels, dashboard | | Broadcasts | 4 | CRUD, send campaigns | | Tags | 6 | CRUD, attach/detach to contacts/conversations | | Knowledge Base | 8 | CRUD, documents, semantic search (RAG) | | Settings | 6 | Tenant config, branding, AI provider settings | | SLA | 4 | CRUD policies | | CSAT | 3 | Config, satisfaction stats | | Business Hours | 6 | CRUD, holiday exceptions | | Contact Lists | 7 | CRUD, members | | Webhooks | 6 | CRUD, test delivery | | Canned Responses | 4 | CRUD quick replies | | Scheduled Messages | 3 | CRUD | | Search | 2 | Global search, audit logs | | Simulator | 4 | Test bot flows interactively |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | NODUS_URL | No | API base URL (default: https://api-nodus.zek.app.br) | | NODUS_TOKEN | Yes | API token (ndk_*) from Settings > API Keys |

Self-Hosted

If you're running Nodus on your own infrastructure:

{
  "mcpServers": {
    "nodus-platform": {
      "command": "npx",
      "args": ["-y", "nodus-mcp"],
      "env": {
        "NODUS_URL": "https://your-api-domain.com",
        "NODUS_TOKEN": "ndk_your_token"
      }
    }
  }
}

Development

git clone https://github.com/zek-tecno/nodus-mcp.git
cd nodus-mcp
npm install
npm run dev

License

MIT