# Chatgenius

> Chatgenius is a freemium MCP server for communication. Let an AI assistant run your Instagram, Facebook and WhatsApp inbox, bookings and posts. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI
- **Website:** https://sumgenius.ai/docs/mcp
- **MCP Registry name:** io.github.SumCodeAI/chatgenius
- **Categories:** communication, marketing and SEO
- **Listing updated:** 2026-11-15

## About

This server connects an assistant to a ChatGenius account, a DM-automation service for Instagram, Messenger, WhatsApp and SMS. Every tool is a single call to the ChatGenius REST API, grouped into contacts, inbox, appointments, flows, comment triggers, Content Studio, Market Intel, the knowledge base and AI settings. The documentation lists 105 tools, while its meta description says 50.

It runs two ways. The hosted endpoint at sumgenius.ai/api/mcp signs in with OAuth 2.1 (PKCE, one-hour access tokens, rotating refresh tokens), and the account owner chooses between read-only and read-and-act access. The local npm package, chatgenius-mcp, uses an API key, and an optional CHATGENIUS_MAX_SCOPE setting hides every tool above a chosen scope so the model never sees them. The docs say an assistant never gets admin scope, so team, webhook, API-key and media management stay in the portal.

Flow building is a worked example: the assistant reads the node catalogue, drafts a trigger, nodes and edges definition, runs validate_flow until it is clean, saves a draft and publishes only when you say so. Writes carry an idempotency key so a retried call does not send twice.

## Features

- **Hosted and local modes:** Connect by URL with OAuth, or run the chatgenius-mcp npm package with an API key.
- **Scope caps:** Read, write or admin scope is enforced by the API and, locally, hidden from the model.
- **Inbox and contacts:** List conversations, read messages, send replies, assign chats, tag contacts and manage custom fields.
- **Appointment booking:** Check availability, then book, reschedule or cancel appointments.
- **Flow builder:** Create, validate, publish and pause automation flows, with analytics and session logs.
- **Comment automation:** Manage comment triggers and approve or reject drafted replies in bulk.
- **Content Studio posts:** Create, schedule, publish and retry social posts.
- **Knowledge base:** Manage FAQs, services and documents the ChatGenius AI answers from.

## Good for

- Ask which Instagram contacts messaged this week and have not had a reply
- Book a customer into a free slot and send them a confirmation
- Draft and validate a DM flow that answers pricing questions and collects an email
- Schedule social posts from a content plan written in the assistant
- Review competitor follower trends from the Market Intel tools

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http chatgenius https://sumgenius.ai/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sumgenius.ai/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "chatgenius": {
      "url": "https://sumgenius.ai/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "chatgenius": {
      "type": "http",
      "url": "https://sumgenius.ai/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "chatgenius": {
      "serverUrl": "https://sumgenius.ai/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "chatgenius": {
      "type": "http",
      "url": "https://sumgenius.ai/api/mcp"
    }
  }
}
```

## Tools

- `list_conversations`: Lists inbox conversations.
- `send_message`: Sends a message to a contact.
- `book_appointment`: Books an appointment.
- `get_availability`: Checks free appointment slots.
- `validate_flow`: Validates a flow definition before saving.
- `create_flow`: Saves a draft automation flow.
- `publish_flow`: Publishes a flow.
- `create_post`: Creates a Content Studio post.
- `schedule_post`: Schedules a post for later.
- `list_contacts`: Lists contacts.

## FAQ

### What do I need to use it?

A ChatGenius account. The hosted server needs you to be the account owner and approve access once; the local package needs an API key from the portal.

### Does it work on the free plan?

Yes. Connecting Claude or ChatGPT is included on every plan, Free included, with the same limits as your plan.

### Can I make the assistant read-only?

Yes. Choose Read only when approving the hosted connection, or give the API key read scope. CHATGENIUS_MAX_SCOPE can cap it further.

### Which clients does it support?

The docs list Claude, ChatGPT, Cursor, Claude Code, Zed, Windsurf and other MCP clients.

### Can the assistant manage team members or API keys?

No. Those need the admin scope, which an assistant never receives.

### Is Chatgenius free?

Chatgenius has a free plan, with paid plans for more usage or features.

### How do I add Chatgenius to Claude Code?

Run this command in your terminal: claude mcp add --transport http chatgenius https://sumgenius.ai/api/mcp

### What are the best alternatives to Chatgenius?

The closest alternatives to Chatgenius are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, BoardAgent and Callout.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/chatgenius
