← All integrations

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.

Runs once, when you ask

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

Connect Superchat to Claude, ChatGPT or Cursor

  1. 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. 2

    Add Corsair's MCP server to your agent

    Every client uses the same address:

    https://mcp.corsair.dev/mcp
    Open Customize → Connectors → Add custom connector, paste the address, then select Connect.

    Codex, 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. 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.