FAQ

Frequently asked questions about the Volt MCP server.

Why am I seeing an internal server error when trying to connect?

Enter the following in the Terminal to clear saved auth info:


rm -rf ~/.mcp-auth

Then try again to connect. Additionally you may need to update to a newer version of Node if required.

Try instead to connect using:


{
  "mcpServers": {
    "volt": {
      "command": "wsl",
      "args": ["npx", "-y", "mcp-remote", "https://mcp.voltchat.com/mcp"]
    }
  }
}

Yes, at the https://mcp.voltchat.com/mcp endpoint.

Volt supports two authentication methods:

OAuth for hosted connectors — Claude.ai, Claude Desktop, and ChatGPT can redirect you to Volt to sign in with a phone OTP and approve access. No API key or configuration file is required.
API key for developer clients — CLIs, editors, and other MCP-compatible clients can pass the key in the Authorization: Bearer YOUR_VOLT_API_KEY header. Generate it from Volt → Settings → MCP.

See Setup Instructions for client-specific steps.

The Volt MCP server currently supports:

Tool	Description
`send-message`	Send a WhatsApp message immediately to one recipient
`schedule-message`	Schedule a WhatsApp text message for future delivery
`send-broadcast`	Queue the same WhatsApp message for paced background delivery to 4+ recipients
`search-contact`	Search WhatsApp contacts by name, nickname, handle, or phone number
`add-contact`	Save a new contact in WhatsApp using a phone number, PN JID, or LID
`list-chats`	Get WhatsApp chats matching specified criteria
`get-chat-messages`	Read messages from a WhatsApp chat
`create-group`	Create a new WhatsApp group with the specified name and participants
`add-participants-to-group`	Add participants to an existing WhatsApp group when WhatsApp allows it
`remove-participants-from-group`	Remove participants from a WhatsApp group
`promote-participants-to-admins`	Promote participants to admin status in a WhatsApp group
`demote-participants-from-admins`	Demote participants from admin status in a WhatsApp group
`add-chat-to-lists`	Add one WhatsApp chat to one or more existing Volt lists
`remove-chat-from-lists`	Remove one WhatsApp chat from one or more existing Volt lists
`get-chat-lists`	Read the existing Volt lists a WhatsApp chat belongs to
`get-chats-in-list`	List WhatsApp chats that belong to an existing Volt list
`set-chat-read-state`	Mark a WhatsApp chat as read or unread
`set-chat-archive-state`	Archive or unarchive a WhatsApp chat

More tools are being added regularly.