npm package: @periskope/whatsapp-mcp-staging
Description: 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.
Author: Periskope
Latest version: 0.2.5

# 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`:

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

Make sure to:
1. Replace `your_periskope_api_key_here` with your actual Periskope API key
2. Replace `your_periskope_phone_id_here` with your actual Periskope phone ID

## Available Tools

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

### WhatsApp Messaging

- **periskope_send_message**: Sends a WhatsApp message to a specified number
- **periskope_edit_message**: Edits a message in a chat
- **periskope_delete_message**: Deletes a message from a chat
- **periskope_forward_message**: Forwards a message to other chats

### 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_contact_labels**: Updates the labels of a WhatsApp contact

### 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:

1. Sign up for an account at [console.periskope.app](https://console.periskope.app)
2. Navigate to **Settings > API settings** in your console.
3. Generate a new API key
4. 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: support@periskope.app
- Website: [periskope.app](https://periskope.app)