MCP App Store
by KeenEthics
SocialLab icon

SocialLab MCP Server for ChatGPT

By SocialLab

Overview

SocialLab is a customer-communication platform for businesses in Saudi Arabia: WhatsApp, Instagram, Messenger, TikTok and more, with CRM, campaigns and an AI assistant. This plugin lets ChatGPT work in your SocialLab account on your behalf. Ask ChatGPT to find a customer's conversation, summarise what they asked, and reply; to send an approved WhatsApp template or an interactive message; to tag customers, add an internal note or assign a conversation to a teammate; to look up a Salla abandoned cart or a product; and to read your dashboard and campaign performance. Campaigns are created as drafts and sent only when you confirm. You sign in with your SocialLab account and approve access. Every action that changes something asks for your confirmation first. Account admins see every connected assistant and what it changed under Settings > Connected Apps, and can revoke access at any time; a revoked assistant is refused from its next request. Works with SocialLab business accounts that have Partner API access turned on. Free-form WhatsApp replies follow WhatsApp's 24-hour customer-service window; outside it, use an approved template.

How to connect

  1. ChatGPT: Open the SocialLab listing in the ChatGPT app directory and choose Connect. ChatGPT listing SocialLab exposes 32 tools here.

Tools

add_comment

ChatGPT
Add an internal comment / note to a customer (by phone). The note is NOT sent to the customer — it is for internal context and human handoff.

add_customer_tag

ChatGPT
Add a tag to a customer by phone — creates the tag if it doesn't exist, then assigns it (does not remove existing tags; re-adding is a no-op).

assign_conversation

ChatGPT
Assign (route) a conversation to one of your team members, by phone + agent name or id. Agents are your own team (see list_agents).

close_conversation

ChatGPT
Close the customer's currently open conversation (session), by phone. Use after a request is resolved to mark the conversation done for human handoff / organization.

create_campaign

ChatGPT
Create a campaign from an approved template. It is created as a DRAFT and is NOT sent until send_campaign is called. Returns the new campaign id. Requires a plan with bulk-campaigns enabled.

create_or_update_contact

ChatGPT
Upsert a contact by phone number: if a contact with the same phone already exists for the client it is updated, otherwise a new one is created. Returns the contact id and whether it was newly created. Use to sync store customers / prevent duplicates.

get_campaign_performance

ChatGPT
Get campaign (promotion) performance statistics for a given month — optionally limited to one template.

get_campaign_stats

ChatGPT
Get a campaign's details and delivery stats (sent/failed recipients) by id.

get_contact

ChatGPT
Fetch a single contact (name, phone, email, tags) by id for the authenticated SocialLab client.

get_conversation

ChatGPT
Get a customer's conversation sessions by phone — each session's status (open/closed), assignment, and the 24-hour messaging-window expiry. Use to check whether a free-form reply is still allowed before calling send_message.

get_media

ChatGPT
Read the content of a file a customer sent (image/PDF/etc.) by message id. Images are returned viewable; other files as base64. Use after list_messages shows a message has an attachment.

get_message_by_id

ChatGPT
Fetch a single message (with its reply, if any) by message id for the authenticated SocialLab client. Use to check the status/content of a previously sent message.

get_reports

ChatGPT
Get the client's dashboard report — message volumes and delivery/response metrics. Optionally scope to a year/month, or request a daily breakdown.

get_salla_cart

ChatGPT
Fetch a Salla cart by its cart id for the authenticated SocialLab client. Returns cart details (items, customer, totals). Use when the user asks about a specific Salla cart or abandoned cart.

get_template

ChatGPT
Fetch one WhatsApp template by id (from list_templates) with its full details — Meta name, status, language, body text and the variables it expects. Use to inspect a template's required parameters before sending.

list_agents

ChatGPT
List your team members (agents) — id + name — so you can assign a conversation to one.

list_campaigns

ChatGPT
List the client's campaigns (promotions) with status and counts.

list_contacts

ChatGPT
List the SocialLab client's contacts, optionally filtered by name, phone, or tag. Paginated — use pageNumber/pageSize to page through results. Use to look a customer up by phone before sending or to load context.

list_conversations

ChatGPT
List all conversations across every channel (WhatsApp, Instagram, Messenger, TikTok, Snapchat, Telegram, Twitter, SMS, Email, …) with status and last message. Paginated — use page/pageSize to page through results. Filter by channel, status (active/closed_manual/closed_auto), or free-text search over customer name, phone or tags. The search does NOT look inside message text — to find a conversation by something that was said, read the messages with list_messages. Each conversation includes canSendFreeform — true when the 24h window is open (use send_message), false when you must use send_whatsapp_template. Use to triage the inbox or find a conversation before reading messages or replying.

list_customer_tags

ChatGPT
List the client's allowed customer tags (the tag catalog). set_customer_tags only accepts tags from this list — call this first to get the exact tag texts.

list_interactive

ChatGPT
List the client's saved interactive messages (button / list templates). Each item's id is what you pass to send_interactive. Call this first to find the interactive you want to send.

list_messages

ChatGPT
List the messages exchanged with a customer (by phone), paginated. The response also includes the customer's current session — its status and the 24-hour messaging-window expiry. Each message includes a sender object with name and role (customer / agent / ai / partner / promotion / system). The response includes canSendFreeform — true when the 24h window is open (use send_message), false when you must use send_whatsapp_template. Use to read history/context before replying.

list_products

ChatGPT
List or search the client's product catalog (paginated). Each item includes id, title, description, price and currency. Use to look up a product (and its price/id) for store integration or to reference in a reply.

list_templates

ChatGPT
List the SocialLab client's WhatsApp templates. CALL THIS FIRST before sending: each item's name is the Meta name to pass to send_whatsapp_template (templateMetaName), status shows if it is APPROVED, and bodyText shows the {{1}}, {{2}}… variable placeholders the template expects. headerType is a NUMBER — 0 none, 1 text, 2 document, 3 image, 4 video — and 2, 3 or 4 means the template carries an attachment, so send_whatsapp_template will accept a headerMediaUrl for it. Optionally filter by search text, status, or tags.

remove_customer_tag

ChatGPT
Remove a tag from a customer by phone (unassigns it — does not delete the tag from your catalog; removing a tag the customer doesn't have is a no-op).

search_messages

ChatGPT
Search for a word or phrase inside what was actually said, across every conversation — or inside one when phone is given. Most-recent first, paginated. This is the tool for questions like "who mentioned a late delivery this month"; list_conversations's own search covers names, phones and tags only and never looks at message text. The match is a SUBSTRING, so a short term matches far more than expected — "ai" is inside "email" and "said". For "which customers said X", pass direction: "Received" — that is the customer's own words, and without it the results are dominated by outbound campaigns and the assistant's own replies on the same threads. source narrows by how a message was made rather than who sent it. Narrow with from/to rather than paging: the total can run to tens of thousands, and reading one page of those is not an answer about the period. Results are the same as the Messages screen's own message search, so the answer here and the answer on screen agree.

send_campaign

ChatGPT
⚠️ SENDS a campaign to its ENTIRE audience — a mass WhatsApp send that is IRREVERSIBLE once delivered. Only call after the user has explicitly confirmed the specific campaign id should be sent now. Provide the campaign id from create_campaign / list_campaigns.

send_interactive

ChatGPT
Send a saved interactive message (buttons/list, by id from list_interactive) to a customer by phone. Like send_message, this only works within the open 24-hour session window.

send_media

ChatGPT
Send an image, document, video or audio to a customer by phone. Provide either a public HTTPS mediaUrl (the server fetches it, max 16MB) or a base64-encoded file (no public URL needed — PDF/JPEG/PNG only, max 5MB decoded). Exactly one of mediaUrl/file is required. Only works within the open 24-hour session window.

send_message

ChatGPT
Send a free-form text reply to a customer (by phone). Only works within the open 24-hour session window (i.e. the customer has messaged recently); outside that window WhatsApp requires an approved template — use send_whatsapp_template instead. Returns the sent message(s).

send_whatsapp_template

ChatGPT
Send a pre-approved WhatsApp template message to a recipient on behalf of the authenticated SocialLab client. Only templates already approved in SocialLab can be sent. A template whose header carries an attachment sends the file saved on it unless you pass headerMediaUrl, which attaches a file chosen for this one message instead — the way each customer receives their own invoice. Call list_templates first: its headerType tells you whether a template takes a file at all.

set_customer_tags

ChatGPT
Set (overwrite) a customer's tags by phone, for segmentation/classification. tags is the full SEMICOLON-separated list and each tag must already exist in the client's tag catalog (call list_customer_tags first). To add/remove a single tag, read the current tags then set the updated full list.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/sociallab"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/sociallab)