Skip to main content

​
What is MCP (Model Context Protocol)

Model Context Protocol (MCP) is a standardized interface that allows AI models like Claude and GPT to interact with external services and tools. It provides a structured way for AI assistants to execute actions, access data, and control applications through predefined functions and commands. In the context of Periskope WhatsApp, MCP enables AI assistants to directly manage WhatsApp conversations, send messages, handle contacts, and perform other WhatsApp-related operations programmatically.

​
Setup

1

Connect WhatsApp

  1. Sign up for an account at console.periskope.app
  2. You will need a phone number that you will use to manage all your WhatsApp chats, groups and communities logged in on WhatsApp.
  3. Open Settings on your WhatsApp App and click on Link device
  4. Now scan the QR code shown on Periskope screen
If you face any errors, click on refetch QR to fetch a new QR code.
2

Add MCP to your AI client

Paste the following URL into your AI client’s MCP server configuration:
  1. Open Claude Desktop and go to Customize
  2. Navigate to Connectors → Add custom connector
  3. Paste https://api.periskope.app/mcp as the server URL
  4. Click Add
Claude Desktop MCP setup

Claude Desktop MCP settings

3

Authorize via OAuth

After adding the MCP server URL, your client will open the Periskope authorization page.
  1. Select your organization from the list
  2. Choose the WhatsApp phone(s) you want to grant access to
  3. Click Authorize
You’ll be redirected back to your AI client — fully connected and ready to use.
OAuth authorization screen

Periskope OAuth authorization screen

​
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
  • periskope_list_all_messages: Lists all messages across all chats globally
  • periskope_list_all_notifications: Lists all notifications across all chats globally
  • periskope_get_chat_notifications: Gets notifications for a specific chat
  • periskope_get_chat_notes: Gets all private notes in a specific chat

​
Message Management

  • periskope_send_message: Sends a WhatsApp message (text, media, or poll) to a specified chat
  • periskope_list_messages_in_a_chat: Lists all messages in a specific WhatsApp chat
  • periskope_list_messages_in_a_chat_by_id: Gets a message by its ID
  • periskope_get_message_status: Gets the delivery status of a message
  • periskope_react_to_message: Reacts to a message
  • periskope_forward_message: Forwards a message to other chats
  • periskope_broadcast_message: Broadcasts a message to multiple chats at once
  • periskope_pin_message: Pins or unpins a message in a chat
  • 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_create_contact: Creates a new WhatsApp contact
  • periskope_list_contacts: Lists all WhatsApp contacts
  • periskope_update_contact: Updates a WhatsApp contact
  • periskope_update_contact_labels: Updates labels for multiple contacts at once
  • periskope_get_contact_by_id: Gets a contact by its ID
  • periskope_search_contact: Searches for contacts by name
  • periskope_check_contacts: Checks if given contact IDs exist on WhatsApp

​
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_create_ticket: Creates a new ticket
  • periskope_get_all_tickets: Gets all tickets
  • periskope_get_ticket: Gets details about a specific ticket
  • periskope_update_ticket: Updates an existing ticket

​
Task Management

  • periskope_list_tasks: Lists all tasks
  • periskope_get_task: Gets details about a specific task
  • periskope_create_task: Creates a new task
  • periskope_update_task: Updates an existing task

​
Knowledge Base

  • periskope_list_knowledge_base: Lists all knowledge base entries (FAQs and documents)
  • periskope_get_context_by_id: Fetches a knowledge base FAQ entry by its context ID
  • periskope_get_document_by_id: Gets a knowledge base document by its document ID
  • periskope_create_faq: Creates a new FAQ entry in the knowledge base
  • periskope_update_faq: Updates an existing FAQ entry in the knowledge base
  • periskope_delete_faq: Deletes a FAQ entry from the knowledge base
  • periskope_create_document: Uploads a PDF document to the knowledge base via URL or base64
  • periskope_delete_document: Deletes a document from the knowledge base

​
Private Notes

  • periskope_create_private_note: Creates a private internal note in a chat (not visible to customers)
  • periskope_list_private_notes: Lists all private notes
  • periskope_get_private_note_by_id: Gets a private note by its ID

​
Reactions

  • periskope_get_reactions: Gets reactions with optional filtering by chat, message, and time range

​
Team Management

  • periskope_invite_members: Invites new team members by email

​
AI

  • periskope_trigger_ai_reply: Triggers an AI-generated reply for a specific chat message

​
Use Cases

Ticket Management

Close, reopen, reassign, and update tickets directly through natural language. Set priorities, add labels, update status, and manage ticket properties effortlessly.
“Close all tickets assigned to John and reassign them to Sarah with high priority”

Sentiment Analysis

Understand how customers feel across all your WhatsApp conversations. Fetch recent messages from any chat and ask your AI assistant to analyze tone, flag unhappy customers, and surface conversations that need urgent attention.
“Read the last 20 messages from the latest 5 chats and tell me which customers seem frustrated”

Message Operations

Send, search, forward, and delete messages on WhatsApp with simple commands. Search message history, bulk forward content, and manage message reactions all through conversation.
“Search for messages containing ‘invoice’ in the last week and forward them to the accounting group”

Chat Management

Create and update chats, manage group settings, and handle chat properties. Set descriptions, images, and control messaging permissions through natural language.
“Create a new group called ‘Project Alpha’ with Bob, Alice, and Charlie, and set it to admin-only messages”

Group Administration

Add, remove, demote, and promote group participants with ease. Manage admin privileges and participant access through simple commands.
“Add the new interns to the ‘Marketing Team’ group and promote Sarah to admin”

Contact Management

Search, update, and manage contact information efficiently. Add labels, update contact properties, and organize your WhatsApp contacts through conversation.
“Find all contacts labeled as ‘VIP’ and update their custom properties to include their company names”