# Superchat MCP by usefulapi

> Superchat MCP by usefulapi is a freemium MCP server for communication. Read-only MCP connector that lets AI assistants query Superchat conversations and contacts. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/superchat/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/superchat
- **MCP Registry name:** io.usefulapi/superchat
- **Categories:** communication
- **Listing updated:** 2026-11-18

## About

The README describes a hosted endpoint that gives AI clients read-only access to a Superchat workspace, covering conversations, messages, contacts, channels, inboxes, labels and message templates. Nothing has to be installed locally; the connection is made by pasting a URL into an MCP-capable client and signing in.

Access runs through a login page that asks for a Superchat admin API token, which only workspace administrators can see in the Superchat settings. The server calls the Superchat API with that access, so it only surfaces data the account can already see. The 16 data tools are marked read-only, and the remaining four handle usage status, feature requests and subscription management.

The server suits support and sales teams who work customer threads in Superchat across WhatsApp, email and other channels and want an assistant to look up assignments, histories or contact details. It is an independent service by usefulapi and is not affiliated with Superchat.

## Features

- **Read-only workspace access:** Sixteen tools list and fetch conversations, messages, contacts, channels, inboxes, users, labels and templates without sending or changing anything.
- **OAuth login with admin token:** Clients sign in through a login page that asks for a Superchat admin API token, so no keys are placed in client config files.
- **Hosted remote endpoint:** The server runs at a Streamable HTTP URL, so there is no local install and it works with Claude, ChatGPT, Cursor, VS Code and other MCP clients.
- **Usage metering and plans:** A usage status tool reports calls used against the monthly limit of the Free, Pro or Pro+ plan.
- **Feature request channel:** A tool lets the assistant send usefulapi a request when a needed Superchat capability is missing, limited to five per day.

## Good for

- Finding open conversations and seeing who is assigned to them
- Reading the message history of one customer thread before replying
- Reviewing a contact and all of their conversations in one place
- Checking which WhatsApp, email or other channels are connected to a workspace
- Looking up message templates and conversation labels while drafting replies

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http superchat https://superchat.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://superchat.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "superchat": {
      "url": "https://superchat.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "superchat": {
      "type": "http",
      "url": "https://superchat.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "superchat": {
      "serverUrl": "https://superchat.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "superchat": {
      "type": "http",
      "url": "https://superchat.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `superchat_get_me`: Get the user that owns the API token.
- `superchat_list_conversations`: List conversations in the workspace.
- `superchat_get_conversation`: Get one conversation by id, including its status and assignment.
- `superchat_list_conversation_messages`: List the messages of one conversation.
- `superchat_get_message`: Get one message by id.
- `superchat_list_contacts`: List contacts in the workspace.
- `superchat_get_contact`: Get one contact by id, including its custom attributes.
- `superchat_list_contact_conversations`: List the conversations of one contact.
- `superchat_list_contact_lists`: List the contact lists of the workspace.
- `superchat_list_channels`: List the connected channels.
- `superchat_get_channel`: Get one channel by id.
- `superchat_list_inboxes`: List the inboxes of the workspace.
- `superchat_list_users`: List the users of the workspace.
- `superchat_list_labels`: List the labels that tag conversations.
- `superchat_list_custom_attributes`: List the custom attribute definitions used on contacts.
- `superchat_list_templates`: List the message templates of the workspace.

## FAQ

### Is this an official Superchat product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Superchat.

### What do I need to connect?

The login page asks for your Superchat admin API token, which can be found under Superchat Settings then API.

### Can the AI change my Superchat data?

All 16 Superchat data tools are marked read-only, according to the listing.

### What does it cost?

The Free plan gives 50 tool calls a month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls.

### Is Superchat MCP by usefulapi free?

Superchat MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Superchat MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http superchat https://superchat.usefulapi.io/mcp

### What are the best alternatives to Superchat MCP by usefulapi?

The closest alternatives to Superchat MCP by usefulapi are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/superchat-mcp-by-usefulapi
