{"_id":"@akson/mcp-chatsuite","_rev":"6-de95bd2e11a190d51b33f915d345f219","name":"@akson/mcp-chatsuite","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@akson/mcp-chatsuite","version":"1.0.0","keywords":["mcp","chatsuite","whatsapp","automation","api","claude"],"author":{"name":"Akson"},"license":"MIT","_id":"@akson/mcp-chatsuite@1.0.0","maintainers":[{"name":"akson","email":"contact@akson.ch"}],"bin":{"mcp-chatsuite":"dist/index.js"},"dist":{"shasum":"0449a0ef15ba265996035c81276c303557402dcb","tarball":"https://registry.npmjs.org/@akson/mcp-chatsuite/-/mcp-chatsuite-1.0.0.tgz","fileCount":10,"integrity":"sha512-uVh0/WAWKU0qzLNvuDh6ZqHSRu8/8Myp41WW2XDLLWP62XVeqNa1SnxchGgLSYa7aPTY9fjIlHabEtI5AuVmpw==","signatures":[{"sig":"MEUCIFSGfCK6byWlpQkLetSiXdX+zRb1im1ciMLQWPzL6OyGAiEA8I9Xs4UAA++J7RluaaY2XrAjyciEOlZuqeXBye8754E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":111298},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"1931f01680196fb09442b6bfe22f5c6670a0ed1c","scripts":{"dev":"tsx src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"akson","email":"contact@akson.ch"},"_npmVersion":"11.3.0","description":"MCP server for ChatSuite WhatsApp automation platform","directories":{},"_nodeVersion":"24.2.0","dependencies":{"axios":"^1.7.2","@modelcontextprotocol/sdk":"^0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.15.0","typescript":"^5.4.5","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-chatsuite_1.0.0_1753560837129_0.05454794139491792","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Deprecated: no consumers. No longer maintained."},"1.0.1":{"name":"@akson/mcp-chatsuite","version":"1.0.1","keywords":["mcp","chatsuite","whatsapp","automation","api","claude"],"author":{"name":"Akson"},"license":"MIT","_id":"@akson/mcp-chatsuite@1.0.1","maintainers":[{"name":"akson","email":"contact@akson.ch"}],"bin":{"mcp-chatsuite":"dist/index.js"},"dist":{"shasum":"ca0a48a8ffae0ac0c03e18eb59c3a47e470714ef","tarball":"https://registry.npmjs.org/@akson/mcp-chatsuite/-/mcp-chatsuite-1.0.1.tgz","fileCount":10,"integrity":"sha512-PLwHnjl6NDWA5FMG7X73YDqDK1FBrix/kkXPMi5538fwZtlb3v0YH/f2hkPFL0Q+UeQHs5pLgrdBB9dHJoilNQ==","signatures":[{"sig":"MEQCID+aXfLqfH0JQqNdkyR7MloATMRA13VvtN7jtrY+aaQDAiAOSUQKB32LabPLX+OrZ5nYE0L/l/6cbxByunn7TM1AXg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":111298},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"1931f01680196fb09442b6bfe22f5c6670a0ed1c","scripts":{"dev":"tsx src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"akson","email":"contact@akson.ch"},"_npmVersion":"11.3.0","description":"MCP server for ChatSuite WhatsApp automation platform","directories":{},"_nodeVersion":"24.2.0","dependencies":{"axios":"^1.7.2","@modelcontextprotocol/sdk":"^0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.15.0","typescript":"^5.4.5","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-chatsuite_1.0.1_1753561330920_0.004091083155435271","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Deprecated: no consumers. No longer maintained."}},"time":{"created":"2025-07-26T20:13:57.068Z","modified":"2026-03-19T13:02:44.890Z","1.0.0":"2025-07-26T20:13:57.353Z","1.0.1":"2025-07-26T20:22:11.115Z"},"author":{"name":"Akson"},"license":"MIT","keywords":["mcp","chatsuite","whatsapp","automation","api","claude"],"description":"MCP server for ChatSuite WhatsApp automation platform","maintainers":[{"name":"antoineschaller","email":"antoine.schaller@akson.ch"}],"readme":"# ChatSuite MCP Server\n\nA Model Context Protocol (MCP) server that provides Claude with access to the ChatSuite WhatsApp automation platform. This server enables Claude to manage WhatsApp sessions, send messages, manage groups, handle business features, and more.\n\n## Features\n\n### Session Management\n- Create, list, and manage WhatsApp sessions\n- Initialize sessions and generate QR codes\n- Reset and delete sessions\n\n### Messaging\n- Send text and media messages\n- List and search messages\n- Delete messages (including \"delete for everyone\")\n- Quote/reply to messages\n- Send reactions\n\n### Chat Management\n- List and manage chats\n- Mark chats as read\n- Show typing indicators\n- Clear chat history\n\n### Group Management\n- Create and manage groups\n- Add/remove participants\n- Promote/demote admins\n- Generate and revoke invite links\n\n### Interactive Messages\n- Send button messages\n- Send list messages\n- Create polls\n- Send contacts and locations\n\n### Business Features\n- Create and manage product catalogs\n- Handle orders\n- Request payments\n- Send order details\n\n### Status Updates\n- Post text, image, and video status updates\n- List and manage status updates\n- View status viewers\n\n### API Token Management\n- Create and manage API tokens\n- Set granular permissions\n- Revoke tokens\n\n## Installation\n\n### Prerequisites\n\n1. Node.js 18+ installed\n2. A ChatSuite account with API access\n3. An API token from ChatSuite\n\n### Install from npm\n\n```bash\nnpm install -g @akson/mcp-chatsuite\n```\n\n### Install from source\n\n```bash\ngit clone https://github.com/yourusername/mcp-chatsuite-server.git\ncd mcp-chatsuite-server\nnpm install\nnpm run build\nnpm link\n```\n\n## Configuration\n\n### 1. Set Environment Variables\n\nCreate environment variables for your ChatSuite credentials:\n\n```bash\nexport CHATSUITE_API_URL=https://api.chatsuite.akson.ch\nexport CHATSUITE_API_TOKEN=wa_your_token_here\n```\n\nYou can also create a `.env` file in your home directory:\n\n```bash\n# ~/.env\nCHATSUITE_API_URL=https://api.chatsuite.akson.ch\nCHATSUITE_API_TOKEN=wa_your_token_here\n```\n\n### 2. Configure Claude Desktop\n\nAdd the ChatSuite server to your Claude Desktop configuration:\n\n#### macOS\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"chatsuite\": {\n      \"command\": \"mcp-chatsuite\",\n      \"env\": {\n        \"CHATSUITE_API_URL\": \"https://api.chatsuite.akson.ch\",\n        \"CHATSUITE_API_TOKEN\": \"wa_your_token_here\"\n      }\n    }\n  }\n}\n```\n\n#### Windows\nEdit `%APPDATA%\\Claude\\claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"chatsuite\": {\n      \"command\": \"mcp-chatsuite\",\n      \"env\": {\n        \"CHATSUITE_API_URL\": \"https://api.chatsuite.akson.ch\",\n        \"CHATSUITE_API_TOKEN\": \"wa_your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart Claude Desktop\n\nAfter updating the configuration, restart Claude Desktop to load the ChatSuite server.\n\n## Usage\n\nOnce configured, you can use ChatSuite tools in Claude by asking it to:\n\n- \"List my WhatsApp sessions\"\n- \"Send a WhatsApp message to +1234567890\"\n- \"Create a new WhatsApp group called 'Team Updates'\"\n- \"Show me unread chats\"\n- \"Create a product catalog for my business\"\n- \"Send a poll asking about meeting times\"\n\n## Available Tools\n\n### Session Management\n- `chatsuite_health` - Check API health\n- `chatsuite_list_sessions` - List all sessions\n- `chatsuite_create_session` - Create new session\n- `chatsuite_get_session` - Get session details and QR code\n- `chatsuite_initialize_session` - Initialize session\n- `chatsuite_reset_session` - Reset session\n- `chatsuite_delete_session` - Delete session\n\n### Messaging\n- `chatsuite_send_message` - Send text or media message\n- `chatsuite_list_messages` - List messages with filters\n- `chatsuite_delete_message` - Delete message\n\n### Chat Management\n- `chatsuite_list_chats` - List chats\n- `chatsuite_get_chat` - Get chat details\n- `chatsuite_mark_as_read` - Mark chat as read\n- `chatsuite_send_typing` - Show typing indicator\n\n### Group Management\n- `chatsuite_create_group` - Create group\n- `chatsuite_list_groups` - List groups\n- `chatsuite_add_participants` - Add participants\n- `chatsuite_remove_participant` - Remove participant\n- `chatsuite_update_participant_role` - Promote/demote admin\n\n### Interactive Messages\n- `chatsuite_send_buttons` - Send button message\n- `chatsuite_send_list` - Send list message\n- `chatsuite_send_poll` - Send poll\n- `chatsuite_send_location` - Send location\n- `chatsuite_send_contact` - Send contact\n- `chatsuite_send_reaction` - Send reaction\n\n### Business Features\n- `chatsuite_create_catalog` - Create product catalog\n- `chatsuite_create_order` - Create order\n- `chatsuite_request_payment` - Request payment\n\n### Status Updates\n- `chatsuite_post_status` - Post status update\n- `chatsuite_list_status` - List status updates\n\n### Token Management\n- `chatsuite_list_tokens` - List API tokens\n- `chatsuite_create_token` - Create API token\n- `chatsuite_revoke_token` - Revoke API token\n\n## API Token Permissions\n\nWhen creating API tokens for use with this MCP server, ensure they have the necessary permissions:\n\n- `messaging:read` - Required for reading messages, chats, and sessions\n- `messaging:write` - Required for sending messages and managing sessions\n\nAdmin role is required for token management operations.\n\n## Troubleshooting\n\n### Server not connecting\n\n1. Check that your API token is valid\n2. Verify the API URL is correct\n3. Ensure Claude Desktop is properly restarted\n4. Check Claude Desktop logs for errors\n\n### Permission errors\n\n1. Verify your API token has the required permissions\n2. For admin operations, ensure your token has admin role\n3. Check the ChatSuite dashboard for token status\n\n### Connection issues\n\n1. Check your internet connection\n2. Verify the ChatSuite API is accessible\n3. Try the health check endpoint directly:\n   ```bash\n   curl https://api.chatsuite.akson.ch/health\n   ```\n\n## Development\n\n### Running locally\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build for production\nnpm run build\n```\n\n### Testing with Claude Desktop\n\n1. Build the project: `npm run build`\n2. Update Claude Desktop config to point to local build:\n   ```json\n   {\n     \"mcpServers\": {\n       \"chatsuite-dev\": {\n         \"command\": \"node\",\n         \"args\": [\"/path/to/mcp-chatsuite-server/dist/index.js\"],\n         \"env\": {\n           \"CHATSUITE_API_URL\": \"https://api.chatsuite.akson.ch\",\n           \"CHATSUITE_API_TOKEN\": \"wa_your_token_here\"\n         }\n       }\n     }\n   }\n   ```\n\n## Security\n\n- Never commit API tokens to version control\n- Use environment variables for sensitive data\n- Rotate API tokens regularly\n- Use tokens with minimal required permissions\n- Consider using separate tokens for development and production\n\n## Support\n\nFor issues with:\n- ChatSuite API: Contact ChatSuite support\n- MCP Server: Open an issue on GitHub\n- Claude Desktop: Check Anthropic documentation\n\n## License\n\nMIT","readmeFilename":"README.md"}