Skip to content
MCP server

Chatgenius

Let an AI assistant run your Instagram, Facebook and WhatsApp inbox, bookings and posts

Install
Pricing
Freemium
Platforms
Web, API, CLI
Runs
Locally or Remotely
Version
0.2.3
Listing updated
2 days ago

About Chatgenius

Chatgenius is a freemium MCP server for communication. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://sumgenius.ai/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chatgenius": {
      "url": "https://sumgenius.ai/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • CHATGENIUS_API_KEYChatGenius API key, created in the portal under Webhook + Send API, Credentials.Required
  • CHATGENIUS_MAX_SCOPEOptional cap: read, write or admin. Hides every tool above that scope.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Free plan with 50 conversations a month; paid plans and a 7-day Creator trial, prices not listed on the page

Prices change. Check sumgenius.ai before you buy.

Chatgenius 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 to Chatgenius

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO