MCP Server

Give Claude, Cursor, Gemini CLI or any MCP client tools over your ChatGenius account: the inbox, contacts, appointments, flows, comment automation, Content Studio and knowledge base. One npm package, one API key, nothing to host.

Webhook & API Add-on · $29/month · Requires Creator+ plan

What it is

The Model Context Protocol is the open standard AI assistants use to call outside tools. It is not tied to one vendor: Claude, Cursor, Gemini CLI, Zed, Windsurf and most agent frameworks speak it. This package runs locally, so it needs a client that can start a local server; ChatGPT, which only connects to hosted servers, is not supported yet. chatgenius-mcp is a small program that runs on your computer, speaks MCP to your assistant on one side and calls the REST API on the other. Every tool is exactly one API call. Nothing is stored, nothing runs on our servers, and your API key never leaves your machine.

Once it is installed you can ask things like "who messaged us on Instagram this week that we have not replied to", "book Maria for Thursday at 2pm and tell her", or "build a flow that answers price with our packages and collects an email", and the assistant does it with the same calls a developer would make.

Package

npx -y chatgenius-mcp

Install

You need Node 18 or newer and an API key. Create the key in the portal under Webhook & Send API, Credentials, and give it the scope you want the assistant to have: read for a look-but-do-not-touch assistant, write for one that can send, book and build.

Then add the server to your client. Claude Desktop reads claude_desktop_config.json; Cursor, Zed and Windsurf take the same command, arguments and environment in their own MCP settings. Claude Code has a plugin: two commands, and it asks for your key.

Environment

CHATGENIUS_API_KEYrequired

Your API key. Its scope caps what the tools can do; the API enforces that on every call.
CHATGENIUS_MAX_SCOPEoptional

read, write or admin. Hides every tool above that scope, so the assistant never sees them.

Claude Desktop

{
  "mcpServers": {
    "chatgenius": {
      "command": "npx",
      "args": ["-y", "chatgenius-mcp"],
      "env": { "CHATGENIUS_API_KEY": "sgwh_your_api_key_here" }
    }
  }
}

Claude Code

claude plugin marketplace add SumCodeAI/chatgenius-claude-plugin
claude plugin install chatgenius@sumgenius

The tools

50 tools in eight groups, each mapped to one endpoint of the REST API and carrying the same rules, limits and error codes. Read tools are safe to run freely. Write tools create or edit records. Destructive tools reach a real person, publish content or change what runs live; they are marked so your client asks you before running them.

Group	Tools
Account	get_account, get_overview
Contacts	list_contacts, get_contact, upsert_contact, update_contact, list_tags, create_tag, tag_contact, untag_contact
Inbox	list_conversations, get_conversation, list_messages, update_conversation, send_message
Appointments	list_appointments, get_availability, book_appointment, reschedule_appointment, cancel_appointment
Flows	list_flows, get_flow, get_flow_definition, get_flow_node_catalogue, validate_flow, create_flow, update_flow, publish_flow, activate_flow, pause_flow, get_flow_analytics, list_flow_sessions
Comments	list_comment_triggers, get_comment_trigger_stats, list_recent_posts, list_handled_comments, approve_comment_reply, reject_comment_reply
Content Studio	list_posts, get_post, get_posting_capabilities, create_post, update_post, schedule_post, publish_post
Knowledge base	list_faqs, create_faq, update_faq, list_services, list_knowledge_gaps

Team, webhook endpoints, API keys and media uploads are not exposed. Use the portal or the REST API for those.

ℹ️

Building a flow. The assistant reads the node catalogue, writes a {trigger, nodes, edges} definition, runs validate_flow until the errors list is empty, saves a draft with create_flow, and publishes when you say so. Open the flow in the portal and it is laid out on the canvas, ready to edit by hand.

Safety

Scope is enforced twice

The API checks the key's scope on every call. CHATGENIUS_MAX_SCOPE is a second, local cap that hides tools from the model altogether.
No double sends

Every write carries an Idempotency-Key, so a retried tool call cannot send a message or book a slot twice.
Customer text is data

Message and comment text in results was written by your customers. The server instructs the model to treat it as data, never as instructions. Keep destructive tools behind your client's approval prompt.
Revoke any time

Revoke the key in the portal and the server stops working on the next call.

Source

https://www.npmjs.com/package/chatgenius-mcp