API-Supp

io.github.elishosh687-specPublished by GitHub account elishosh687-specv1.0.0Updated Nov 14, 2026

Link a WhatsApp number by QR code and use it from Claude or ChatGPT via MCP.

The publisher's own server: SuppCo

VerifiedStreamable HTTPWeb executableProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Lets an assistant read and send WhatsApp messages, search contacts and chats, and handle media through a hosted WhatsApp bridge.

What you can do
  • Search contacts and list chats with their last message
  • Look up chats by contact or direct conversation
  • Read messages with filters and view context around a message
  • Send text messages, files and voice notes
  • Download media from messages and trigger a history re-sync
When to use it
Useful when you want an assistant to work with your own WhatsApp account: finding conversations, summarizing or reading message history, and sending replies, files or voice notes from a chat client.
Requirements
A remote endpoint at app.api-supp.com over streamable HTTP. Authentication is required: OAuth, or a personal MCP token sent in the Authorization header as a bearer token. The README also describes a self-hosted Python 3.11+ client configured with WHATSAPP_BRIDGE_TOKEN and an optional bridge URL.
Before you install
The Authorization token grants access to your own WhatsApp account, so treat it as a secret. The server can send messages, files and voice notes on your behalf and download media, and it asks the bridge to re-sync history. Message content and media pass through the third-party bridge service.

Installation

In SourceWeft

  1. Open API-Supp in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.elishosh687-spec%2Fapi-supp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "api-supp": {
      "type": "http",
      "url": "https://app.api-supp.com/api/mcp"
    }
  }
}

README

wa-bridge-mcp

A small Model Context Protocol (MCP) server that lets an AI assistant (Claude Desktop, Claude Code, etc.) read and send WhatsApp messages through the api-supp WhatsApp bridge.

It's an HTTP client only — every operation goes through the bridge's REST API, so there's no local database, no QR pairing here, and nothing sensitive stored on your machine. You authenticate with a tenant token that scopes the MCP to your own WhatsApp account.

This is a fork of lharries/whatsapp-mcp (MIT), re-worked to talk to a hosted bridge over HTTP. See NOTICE.

What you need

  • Python 3.11+ (and uv recommended)
  • Your bridge URL (default https://api.api-supp.com/v1) and a tenant token (wat_…) — provided to you during onboarding.

Install

bash
git clone https://github.com/yehudashtein/wa-bridge-mcp.gitcd wa-bridge-mcpuv sync        # or: pip install -e .

Configure

The MCP reads its settings from environment variables:

VariableRequiredDefaultNotes
WHATSAPP_BRIDGE_TOKEN✅—Your tenant bearer (wat_…) — keep it secret
WHATSAPP_BRIDGE_URL—https://api.api-supp.com/v1Bridge base URL (include /v1)
WHATSAPP_HTTP_TIMEOUT—30Per-request timeout (seconds)

Copy .env.example → .env for local runs, or set them in your MCP client config.

Claude Desktop / Claude Code

Add to your MCP config (e.g. claude_desktop_config.json or .claude.json):

json
{  "mcpServers": {    "whatsapp": {      "command": "uv",      "args": ["--directory", "/absolute/path/to/wa-bridge-mcp", "run", "main.py"],      "env": {        "WHATSAPP_BRIDGE_URL": "https://api.api-supp.com/v1",        "WHATSAPP_BRIDGE_TOKEN": "wat_your_tenant_token_here"      }    }  }}

Restart the client and the WhatsApp tools appear.

Tools

ToolWhat it does
search_contactsSearch your contacts by name or number
list_chatsList chats (with last message)
get_chat / get_contact_chats / get_direct_chat_by_contactLook up chats
list_messagesRead messages with filters (chat, time, sender, media, …)
get_message_contextMessages around a specific one
get_last_interactionMost recent message with a contact
send_messageSend a text message
send_file / send_audio_messageSend media / voice notes
download_mediaDownload media from a message
sync_historyAsk the bridge to re-sync history

Notes

  • The token scopes you to your own WhatsApp account; it can't see other users' data.
  • Non-ASCII text (Hebrew/Arabic/emoji) sends fine — the bridge handles encoding.
  • Nothing is stored locally; the MCP is a thin HTTP client.

License

MIT — see LICENSE and NOTICE (derivative of lharries/whatsapp-mcp).

Source: README.md at commit 61ae463

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestNov 14, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Supp integrations