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.

I’m using WSL on Windows, and seeing an error

Try instead to connect using:


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

Does the MCP support Streamable HTTP?

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

How do I authenticate?

The MCP server uses Bearer token authentication. Pass your Volt API key in the Authorization: Bearer YOUR_VOLT_API_KEY header. You can find your API key in Volt App Settings .

What tools are available?

The Volt MCP server currently supports:

Tool	Description
`send-message`	Send WhatsApp messages to phone numbers or chats
`search-contact`	Search WhatsApp contacts, groups, and recent chats by name or phone number
`list-chats`	List WhatsApp chats (individual and group), with optional filtering
`get-chat-messages`	Read messages from a WhatsApp chat with optional filtering and date ranges
`create-group`	Create a new WhatsApp group with specified participants
`add-participants-to-group`	Add participants to an existing WhatsApp group
`remove-participants-from-group`	Remove participants from a WhatsApp group
`promote-participants-to-admins`	Promote participants to admins in a WhatsApp group
`demote-participants-from-admins`	Demote participants from admin status in a WhatsApp group

More tools are being added regularly.