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
Connect WhatsApp
- Sign up for an account at console.periskope.app
- You will need a phone number that you will use to manage all your WhatsApp chats, groups and communities logged in on WhatsApp.
- Open Settings on your WhatsApp App and click on Link device
- Now scan the QR code shown on Periskope screen
If you face any errors, click on refetch QR to fetch a new QR code.
Add MCP to your AI client
Paste the following URL into your AI client’s MCP server configuration:
- Claude Desktop
- ChatGPT
- Config file
- Open Claude Desktop and go to Customize
- Navigate to Connectors → Add custom connector
- Paste
https://api.periskope.app/mcpas the server URL - Click Add
Authorize via OAuth
After adding the MCP server URL, your client will open the Periskope authorization page.
- Select your organization from the list
- Choose the WhatsApp phone(s) you want to grant access to
- Click Authorize
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”
“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”
“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”
“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”
“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”
“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”
“Find all contacts labeled as ‘VIP’ and update their custom properties to include their company names”