Superchat MCP server
22 operations0 webhooks
Multi-channel messaging from Superchat - manage contacts and contact lists, read conversations and their messages, and send text messages on WhatsApp, SMS, Instagram, Messenger, Telegram or email.
Try Superchat with your agent
Connect Superchat, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Superchat on my account, then run one read-only example and show me the result.
Superchat tools and triggers
Tools are what your agent can do in Superchat through Corsair's MCP server. Triggers are the Superchat events a routine can start from.
Contact Lists
- Add ContactWrite
Add a contact to a contact list. The list is named in the body on this route, not in the path
contactLists.addContact
- CreateWrite
Create a contact list that contacts can be added to
contactLists.create
- DeleteDestructive
Delete a contact list. Its membership goes with it, and this cannot be undone
contactLists.delete
- For ContactRead-only
List the contact lists one contact belongs to, paged by cursor like the other lists
contactLists.forContact
- ListRead-only
List the contact lists in the workspace
contactLists.list
- Remove ContactWrite
Remove a contact from a contact list; the contact itself stays
contactLists.removeContact
Contacts
- CreateWrite
Create a contact. At least one handle is required, and a handle is the email address or phone number that identifies them on a channel
contacts.create
- DeleteDestructive
Delete a contact and their handles. Conversations that referenced them lose the link, and this cannot be undone
contacts.delete
- GetRead-only
Read one contact with their handles, gender and custom attribute values
contacts.get
- ListRead-only
List contacts newest first, paging with a cursor id; set after or before, never both
contacts.list
- SearchRead-only
Search contacts by email, phone, Instagram or WhatsApp username, or a custom attribute; every expression has to match
contacts.search
- UpdateWrite
Change a contact's names, gender, handles or custom attributes. The route requires first name, last name and gender, so all three are sent back
contacts.update
Conversations
- GetRead-only
Read one conversation with its labels, assignees, linked contacts and snooze state
conversations.get
- ListRead-only
List conversations with their status, channel, inbox and assigned users, paging with a cursor id
conversations.list
- MessagesRead-only
List the messages in one conversation, paging with a cursor id
conversations.messages
- UpdateWrite
Change a conversation's status, inbox, labels or assignees. Snoozing needs both a status of snoozed and a snoozed_until time
conversations.update
Channels
- GetRead-only
Read one channel with its type, name and the inbox it belongs to
channels.get
- ListRead-only
List the channels in the workspace, optionally only those in one inbox; a channel id is what a message is sent from
channels.list
Inboxes
- GetRead-only
Read one inbox with its name and workspace url
inboxes.get
- ListRead-only
List the inboxes in the workspace
inboxes.list
Messages
- GetRead-only
Read one message with its content, direction and status
messages.get
- SendDestructive
Send a text message on a channel to one recipient. This reaches a real person on WhatsApp, SMS or another channel, and the content has to suit that channel
messages.send
Connect Superchat to Claude, ChatGPT or Cursor
- 1
Connect Superchat in Corsair
Add your Superchat API key once in Corsair. Corsair stores the credential encrypted and makes the Superchat API calls for your agent, so it never goes into a prompt or a config file. Connect Superchat
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Superchat. On a ChatGPT personal plan, connect Superchat here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Superchat's read and write operations run right away and its 3 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/superchat, add the Superchat plugin, and connect with an API key. Then call methods like corsair.superchat.api.channels.get() from your app. Corsair keeps each tenant isolated.
Yes. Superchat requires an API key from your Superchat account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Superchat, GitHub, Notion, Stripe, and the rest. Trigger Superchat from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for multi-channel messaging from Superchat - manage contacts and contact lists, read conversations and their messages, and send text messages on WhatsApp, SMS, Instagram, Messenger, Telegram or email. Common builds include sync jobs, admin tooling, and agents that call Superchat APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Superchat API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/superchat in the open repo. When Superchat ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Superchat data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Superchat data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Superchat on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 3 destructive Superchat operations. You can change a link's mode at hub.corsair.dev/me.