What can you do with this server?

This server provides 60 MCP tools for managing WhatsApp Business via the 1msg Chat API, covering messaging, media, templates, groups, flows, user management, channel settings, commerce, calling, automation, webhooks, and encryption. * Messaging: Send text, files (images, video, audio, documents), stickers, locations, contacts, address/location requests, reactions, interactive buttons, lists, CTA URLs, carousels, order details, payment requests, products, flows, and templates. Support quoted replies and mark messages as read. * Template Management: Create, list, and remove templates; send template messages with language and parameters. * Media Management: Upload, retrieve metadata, and delete media assets. * Groups: Create, update, delete, list groups; get and reset invite links. * WhatsApp Flows: Create, publish, deprecate, delete, preview, get details, update metadata/structure, and send flow messages. * User Blocking: Block, unblock, and list blocked users. * Profile & Channel: Get/update business profile; get channel status, MM Lite status, and business encryption public key; set encryption key. * Webhooks: Get and set webhook URLs. * Commerce & Payments: Set/get commerce settings; send product messages and payment requests. * Calling: Initiate WhatsApp calls; get/update calling settings. * Conversational Automation: Get/set welcome messages, prompts, and commands. * Message Operations: List messages; create read receipts.

How do I use 1msg MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@1msg MCP Send 'Hello from MCP' to channel #announcements" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

1msg MCP

Official

by 1msg

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

@1msg/mcp

MCP server for the 1msg Chat API — 60 public tools for Cursor, Claude Desktop, and other MCP clients.

Transports: stdio (local) and Streamable HTTP (hosted).


npm	`@1msg/mcp`
Hosted prod	https://mcp.1msg.io/mcp
Hosted stage	https://mcp.stage.1msg.io/mcp
SDK	`@1msg/sdk`

Source of truth for codegen of tools.generated.ts / handlers.generated.ts still lives in the 1msg-api monorepo (packages/mcp). This repository is the distribution package for running and hosting the server.

Quick start

npx (stdio)

export ONE_MSG_BASE_URL=https://api.stage.1msg.io
export ONE_MSG_INSTANCE_ID=your-instance-id
export ONE_MSG_TOKEN=your-channel-token

npx -y @1msg/mcp
# or, after clone + build:
# npm start

Deprecated aliases still work: CHAT_API_BASE_URL, CHAT_API_TOKEN, CHAT_API_INSTANCE_ID.

Clone and run

git clone https://github.com/1msg/1msg-mcp.git
cd 1msg-mcp
npm install
npm run build

export ONE_MSG_BASE_URL=https://api.stage.1msg.io
export ONE_MSG_INSTANCE_ID=your-instance-id
export ONE_MSG_TOKEN=your-channel-token

npm start                 # stdio → dist/index.js
npm run start:http        # Streamable HTTP → dist/http.js

Related MCP server: Vox MCP

Environment variables

Variable	Required	Description
`ONE_MSG_BASE_URL`	yes (stdio)	API base, e.g. `https://api.stage.1msg.io` or `https://api.1msg.io`
`ONE_MSG_TOKEN`	yes (stdio)	Channel API token
`ONE_MSG_INSTANCE_ID`	yes (stdio)	Channel instance id
`MCP_HTTP_HOST`	no	HTTP bind host (default `0.0.0.0` in Docker)
`MCP_HTTP_PORT`	no	HTTP port (default `3100`)
`MCP_RATE_LIMIT_RPM`	no	Per-token rate limit for HTTP (default `60`)

For hosted HTTP, upstream ONE_MSG_BASE_URL is set on the server; clients send credentials per request (see below).

Cursor (`mcp.json`)

Local stdio

{
  "mcpServers": {
    "1msg": {
      "command": "npx",
      "args": ["-y", "@1msg/mcp"],
      "env": {
        "ONE_MSG_BASE_URL": "https://api.stage.1msg.io",
        "ONE_MSG_INSTANCE_ID": "your-instance-id",
        "ONE_MSG_TOKEN": "your-channel-token"
      }
    }
  }
}

Hosted URL (Streamable HTTP)

Prod: https://mcp.1msg.io/mcp · Stage: https://mcp.stage.1msg.io/mcp

{
  "mcpServers": {
    "1msg": {
      "url": "https://mcp.1msg.io/mcp",
      "headers": {
        "Authorization": "Bearer your-channel-token",
        "X-Instance-Id": "your-instance-id"
      }
    }
  }
}

Header aliases: X-1msg-Instance-Id (and deprecated X-Chat-Api-Instance-Id). Do not commit real tokens.

Hosted HTTP locally

export ONE_MSG_BASE_URL=https://api.stage.1msg.io
export MCP_HTTP_PORT=3100
npm run start:http

Auth: Authorization: Bearer <token> + X-Instance-Id: <instanceId>
Health: GET /healthz, GET /readyz

docker build -t 1msg/1msg-mcp-http:local .
docker run --rm -p 3100:3100 \
  -e ONE_MSG_BASE_URL=https://api.stage.1msg.io \
  1msg/1msg-mcp-http:local

Scripts

Script	Purpose
`npm run build`	Compile TypeScript → `dist/`
`npm test`	Jest unit tests
`npm run smoke:tools-list`	Stdio `tools/list` smoke (expects 60 tools; uses dummy token)
`npm start` / `npm run start:http`	Run stdio / HTTP servers

Architecture

All Chat API HTTP goes through @1msg/sdk. See ARCHITECTURE.md.

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

MCP Chat
AI & Machine Learning Command Line Developer Tools
MeeraMendhe
F
license
-
quality
D
maintenance
A command-line interface application enabling interactive chat with AI models via the Anthropic API. It supports document retrieval, command-based prompts, and extensible tool integrations through the MCP architecture.
Updated 4 months ago (2026-04-16 07:03 UTC)
Vox MCP
AI & Machine Learning Developer Tools
linxule
A
license
A
quality
B
maintenance
Enables MCP clients like Claude Code and Cursor to use multiple AI models (Gemini, GPT, Grok, DeepSeek, Kimi, Ollama) via a unified chat tool with conversation memory.
Updated a month ago (2026-07-13 16:44 UTC)
3
Apache 2.0
llmsproxy
AI & Machine Learning Developer Tools
danielckv
A
license
-
quality
A
maintenance
Connects MCP clients (Claude Desktop, Cursor, Cline, Zed) to llmsproxy.ai, exposing chat, coding, and retrieval capabilities as MCP tools, resources, and prompts.
Updated a month ago (2026-07-01 16:00 UTC)
8
Apache 2.0
SystemKernelMCP
Shell Access Virtualization Penetration Testing
needyamin
F
license
-
quality
D
maintenance
Provides 180+ tools for full system control including terminal, Git, Docker, Kubernetes, VMs, BIOS, kernel, cybersecurity, AI, and cloud, designed to work with MCP clients like Cursor and Claude Desktop.
Updated 5 months ago (2026-03-18 01:04 UTC)

View all related MCP servers

Related MCP Connectors

RogerRat
Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.
ToolAPI
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
shortcuts-bridge
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/1msg/1msg-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server