# Superchat MCP connector The Superchat connector brings your Superchat contacts, conversations, inboxes, channels and labels to Claude, ChatGPT, Cursor and any MCP client, so each person can look up, update and organize customer messaging inside their own Superchat access with every action logged. Source: https://elaichi.ai/connectors/superchat/ ## Facts | | | | --- | --- | | Application | Superchat | | Category | Helpdesk | | AI tools | 48 | | Authentication | Connects with an API key | | Needs your own OAuth app | No | | MCP endpoint | https://api.elaichi.ai/mcp | | Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent | | Tools advertised by name | No. 48 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` | ## What you can ask once Superchat is connected - Show open Superchat conversations by channel this week. - Which Superchat contacts wrote in but got no reply? - Summarize yesterday's Superchat conversations for the support channel. ## Connect Superchat in Elaichi This happens once for the organization, before any client is involved. 1. Open Connections, choose Add connection, and pick Superchat. 2. Optionally set Share with, then press Connect. 3. Paste a Superchat API key. One person generates a token in Superchat and pastes it once. Everyone else works through Share with, and never sees it. Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Superchat tools are exposed, rename them, or freeze arguments before anyone points a client at it. ## Connect Superchat to Claude Endpoint: https://api.elaichi.ai/mcp 1. Open Customize, then Connectors. 2. Press Add. 3. Name it, paste the MCP server URL, then Continue. 4. Sign in and approve. On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves. ## Connect Superchat to ChatGPT Endpoint: https://api.elaichi.ai/mcp 1. Open Plugins, then press the + button. 2. Name it and paste the endpoint into Server URL. 3. Leave Authentication on OAuth, then tick the risk acknowledgement. 4. Press Create, then sign in and approve. Works on the web today. The plugin directory lives at chatgpt.com/plugins. ## Connect Superchat to Cursor Endpoint: https://api.elaichi.ai/mcp 1. Open `~/.cursor/mcp.json`. 2. Add the endpoint under `mcpServers`. 3. Reload Cursor, then sign in and approve. Set up per machine, so repeat it on each computer you work from. ## Connect Superchat to any MCP client Endpoint: https://api.elaichi.ai/mcp 1. Add the endpoint as a remote MCP server. 2. Sign in and approve. The Elaichi Agent already has these tools, with nothing to set up. ## What the consent screen decides Only Read is granted by default, which is not enough to call a Superchat tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone. ## What teams do with Superchat through Elaichi ### Find the conversation before you answer Support. Ask for the open conversations in your inbox, pull up the thread a customer is asking about, and see which channel it came in on, all without switching tabs. ### Tidy the queue at end of shift Support. Update conversations in Superchat to change their status or labels so the next shift picks up a clean inbox instead of a backlog nobody has sorted. ### Catch the contact up after a WhatsApp chat Sales. After a customer messages you, create or update their Superchat contact with the right name, phone number and custom attributes while the details are still fresh. ### Check which contacts sit behind a label Marketing. List Superchat labels and contacts to see how a campaign audience is tagged, and fix contacts that were filed under the wrong label. ### See who handles which inbox Operations. List Superchat users, inboxes and channels to check coverage, spot an inbox with no one assigned, and understand how conversations are routed across the team. ### Export a conversation for the record Compliance. Create a Superchat conversation export when a customer asks for their history or a dispute needs documenting, then fetch the export once it is ready. ## Frequently asked questions ### How do I connect Superchat to Claude? Two steps. In Elaichi, choose Superchat, paste in an API key from your Superchat account settings, and the connection is live; there is no OAuth application to register and no client ID or secret to generate. Then in Claude go to Customize, then Connectors, then Add, and paste the endpoint https://api.elaichi.ai/mcp. Sign in with your Elaichi account and Superchat appears alongside your other connected applications. ### Does Superchat work with ChatGPT and Cursor as well as Claude? Yes. Once Superchat is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any MCP client and the Elaichi Agent. You connect Superchat once and every client you use picks it up. ### What can an AI agent actually do with my Superchat data? With Superchat connected, an agent can look up contacts, conversations, inboxes, channels, labels, files and team members, create and update contacts, change the status or labels on a conversation, upload files, and create and fetch conversation exports. It can also delete contacts, conversations and files if you allow it. Superchat has a lot of actions, so short concrete asks like "show open conversations in the sales inbox" work better than long paragraphs. ### Does connecting Superchat give the AI access to every inbox? No. Every request to Superchat runs inside the access of the person who signed in, so an agent sees the inboxes, conversations and contacts that person can already see in Superchat and nothing more. Elaichi can narrow that further by turning off specific actions, but it can never widen what Superchat itself allows. ### Can my team share one Superchat connection? Yes. One person connects Superchat with an API key and shares the connection with a team in Elaichi, and nobody else on the team ever handles or sees that key. Each teammate still signs in as themselves, so the audit log records who looked up a contact or changed a conversation, not just that the shared Superchat connection was used. ### Can I stop an agent from deleting or changing things in Superchat? Yes. In Elaichi you can restrict the Superchat connection action by action, for example allowing agents to read and update conversations while blocking deletion of contacts, conversations or files. A blocked action is never shown to Claude, ChatGPT or any other client at all, so no prompt, however it is worded, can reach it. ### What happens to a Superchat connection when someone leaves? When you offboard a person in Elaichi, their access to Superchat through every client ends at once, including anything they had set up in Claude, ChatGPT or Cursor. A Superchat connection shared with the team keeps working for everyone else. If you ever want to remove Superchat entirely, disconnecting it once in Elaichi removes it from every client for every person. ## All 48 Superchat tools Every tool below is callable through https://api.elaichi.ai/mcp once Superchat is connected, subject to the toolbox it is in and the restrictions on the caller. - **List all Superchat users** (List). List all users in Superchat workspace. Returns user fields including id, first_name, last_name, email, role, language, created_at, updated_at, and associated inboxes. - **Get single Superchat user by ID** (Get). Get a specific user in Superchat. Requires id. Returns fields including id, first_name, last_name, email, role, language, created_at, updated_at, and inboxes the user has access to. - **List all Superchat me** (List). Get information about yourself as a Superchat user. Returns user.id, first_name, last_name, email, role, language, created_at, updated_at, inboxes, and workspace.name. - **List all Superchat contacts** (List). List all contacts in Superchat workspace. Returns an array of contact objects containing fields like id, first_name, last_name, gender, created_at, updated_at, handles, and custom_attributes. Results are sorted by created_at in descending order. - **Get single Superchat contact by ID** (Get). Get a specific contact in Superchat using id. Returns id, first_name, last_name, gender, created_at, updated_at, handles, and custom_attributes for the contact. - **Create a Superchat contact** (Create). Create a new contact in Superchat using the required handles parameter. Returns the contact id, first_name, last_name, gender, created_at, updated_at, handles, and custom_attributes fields in the response. - **Update a Superchat contact by ID** (Update). Update a contact in Superchat using id. Returns id, first_name, last_name, gender, created_at, updated_at, handles, and custom_attributes for the updated contact. - **Delete a Superchat contact by ID** (Delete). Delete a contact in Superchat using id. Returns the deleted contact's unique id in the response. - **List all Superchat channels** (List). List all channels in Superchat workspace. Returns an array of channel objects including id, name, type, inbox, and url. Results are sorted by created_at in descending order. - **Get single Superchat channel by ID** (Get). Get a specific channel in Superchat by id. Returns fields such as id, name, type, inbox, and url for the channel. - **List all Superchat conversations** (List). List all conversations in Superchat. Returns an array of conversations with fields such as id, status, channel, contacts, assigned_users, labels, inbox, and time_window. - **Get single Superchat conversation by ID** (Get). Get a conversation in Superchat using id. Returns id, url, channel details (type, id, url), status, snoozed_until, time_window, contacts, assigned_users, labels, and inbox details. - **Update a Superchat conversation by ID** (Update). Update a conversation in Superchat using id. Returns id, status, channel details, assigned_users, labels, snoozed_until, time_window, contacts, and inbox details. - **Delete a Superchat conversation by ID** (Delete). Delete a conversation in Superchat using id. Returns the id of the deleted conversation confirming successful removal. - **Get single Superchat conversation export by ID** (Get). Get a conversation export in Superchat. Requires conversation_id and id. Returns id, start, end, link (url, valid_until), and status fields providing export details and a temporary download link. - **Create a Superchat conversation export** (Create). Create a conversation export in Superchat. Requires conversation_id. Returns id, start, end, link (with url and valid_until), and status indicating the export job state. - **List all Superchat custom attributes** (List). List all custom contact attributes in Superchat. Returns each attribute's id, name, resource, type, and specification for multi-select and single-select fields. - **List all Superchat files** (List). List all files in Superchat workspace. Returns an array of file objects sorted by created_at descendingly, including id, name, url, mime_type, and link with valid_until. - **Get single Superchat file by ID** (Get). Get a file in Superchat using id. Returns file details including id, name, url, mime_type, and link (containing a temporary download url and valid_until timestamp). - **Delete a Superchat file by ID** (Delete). Delete a file in Superchat using the required id. Returns the id of the deleted file in the response. - **Create a Superchat file** (Create). Upload a new file to Superchat. Returns id (unique identifier), url (file API resource), name (file name), link.url (temporary download link), link.valid_until (link expiry time), and mime_type (file type). File size must not exceed 5MB. - **List all Superchat inboxes** (List). List all inboxes in Superchat. Returns fields including id, name, url, and users (each with id, email, and url). - **Get single Superchat inbox by ID** (Get). Get a specific inbox in Superchat using id. Returns id, url, name, and users array with user id, url, and email for each user. - **List all Superchat labels** (List). List all labels in Superchat. Returns label id, name, and url for each conversation label available in the workspace. - **Get single Superchat label by ID** (Get). Get a label in Superchat using id. Returns the label's id, name, and url fields representing the unique identifier, label name, and API resource URL respectively. - **Create a Superchat message** (Create). Send a message in Superchat using the specified channel (from) to a recipient (to). Returns id, url, created_at, updated_at, status, direction, to, from, content, in_reply_to, and conversation_id fields in the response. - **List all Superchat notes** (List). List all notes for a specific conversation in Superchat. Requires conversation_id. Returns id, content, created_at, updated_at, and author details for each note. - **Get single Superchat note by ID** (Get). Get a specific note in Superchat using conversation_id and id. Returns note fields including id, content, created_at, updated_at, and author details (id, name, email, url). - **Create a Superchat note** (Create). Create a note in a specific conversation in Superchat. Requires conversation_id. Returns note id, url, created_at, updated_at, content, and author details including id, name, url, and email. - **Update a Superchat note by ID** (Update). Update a note in Superchat for a specific conversation. Requires conversation_id and id. Returns the note's id, content, author details, and timestamps (created_at, updated_at). - **Delete a Superchat note by ID** (Delete). Delete a note in Superchat from a specific conversation using conversation_id and id. Returns the id of the deleted note in the response. - **List all Superchat templates** (List). List all templates in Superchat for a workspace. Returns an array of templates with fields such as id, name, status, content, created_at, updated_at, folder_id, and url. - **Get single Superchat template by ID** (Get). Get a specific template in Superchat by id. Returns key fields including id, name, status, created_at, updated_at, folder_id, content, channels, and whats_app_business_account_id. - **Delete a Superchat template by ID** (Delete). Delete a template in Superchat using id. Returns the deleted template's id in the response. - **Create a Superchat template** (Create). Create a new template in Superchat workspace. Returns id, status, created_at, updated_at, folder_id, name, content details, channels, whats_app_business_account_id, and url in the response. - **Update a Superchat template by ID** (Update). Update a template in Superchat using id. Updates the template name or moves it to a different folder. Returns id, status, name, folder_id, content, channels, created_at, and updated_at. - **List all Superchat template folders** (List). List all template folders in Superchat. Returns each folder's id, name, and parent_id fields for identifying and organizing template folders. - **Create a Superchat template folder** (Create). Create a template folder in Superchat. Requires name. Returns id, name, and parent_id of the created template folder. - **Update a Superchat template folder by ID** (Update). Update a specific template folder in Superchat using id. Returns id, name, and parent_id of the updated template folder. - **Delete a Superchat template folder by ID** (Delete). Delete a specific template folder in Superchat. Requires id. Only empty folders can be deleted. Returns the id of the deleted folder in the response. - **List all Superchat contact lists** (List). List all contact lists in Superchat. Returns a list of contact lists with fields id, name, and url for each contact list. - **Get single Superchat contact list by ID** (Get). Get a contact list in Superchat using id. Returns fields such as url (resource URL), id (contact list identifier), and name (contact list name). - **List all Superchat search contacts** (List). Search contacts in Superchat by any field such as mail or phone using field, operator, and value. Returns contact objects with id, first_name, last_name, gender, handles, custom_attributes, created_at, and updated_at. - **List all Superchat contact conversations** (List). Get all conversations for a specific contact in Superchat. Requires contact_id. Returns fields such as id, status, channel details, assigned_users, labels, and inbox information for each conversation. - **List all Superchat contact contact lists** (List). Get contact lists for a contact in Superchat. Requires contact_id. Returns each contact list with id (unique identifier), name (list name), and url (resource link). - **Get single Superchat contact contact list by ID** (Get). Get a contact list for a contact in Superchat using contact_id and id. Returns fields url (resource URL), id (contact list identifier), and name (contact list name). - **Delete a Superchat contact contact list by ID** (Delete). Delete a contact from a specific contact list in Superchat. Requires contact_id and id. Returns the deleted contact list id upon success. - **Create a Superchat contact contact list** (Create). Add a contact to a single contact list in Superchat. Requires contact_id. Returns the contact list id, name, and url of the newly associated list.