Skip to content
MCP server

UnderChat MCP by usefulapi

Hosted MCP server that lets AI assistants work with UnderChat WhatsApp chats and contacts

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.3.4
Listing updated
1 day ago

Similar MCP servers

About UnderChat MCP by usefulapi

UnderChat MCP by usefulapi is a freemium MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

The server gives an AI client access to a UnderChat account, a WhatsApp chat management tool used by support teams. Once connected, the assistant can list queued and assigned conversations, read and search message history, check unread counts, and look up contacts by phone number.

Write actions are also available: sending a text into an existing chat, moving a chat to another channel, user or sector, changing its state, setting labels, and creating or updating contacts. The README notes that six of the 25 tools can change data, and most clients ask for confirmation before running them.

Access runs under the user's own UnderChat API token and active user id, so the server only sees what that account can see. The README describes it as an independent service, not an official UnderChat product. It suits attendants and operators who want to manage chats through Claude, ChatGPT or Cursor instead of the UnderChat interface.

Install

Run in a terminal

claude mcp add --transport http underchat https://underchat.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://underchat.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "underchat": {
      "url": "https://underchat.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "underchat": {
      "type": "http",
      "url": "https://underchat.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "underchat": {
      "serverUrl": "https://underchat.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "underchat": {
      "type": "http",
      "url": "https://underchat.usefulapi.io/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (21)

Read directly from the server.

underchat_list_chats
List conversations in one state (my_chats = the executor's own chats; or queue, in_chat, closed, and so on), with optional filters. GET /chat.
underchat_search_chats
Search conversations by contact name or phone. GET /chat/search.
underchat_get_chat_messages
Read the message history of one chat, newest first, with paging. GET /chat/{chat_id}.
underchat_search_chat_messages
Search the messages of one chat for a text. GET /chat/{chat_id}/search.
underchat_get_chat_details
Get one chat with its state, assigned channel, user, sector and labels. GET /chat/{chat_id}/details.
underchat_get_unread_summary
Count the unread messages for the executor. GET /chat/unread-summary.
underchat_list_channels
List the account's channels (for example WhatsApp numbers) with their status. Use the ids as channel or worker ids in other tools. GET /chat/channels-status.
underchat_list_workers
List the workers (channels) that can receive or transfer a chat, for filters and transfers. GET /chat/workers.
underchat_list_contacts
List the account's chat contacts with paging and filters. GET /chat/contacts.
underchat_get_contact
Get one chat contact by id. GET /chat/contacts/{contact_id}.
underchat_find_contact_by_phone
Find the chat contact that has a phone number. GET /chat/contacts/by-phone.
underchat_list_label_templates
List the label templates (etiquetas) of the account. GET /label-template.
underchat_list_sectors
List the sectors (setores) of the account. GET /sector.
underchat_list_users
List the users (attendants) of the account with paging and filters. GET /user.
underchat_get_user
Get one user of the account by id, with the status and access group. GET /user/{user_id}.
underchat_send_text_message
Send a WhatsApp text message into an existing chat, as the executor. The customer receives it. POST /chat/{chat_id} with type=text.
underchat_update_chat_status
Move a chat to another state, for example closed, queue or in_chat. Closing ends the attendance for the customer. PATCH /chat/{chat_id}/status.
underchat_transfer_chat
Transfer a chat to another worker (channel), user or sector. Set at least one of worker_id, user_id or sector_id. POST /chat/{chat_id}/transfer.
underchat_set_chat_labels
Send a list of label template ids to a chat. The API decides whether the list replaces or adds to the current labels; check the chat after the call. PATCH /chat/{chat_id}/label.
underchat_create_contact
Create a chat contact with a name and a phone number. POST /chat/contacts.
underchat_update_contact
Change the fields you send for one chat contact. Fields you omit stay as they are. PATCH /chat/contacts/{contact_id}.

What it does

Chat queue and history
Lists queued, assigned and closed chats and reads or searches the messages inside them.
Message sending
Sends WhatsApp text messages into existing chats on behalf of the signed-in user.
Transfers and status changes
Moves chats to another channel, user or sector and changes their state.
Labels and contacts
Sets label templates on chats and creates or updates chat contacts by name and phone.
OAuth login
Signs in with an UnderChat API token and user id through a login page, with no keys in client config files.
Usage metering
Reports calls used against the monthly plan limit and supports upgrades through a payment link.

Good for

  • Check which WhatsApp chats are waiting in the support queue and how long they have waited
  • Read the recent history of a customer chat before replying
  • Send a follow-up text to a customer from an AI assistant
  • Move a chat to the sales sector and leave a note for the new attendant
  • Create a contact for a new lead and apply a label to it

Pricing

Freemium, from $9 a month

Free plan with 50 calls/month; Pro $9/mo or $90/yr; Pro+ $39/mo or $390/yr.

Prices change. Check usefulapi.io before you buy.

UnderChat MCP by usefulapi FAQ

Is this an official UnderChat product?

No. The website states usefulapi is an independent service, not affiliated with or endorsed by UnderChat.

What do I need to connect?

The login page asks for your UnderChat API token and an active user id (UUID). The website says the token is created under Integração → API pública in UnderChat.

What does it cost?

The Free plan allows 50 tool calls a month. Pro is $9/mo or $90/yr with 10,000 calls, and Pro+ is $39/mo or $390/yr with 100,000 calls.

Can the AI change my UnderChat data?

Yes, through six write tools, such as sending messages, transferring chats and creating contacts. The README says most MCP clients ask for approval before a tool call runs.

Is UnderChat MCP by usefulapi free?

UnderChat 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 UnderChat MCP by usefulapi to Claude Code?

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

What are the best alternatives to UnderChat MCP by usefulapi?

The closest alternatives to UnderChat MCP by usefulapi are TrendRadar, Getmitra, Discord, Zoom and Email Spam Tester.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers