Connect your AI assistant to WhatsApp in seconds using Periskope’s hosted MCP server
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.
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
You’ll be redirected back to your AI client — fully connected and ready to use.
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_media: Downloads a message’s attachment (image, document, audio, video) and returns it inline so the AI can view or read it — media URLs in message results are private links the AI cannot open on its own
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”
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Periskope Docs","colors":{"primary":"#15803D","light":"#15803D"},"logo":{"light":"https://mintcdn.com/bharatkumarramesh/Sq5VlnE2OgDOCH8s/logo/periskope-logo-full.svg?fit=max\u0026auto=format\u0026n=Sq5VlnE2OgDOCH8s\u0026q=85\u0026s=cace2e822ea7c0cd2a98b9d946baa593","dark":"https://mintcdn.com/bharatkumarramesh/Sq5VlnE2OgDOCH8s/logo/periskope-logo-full.svg?fit=max\u0026auto=format\u0026n=Sq5VlnE2OgDOCH8s\u0026q=85\u0026s=cace2e822ea7c0cd2a98b9d946baa593"},"favicon":"https://mintcdn.com/bharatkumarramesh/4Au0rGi6EzWXLRIt/logo/periskope-logo.svg?fit=max\u0026auto=format\u0026n=4Au0rGi6EzWXLRIt\u0026q=85\u0026s=275c52e578008a630d9a4c6e150100a0","api":{"playground":{"display":"none"}},"appearance":{"strict":true},"navbar":{"links":[{"href":"https://www.postman.com/periskope/workspace/periskope-platform-api","label":"Postman API collection"},{"href":"https://what.sapp.link/periskope","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://console.periskope.app"}},"footer":{"socials":{"twitter":"https://twitter.com/periskope_app","linkedin":"https://www.linkedin.com/company/periskope-app","youtube":"https://www.youtube.com/@PeriskopeApp"}},"integrations":{"gtm":{"tagId":"GTM-N9SPZLGR"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bharatkumarramesh","hasAudioNarration":false,"actualSubdomain":"bharatkumarramesh","customDomains":["docs.periskope.app"],"gitSource":{"type":"github","owner":"periskope-org","repo":"docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afd3d11e5291c07d426c387","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"APIs \u0026 Webhooks","count":136},{"language":"default","tag":"Documentation","count":69},{"language":"default","tag":"Webhooks","count":21},{"language":"default","tag":"API","count":14},{"language":"default","tag":"Message APIs","count":14},{"language":"default","tag":"Chat APIs","count":13},{"language":"default","tag":"AI Agent","count":12},{"language":"default","tag":"Manage WhatsApp Groups, 1:1 Chats \u0026 Communities","count":11},{"language":"default","tag":"Objects","count":10},{"language":"default","tag":"Group Settings APIs","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".image-container{max-width:50%;margin:0 auto}"}],"page":{"pagePath":"ai/mcp","slug":"/ai/mcp","pageMetadata":{"title":"Periskope Whatsapp MCP","description":"Connect your AI assistant to WhatsApp in seconds using Periskope's hosted MCP server","href":"/ai/mcp"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect your AI assistant to WhatsApp in seconds using Periskope’s hosted MCP server\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,CodeBlock,Frame,Heading,Info,OptimizedImage,Step,Steps,Tab,Tabs}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`what-is-mcp-model-context-protocol`,children:`What is MCP (Model Context Protocol)`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://modelcontextprotocol.io/introduction`,children:`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 `,_jsx(_components.strong,{children:`manage WhatsApp conversations, send messages, handle contacts, and perform other WhatsApp-related operations`}),` programmatically.`]}),`\n`,_jsx(Heading,{level:`2`,id:`setup`,children:`Setup`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Connect WhatsApp`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Sign up for an account at `,_jsx(_components.a,{href:`https://console.periskope.app`,children:`console.periskope.app`})]}),`\n`,_jsx(_components.li,{children:`You will need a phone number that you will use to manage all your WhatsApp chats, groups and communities logged in on WhatsApp.`}),`\n`,_jsxs(_components.li,{children:[`Open Settings on your WhatsApp App and click on `,_jsx(_components.strong,{children:`Link device`})]}),`\n`,_jsx(_components.li,{children:`Now scan the QR code shown on Periskope screen`}),`\n`]}),_jsx(Info,{children:_jsxs(_components.p,{children:[`If you face any errors, click on `,_jsx(_components.strong,{children:`refetch QR`}),` to fetch a new QR code.`]})})]}),_jsxs(Step,{title:`Add MCP to your AI client`,children:[_jsx(_components.p,{children:`Paste the following URL into your AI client’s MCP server configuration:`}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://api.periskope.app/mcp`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Claude Desktop`,id:`claude-desktop`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open Claude Desktop and go to `,_jsx(_components.strong,{children:`Customize`})]}),`\n`,_jsxs(_components.li,{children:[`Navigate to `,_jsx(_components.strong,{children:`Connectors`}),` → `,_jsx(_components.strong,{children:`Add custom connector`})]}),`\n`,_jsxs(_components.li,{children:[`Paste `,_jsx(_components.code,{children:`https://api.periskope.app/mcp`}),` as the server URL`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Add`})]}),`\n`]}),_jsx(Frame,{caption:`Claude Desktop MCP settings`,children:_jsx(OptimizedImage,{className:`mint-block mint-border mint-rounded-xl mint-shadow`,src:`https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/claude-desktop-mcp.png?fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=c4c17ffb9ea1d173f806d29c83680c1b`,alt:`Claude Desktop MCP setup`,\"data-og-width\":`2364`,width:`2364`,\"data-og-height\":`1560`,height:`1560`,\"data-path\":`integrations/mcp/claude-desktop-mcp.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/claude-desktop-mcp.png?w=280\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=47d6308f768cc94a597469e4d12766ce 280w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/claude-desktop-mcp.png?w=560\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=572deeb7c124272d392c6614e178e90a 560w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/claude-desktop-mcp.png?w=840\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=e27ea3ed26c191db622ecd07f6490950 840w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/claude-desktop-mcp.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=765f941590c2a35ad31b17f02b0ef4ce 1100w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/claude-desktop-mcp.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=53f03191af63c3f369ea55895e611b58 1650w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/claude-desktop-mcp.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=32431f957b3bcd32c609ae6bd9ee2ea2 2500w`})})]}),_jsxs(Tab,{title:`ChatGPT`,id:`chatgpt`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open ChatGPT and go to `,_jsx(_components.strong,{children:`Settings`})]}),`\n`,_jsxs(_components.li,{children:[`Navigate to `,_jsx(_components.strong,{children:`Apps`}),` → `,_jsx(_components.strong,{children:`Add Advanced Settings`}),` → `,_jsx(_components.strong,{children:`Turn on Developer mode`}),` → `,_jsx(_components.strong,{children:`Create app`})]}),`\n`,_jsxs(_components.li,{children:[`Paste `,_jsx(_components.code,{children:`https://api.periskope.app/mcp`}),` as the server URL`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Connect`})]}),`\n`]}),_jsx(Frame,{caption:`ChatGPT connector settings`,children:_jsx(OptimizedImage,{className:`mint-block mint-border mint-rounded-xl mint-shadow`,src:`https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/chatgpt-mcp.png?fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=e5c5e510393aff71d2c58080a2dd1b6d`,alt:`ChatGPT MCP setup`,\"data-og-width\":`1213`,width:`1213`,\"data-og-height\":`971`,height:`971`,\"data-path\":`integrations/mcp/chatgpt-mcp.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/chatgpt-mcp.png?w=280\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=a593776f260c89aeac6735870a51f234 280w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/chatgpt-mcp.png?w=560\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=5c98ccda6a3d11c5b109373e447ab6dd 560w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/chatgpt-mcp.png?w=840\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=96c41bce6b98293038100c3f4f1f8fe5 840w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/chatgpt-mcp.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=63638559ff0a90eaa03429150b372d3f 1100w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/chatgpt-mcp.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=3b3cdaaac041f7ec69432890f9ab5ae6 1650w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/chatgpt-mcp.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=92dfd97dcbfc10cc574dd5d2e0a4021c 2500w`})})]}),_jsxs(Tab,{title:`Config file`,id:`config-file`,children:[_jsxs(_components.p,{children:[`Add the following to your `,_jsx(_components.code,{children:`mcp.json`}),` configuration file:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcpServers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"periskope\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.periskope.app/mcp\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]})]}),_jsxs(Step,{title:`Authorize via OAuth`,children:[_jsx(_components.p,{children:`After adding the MCP server URL, your client will open the Periskope authorization page.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Select your organization`}),` from the list`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Choose the WhatsApp phone(s)`}),` you want to grant access to`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Authorize`})]}),`\n`]}),_jsx(_components.p,{children:`You’ll be redirected back to your AI client — fully connected and ready to use.`}),_jsx(Frame,{caption:`Periskope OAuth authorization screen`,children:_jsx(OptimizedImage,{className:`mint-block mint-border mint-rounded-xl mint-shadow`,src:`https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/oauth-consent.png?fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=a3a6629fd31d5851ef39dce5cd3f4e87`,alt:`OAuth authorization screen`,\"data-og-width\":`2242`,width:`2242`,\"data-og-height\":`1392`,height:`1392`,\"data-path\":`integrations/mcp/oauth-consent.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/oauth-consent.png?w=280\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=9b17fe1fb4d40bcbe4296c9ba4ebb8e1 280w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/oauth-consent.png?w=560\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=304c6ae910e21c4f897fdd2907b668b8 560w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/oauth-consent.png?w=840\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=a6521c01c52d99721ada00b4cdc0829c 840w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/oauth-consent.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=d19c990443713acd3add06d6e452538c 1100w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/oauth-consent.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=81908cdd055a0b82197a4badbfb74811 1650w, https://mintcdn.com/bharatkumarramesh/jmkHMscwYb258Qi5/integrations/mcp/oauth-consent.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jmkHMscwYb258Qi5\u0026q=85\u0026s=667f966628e0f4075e573b5b9f2586d3 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`available-tools`,children:`Available Tools`}),`\n`,_jsx(_components.p,{children:`The MCP provides several tools for interacting with Periskope’s WhatsApp API:`}),`\n`,_jsx(Heading,{level:`3`,id:`chat-management`,children:`Chat Management`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_chats`}),`: Lists all WhatsApp chats`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_chat`}),`: Gets details about a specific WhatsApp chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_create_chat`}),`: Creates a new WhatsApp group chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_update_chat_labels`}),`: Updates the labels of a WhatsApp chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_update_chat`}),`: Updates a WhatsApp chat properties on Periskope`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_update_chat_settings`}),`: Updates the settings of a WhatsApp chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_search_chat`}),`: Searches for chats by name`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_all_messages`}),`: Lists all messages across all chats globally`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_all_notifications`}),`: Lists all notifications across all chats globally`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_chat_notifications`}),`: Gets notifications for a specific chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_chat_notes`}),`: Gets all private notes in a specific chat`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`message-management`,children:`Message Management`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_send_message`}),`: Sends a WhatsApp message (text, media, or poll) to a specified chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_messages_in_a_chat`}),`: Lists all messages in a specific WhatsApp chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_messages_in_a_chat_by_id`}),`: Gets a message by its ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_media`}),`: Downloads a message’s attachment (image, document, audio, video) and returns it inline so the AI can view or read it — media URLs in message results are private links the AI cannot open on its own`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_message_status`}),`: Gets the delivery status of a message`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_react_to_message`}),`: Reacts to a message`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_forward_message`}),`: Forwards a message to other chats`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_broadcast_message`}),`: Broadcasts a message to multiple chats at once`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_pin_message`}),`: Pins or unpins a message in a chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_edit_message`}),`: Edits a message in a chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_delete_message`}),`: Deletes a message from a chat`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_search_message`}),`: Searches for messages by content`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`contact-management`,children:`Contact Management`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_create_contact`}),`: Creates a new WhatsApp contact`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_contacts`}),`: Lists all WhatsApp contacts`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_update_contact`}),`: Updates a WhatsApp contact`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_update_contact_labels`}),`: Updates labels for multiple contacts at once`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_contact_by_id`}),`: Gets a contact by its ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_search_contact`}),`: Searches for contacts by name`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_check_contacts`}),`: Checks if given contact IDs exist on WhatsApp`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`group-management`,children:`Group Management`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_add_participants_to_group`}),`: Adds participants to a WhatsApp group`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_remove_participants_from_group`}),`: Removes participants from a WhatsApp group`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_promote_participants_to_admins`}),`: Promotes participants to admins in a WhatsApp group`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_demote_participants_from_admins`}),`: Demotes participants from admins in a WhatsApp group`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`ticket-management`,children:`Ticket Management`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_create_ticket`}),`: Creates a new ticket`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_all_tickets`}),`: Gets all tickets`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_ticket`}),`: Gets details about a specific ticket`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_update_ticket`}),`: Updates an existing ticket`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`task-management`,children:`Task Management`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_tasks`}),`: Lists all tasks`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_task`}),`: Gets details about a specific task`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_create_task`}),`: Creates a new task`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_update_task`}),`: Updates an existing task`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`knowledge-base`,children:`Knowledge Base`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_knowledge_base`}),`: Lists all knowledge base entries (FAQs and documents)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_context_by_id`}),`: Fetches a knowledge base FAQ entry by its context ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_document_by_id`}),`: Gets a knowledge base document by its document ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_create_faq`}),`: Creates a new FAQ entry in the knowledge base`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_update_faq`}),`: Updates an existing FAQ entry in the knowledge base`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_delete_faq`}),`: Deletes a FAQ entry from the knowledge base`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_create_document`}),`: Uploads a PDF document to the knowledge base via URL or base64`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_delete_document`}),`: Deletes a document from the knowledge base`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`private-notes`,children:`Private Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_create_private_note`}),`: Creates a private internal note in a chat (not visible to customers)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_list_private_notes`}),`: Lists all private notes`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_private_note_by_id`}),`: Gets a private note by its ID`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`reactions`,children:`Reactions`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_get_reactions`}),`: Gets reactions with optional filtering by chat, message, and time range`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`team-management`,children:`Team Management`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_invite_members`}),`: Invites new team members by email`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`ai`,children:`AI`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`periskope_trigger_ai_reply`}),`: Triggers an AI-generated reply for a specific chat message`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsxs(Card,{title:`Ticket Management`,icon:`ticket`,children:[_jsx(_components.p,{children:`Close, reopen, reassign, and update tickets directly through natural language. Set priorities, add labels, update status, and manage ticket properties effortlessly.`}),_jsx(`br`,{}),_jsx(_components.p,{children:_jsx(_components.em,{children:`“Close all tickets assigned to John and reassign them to Sarah with high priority”`})})]}),`\n`,_jsxs(Card,{title:`Sentiment Analysis`,icon:`face-smile`,children:[_jsx(_components.p,{children:`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.`}),_jsx(`br`,{}),_jsx(_components.p,{children:_jsx(_components.em,{children:`“Read the last 20 messages from the latest 5 chats and tell me which customers seem frustrated”`})})]}),`\n`,_jsxs(Card,{title:`Message Operations`,icon:`message-dots`,children:[_jsx(_components.p,{children:`Send, search, forward, and delete messages on WhatsApp with simple commands. Search message history, bulk forward content, and manage message reactions all through conversation.`}),_jsx(`br`,{}),_jsx(_components.p,{children:_jsx(_components.em,{children:`“Search for messages containing ‘invoice’ in the last week and forward them to the accounting group”`})})]}),`\n`,_jsxs(Card,{title:`Chat Management`,icon:`messages`,children:[_jsx(_components.p,{children:`Create and update chats, manage group settings, and handle chat properties. Set descriptions, images, and control messaging permissions through natural language.`}),_jsx(`br`,{}),_jsx(_components.p,{children:_jsx(_components.em,{children:`“Create a new group called ‘Project Alpha’ with Bob, Alice, and Charlie, and set it to admin-only messages”`})})]}),`\n`,_jsxs(Card,{title:`Group Administration`,icon:`users`,children:[_jsx(_components.p,{children:`Add, remove, demote, and promote group participants with ease. Manage admin privileges and participant access through simple commands.`}),_jsx(`br`,{}),_jsx(_components.p,{children:_jsx(_components.em,{children:`“Add the new interns to the ‘Marketing Team’ group and promote Sarah to admin”`})})]}),`\n`,_jsxs(Card,{title:`Contact Management`,icon:`address-book`,children:[_jsx(_components.p,{children:`Search, update, and manage contact information efficiently. Add labels, update contact properties, and organize your WhatsApp contacts through conversation.`}),_jsx(`br`,{}),_jsx(_components.p,{children:_jsx(_components.em,{children:`“Find all contacts labeled as ‘VIP’ and update their custom properties to include their company names”`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Periskope Whatsapp MCP","description":"Connect your AI assistant to WhatsApp in seconds using Periskope's hosted MCP server","href":"/ai/mcp"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What is MCP (Model Context Protocol)","slug":"what-is-mcp-model-context-protocol","depth":3,"children":[]},{"title":"Setup","slug":"setup","depth":2,"children":[]},{"title":"Available Tools","slug":"available-tools","depth":2,"children":[{"title":"Chat Management","slug":"chat-management","depth":3,"children":[]},{"title":"Message Management","slug":"message-management","depth":3,"children":[]},{"title":"Contact Management","slug":"contact-management","depth":3,"children":[]},{"title":"Group Management","slug":"group-management","depth":3,"children":[]},{"title":"Ticket Management","slug":"ticket-management","depth":3,"children":[]},{"title":"Task Management","slug":"task-management","depth":3,"children":[]},{"title":"Knowledge Base","slug":"knowledge-base","depth":3,"children":[]},{"title":"Private Notes","slug":"private-notes","depth":3,"children":[]},{"title":"Reactions","slug":"reactions","depth":3,"children":[]},{"title":"Team Management","slug":"team-management","depth":3,"children":[]},{"title":"AI","slug":"ai","depth":3,"children":[]}]},{"title":"Use Cases","slug":"use-cases","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-block {\n display: block\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}\n.mint-border {\n border-width: 1px\n}\n.mint-shadow {\n --tw-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);\n --tw-shadow-colored: 0 1px 3px 0 var(--tw-shadow-color), 0 1px 2px -1px var(--tw-shadow-color);\n box-shadow: var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow)\n}","subdomain":"bharatkumarramesh","siteName":"Periskope Docs","title":"Periskope Whatsapp MCP - Periskope Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T14:08:14.517Z","originalFileLocation":"ai/mcp.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect your AI assistant to WhatsApp in seconds using Periskope\u0026#x27;s hosted MCP server\">\u003cmeta data-mint-head name=\"application-name\" content=\"Periskope Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Periskope Whatsapp MCP - Periskope Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect your AI assistant to WhatsApp in seconds using Periskope\u0026#x27;s hosted MCP server\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Periskope Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.periskope.app/ai/mcp\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bharatkumarramesh.mintlify.site/_mintlify/api/og/v2?division=AI+Automation+for+WhatsApp\u0026amp;title=Periskope+Whatsapp+MCP\u0026amp;description=Connect+your+AI+assistant+to+WhatsApp+in+seconds+using+Periskope%27s+hosted+MCP+server\u0026amp;theme=c8ab22e6a9eb26c6f79b535c\u0026amp;signature=60eab628eff7009a2650889f2577ed27ce1eca8f67b5be415c2fdcbc5c644acb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Periskope Whatsapp MCP - Periskope Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect your AI assistant to WhatsApp in seconds using Periskope\u0026#x27;s hosted MCP server\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bharatkumarramesh.mintlify.site/_mintlify/api/og/v2?division=AI+Automation+for+WhatsApp\u0026amp;title=Periskope+Whatsapp+MCP\u0026amp;description=Connect+your+AI+assistant+to+WhatsApp+in+seconds+using+Periskope%27s+hosted+MCP+server\u0026amp;theme=c8ab22e6a9eb26c6f79b535c\u0026amp;signature=60eab628eff7009a2650889f2577ed27ce1eca8f67b5be415c2fdcbc5c644acb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bharatkumarramesh/xEFzGZM_csru_Nms/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Periskope Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#15803D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.periskope.app/ai/mcp\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai/mcp.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.periskope.app/#organization\",\"name\":\"Periskope Docs\",\"url\":\"https://docs.periskope.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bharatkumarramesh/Sq5VlnE2OgDOCH8s/logo/periskope-logo-full.svg?fit=max\u0026auto=format\u0026n=Sq5VlnE2OgDOCH8s\u0026q=85\u0026s=cace2e822ea7c0cd2a98b9d946baa593\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.periskope.app#website\",\"name\":\"Periskope Docs\",\"url\":\"https://docs.periskope.app\",\"publisher\":{\"@id\":\"https://docs.periskope.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.periskope.app/ai/mcp#webpage\",\"url\":\"https://docs.periskope.app/ai/mcp\",\"name\":\"Periskope Whatsapp MCP\",\"description\":\"Connect your AI assistant to WhatsApp in seconds using Periskope's hosted MCP server\",\"dateModified\":\"2026-10-05T14:08:14.517Z\",\"isPartOf\":{\"@id\":\"https://docs.periskope.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.periskope.app/ai/mcp#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.periskope.app/ai/mcp#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI Automation for WhatsApp\",\"item\":\"https://docs.periskope.app/ai/flagging\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Periskope Whatsapp MCP\",\"item\":\"https://docs.periskope.app/ai/mcp\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.periskope.app/ai/mcp#article\",\"headline\":\"Periskope Whatsapp MCP\",\"name\":\"Periskope Whatsapp MCP\",\"description\":\"Connect your AI assistant to WhatsApp in seconds using Periskope's hosted MCP server\",\"url\":\"https://docs.periskope.app/ai/mcp\",\"mainEntityOfPage\":{\"@id\":\"https://docs.periskope.app/ai/mcp#webpage\"},\"dateModified\":\"2026-10-05T14:08:14.517Z\",\"publisher\":{\"@id\":\"https://docs.periskope.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.periskope.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Periskope Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Periskope Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ai/mcp.md","siteName":"Periskope Docs","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/get-started/introduction"},{"title":"Setting up your account","href":"/get-started/setup-account"},{"title":"Connect WhatsApp to Periskope","href":"/get-started/connect-whatsapp"},{"title":"Best Practices","href":"/get-started/best-practices"},{"title":"Warming Up New Numbers","href":"/get-started/warmup-numbers"}]},{"group":"Manage WhatsApp Groups, 1:1 Chats \u0026 Communities","pages":[{"title":"Multi-Number Inbox","href":"/features/multi-number-inbox"},{"title":"Team Access \u0026 Roles","href":"/features/team-access-roles"},{"title":"Number Masking \u0026 Privacy","href":"/features/number-masking-privacy"},{"title":"Media Privacy","href":"/features/media-privacy"},{"title":"Labels","href":"/features/labels"},{"title":"Custom Properties","href":"/features/custom-properties"},{"title":"Quick Replies","href":"/features/quick-replies"},{"title":"Private Notes","href":"/features/private-note"},{"title":"Scheduled \u0026 Recurring Messages","href":"/features/recurring-scheduled-messages"},{"title":"Chat List Bulk Actions","href":"/features/bulk-actions"},{"title":"Calling","href":"/features/calling"}]},{"group":"Tickets, Tasks and Reminders","pages":[{"title":"Create a Ticket on WhatsApp","href":"/tickets/create-ticket"},{"title":"Create Ticket with an Emoji","href":"/tasks-and-reminders/emoji-ticketing"},{"title":"Custom Properties for Tickets","href":"/features/custom-properties-for-tickets"},{"title":"Export Tickets","hidden":true,"href":"/tickets/export-tickets"},{"title":"Create a Task","href":"/tasks-and-reminders/tasks"},{"title":"Export Tickets","hidden":true,"href":"/tickets/export-tickets"},{"title":"Set Reminders for Tasks","hidden":true,"href":"/tasks-and-reminders/reminders"},{"title":"Task Actions (filters, sorting \u0026 actions)","hidden":true,"href":"/tasks-and-reminders/task-options"}]},{"group":"Bulk Messages","pages":[{"title":"Sending a Bulk Message","href":"/features/bulk-message"},{"title":"Repeating Bulk Messages","href":"/features/bulk-message-repeating"},{"title":"Variables \u0026 Message Templates","href":"/features/bulk-message-variables-templates"},{"title":"Saved Chat Lists","href":"/features/bulk-message-saved-chat-lists"},{"title":"Logs","href":"/features/bulk-message-logs"},{"title":"Broadcast Credits","href":"/features/bulk-message-credits"}]},{"group":"AI Agent","pages":[{"title":"AI Agent Overview","href":"/ai/agent/overview"},{"title":"Activation","href":"/ai/agent/settings"},{"title":"Personalization","href":"/ai/agent/personalization"},{"title":"Knowledge Base","href":"/ai/agent/training"},{"title":"Self-Training","href":"/ai/agent/self-training"},{"title":"Built-in Tools","href":"/ai/agent/built-in-tools"},{"title":"Custom Tools","href":"/ai/agent/custom-tools"},{"title":"Connectors","href":"/ai/agent/connectors"},{"title":"Agent Mode","href":"/ai/agent/agent-mode"},{"title":"Org \u0026 Chat Assistant","href":"/ai/agent/ai-assistant"},{"title":"AI Dictate","href":"/ai/agent/ai-dictate"},{"title":"AI Credits","href":"/features/ai-credits"}]},{"group":"AI Automation for WhatsApp","pages":[{"title":"Flag Messages with AI","href":"/ai/flagging"},{"title":"AI Summaries and Responses","description":"Guide to generate chat summaries and craft contextual responses with Periskope AI","href":"/ai/summaries"},{"title":"Periskope Whatsapp MCP","href":"/ai/mcp"},{"title":"Respond \u0026 Escalate to Humans","description":null,"href":"/ai/respond-and-esclate-to-humans-1"},{"title":"Translate with AI","href":"/ai/translate-with-ai"}]},{"group":"Automation Rules","pages":[{"title":"What are Automation Rules?","href":"/integrations/automation-rules/overview"},{"title":"Components of Automation Rules","href":"/integrations/automation-rules/components"},{"title":"Triggers","hidden":true,"href":"/integrations/automation-rules/triggers"},{"title":"Conditions","hidden":true,"href":"/integrations/automation-rules/conditions"},{"title":"Actions","hidden":true,"href":"/integrations/automation-rules/actions"},{"title":"Setting up Automation Rules","href":"/integrations/automation-rules/setup"}]},{"group":"Most Used Automation Rules","pages":[{"title":"Automated Ticketing","href":"/automated-ticketing-rules"},{"title":"Automated Replies","href":"/automated-replies"},{"title":"Automated Assignment","href":"/automated-assignment"},{"title":"Automated Escalation","href":"/automated-escalation"},{"title":"Automated Flagging","href":"/automated-flagging"},{"title":"Automated Notifications","href":"/automated-notifications"},{"title":"Create Ticket for SLA Breaches","href":"/create-ticket-for-sla-breaches"},{"title":"Create Tickets from Keywords","href":"/create-tickets-from-keywords"},{"title":"Auto Assign Support Tickets","href":"/auto-assign-support-tickets"}]},{"group":"Most Used Automation Rules","hidden":true,"pages":[{"title":"Create Ticket for SLA Breaches","href":"/create-ticket-for-sla-breaches"},{"title":"Create Tickets from Keywords","href":"/create-tickets-from-keywords"},{"title":"Auto Assign Support Tickets","href":"/auto-assign-support-tickets"}]},{"group":"Analytics","pages":[{"title":"Track Team Performance ","href":"/analytics"},{"title":"Export and Analyze Your Data","href":"/export-and-analyze-your-data"},{"title":"Track and Export Ticket Metrics","href":"/track-and-export-ticket-metrics"},{"title":"Workspace Metrics","href":"/features/workspace-metrics"},{"title":"Data Exports","href":"/features/export-data"}]},{"group":"Workflows","pages":[{"title":"Overview","href":"/integrations/workflows/overview"},{"title":"Triggers","href":"/integrations/workflows/triggers"},{"title":"Actions","href":"/integrations/workflows/actions"}]},{"group":"Integrations","pages":[{"title":"HubSpot","href":"/integrations/hubspot"},{"title":"Zoho CRM","href":"/integrations/zohocrm"},{"title":"Google Sheets","href":"/integrations/google-sheets"},{"title":"Freshdesk","href":"/integrations/freshdesk"},{"title":"Zohodesk","href":"/integrations/zohodesk"},{"title":"Zapier","href":"/integrations/zapier"}]},{"group":"Troubleshooting","pages":[{"title":"Fix \"Not receiving notifications on Periskope\"","href":"/troubleshooting/notifications"},{"title":"Fix \"Can't use Periskope due to App crashes\"","href":"/troubleshooting/clear-memory"},{"title":"Fix \"Blank screen or Out of memory issues\"","href":"/troubleshooting/clear-cache"},{"title":"Fix \"Chats not loading\"","href":"/troubleshooting/loading-chat"}]},{"group":"Analytics","hidden":true,"pages":[{"title":"Track Team Performance ","href":"/analytics"}]}]},{"anchor":"APIs \u0026 Webhooks","icon":"webhook","pages":[{"title":"APIs \u0026 Webhooks","href":"/api-reference/introduction"}]},{"anchor":"Free Tools","icon":"toolbox","href":"https://tools.periskope.app"}]},"basePath":"","title":"Periskope Whatsapp MCP - Periskope Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DBAS9Liu.js","DynamicMarkdown-C4w9kavL.js","zoom-image-lightbox-B9O1U98p.js","lightbox-handle-r17bVUz3.js"]}