---
title: "MCP Server"
source: https://sumgenius.ai/docs/mcp
generated: 2026-09-08
---

# 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](https://sumgenius.ai/docs/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.

> **Note**
>
> **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
```