@periskope/whatsapp-mcp

Periskope WhatsApp MCP

The Periskope WhatsApp MCP (Model Context Protocol) tool provides an interface to interact with Periskope's WhatsApp API services through Claude, GPT, and other AI assistants that support the Model Context Protocol.

Prerequisites

• Node.js (v16 or higher)
• A valid Periskope API key
• Periskope Phone ID
• An MCP client (Claude Desktop, Cursor etc.)

Setup

To use the Periskope WhatsApp MCP, you need to add it to your claude_desktop_config.json file. This file is typically located in your home directory under .cursor/mcp.json.

Add the following configuration to your mcp.json:

{
  "mcpServers": {
    "periskope-mcp": {
      "command": "npx",
      "args": ["-y", "@periskope/whatsapp-mcp"],
      "env": {
        "PERISKOPE_API_KEY": "your_periskope_api_key_here",
        "PERISKOPE_PHONE_ID": "your_periskope_phone_id_here"
      }
    }
  }
}

Make sure to:

• Replace your_periskope_api_key_here with your actual Periskope API key
• Replace your_periskope_phone_id_here with your connected Periskope phone number

Available Tools

The MCP provides several tools for interacting with Periskope's WhatsApp API:

Chat Management

• periskope_list_chats: Lists all WhatsApp chats
• periskope_get_chat: Gets details about a specific WhatsApp chat
• periskope_create_chat: Creates a new WhatsApp group chat
• periskope_update_chat_labels: Updates the labels of a WhatsApp chat
• periskope_update_chat: Updates a WhatsApp chat properties on periskope
• periskope_update_chat_settings: Updates the settings of a WhatsApp chat
• periskope_search_chat: Searches for chats by name

Message Management

• periskope_send_message: Sends a WhatsApp message to a specified number
• periskope_list_messages_in_a_chat: Lists all messages in a specific WhatsApp chat
• periskope_get_message_by_id: Gets a message by its ID
• periskope_react_to_message: Reacts to a message
• periskope_forward_message: Forwards a message to other chats
• periskope_edit_message: Edits a message in a chat
• periskope_delete_message: Deletes a message from a chat
• periskope_search_message: Searches for messages by content

Contact Management

• periskope_list_contacts: Lists all WhatsApp contacts
• periskope_update_contact_labels: Updates the labels of a WhatsApp contact
• periskope_update_contact: Updates a WhatsApp contact
• periskope_get_contact_by_id: Gets a contact by its ID
• periskope_search_contact: Searches for contacts by name

Group Management

• periskope_add_participants_to_group: Adds participants to a WhatsApp group
• periskope_remove_participants_from_group: Removes participants from a WhatsApp group
• periskope_promote_participants_to_admins: Promotes participants to admins in a WhatsApp group
• periskope_demote_participants_from_admins: Demotes participants from admins in a WhatsApp group

Ticket Management

• periskope_get_all_tickets: Gets all tickets
• periskope_get_ticket: Gets details about a specific ticket
• periskope_update_ticket: Updates an existing ticket

Obtaining a Periskope API Key

To use this tool, you need a Periskope API key:

• Sign up for an account at console.periskope.app
• Navigate to Settings > API settings in your console.
• Generate a new API key
• Update the PERISKOPE_PHONE_ID with your phone number (with country code and without any special characters) to validate an API request. For e.g. 919876512340.

Support

For issues, questions, or feature requests, please contact:

• Email: [e-mail]
• Website: periskope.app