MCP Tools Reference

SuperSocial gives your AI assistant a set of MCP tools that let it read, write, and manage messages across LinkedIn, WhatsApp, Instagram, Telegram, and email — all from a single connection. This page is a complete reference of every tool available through the SuperSocial API, organized by category.

You don't need to memorize these. Your AI already knows which tools to call and when. But understanding what's available helps you ask for exactly what you need — and know what's possible.

Context and Setup

get_user_context

This is the first tool your AI typically calls. It returns a complete snapshot of your account: which messaging platforms are connected, your inbox status, recent contacts, subscription details, and any preferences you've configured. Think of it as the AI "looking at its dashboard" before doing anything else.

You'll rarely need to ask for this directly — your AI calls it automatically at the start of a conversation to understand what it's working with.

Messaging Tools

These are the core AI messaging tools that handle conversations across all your connected platforms. Whether it's a WhatsApp chat, a LinkedIn thread, or an Instagram DM, the same tools work everywhere.

list_chats

Lists recent conversations from your inbox. You can filter by account, search by name or keyword, show only unread threads, or limit results to a specific date range. This is what your AI uses when you say things like "show me my unread LinkedIn messages" or "what conversations have I had this week."

Supports pagination with cursors for large inboxes, and you can optionally include recent messages from each conversation inline — useful when the AI needs to scan multiple threads quickly.

search_contacts

Searches for people across all your conversations. Give it a name, company, or keyword and it finds matching contacts. You can scope the search to a specific account or search everywhere at once. Helpful when you want to message someone but aren't sure which platform you last talked to them on.

get_conversation

Retrieves the full message history from one or more chats. You can fetch a single conversation by its ID, or batch up to 25 conversations in one call — handy when the AI needs to review multiple threads to answer a question or prepare a summary.

You control how many messages to load per conversation, so the AI can grab just the last few exchanges or pull a deeper history when needed.

send_message

The most versatile tool in the set. send_message handles sending messages to any connected platform. You can target a recipient by phone number, username, or existing chat ID. It supports text messages, file attachments, and even quoting a previous message for context.

Beyond immediate sending, this tool also supports two important modes:

• Scheduling — set a future date and time, and the message will be sent automatically. Perfect for "remind them next Tuesday" workflows.
• Draft mode — the AI prepares the message but doesn't send it. You review and approve it first through the SuperSocial dashboard. Ideal when you want AI-assisted writing with human oversight.

react_to_message

Adds emoji reactions to messages. Works on both WhatsApp and LinkedIn. Supports single reactions or batch reactions across multiple messages. Useful for quickly acknowledging messages — "react with a thumbs up to all of those" — without writing a full reply.

get_message_attachment

Downloads an attachment from a chat message — images, documents, voice notes, or any file someone has shared with you. The tool returns the file content so your AI can read, analyze, or reference it in conversation.

Email Tools

SuperSocial supports Gmail and Outlook through a dedicated set of email tools. These work alongside the messaging tools, so your AI can handle email and chat in the same conversation.

search_emails

Searches your email by keyword, sender, recipient, folder, or date range. Works like a smart email search — ask for "emails from Sarah about the proposal" and the AI uses this tool to find exactly what you need. You can also use it to simply list recent emails from a particular folder.

read_email

Opens and reads a specific email. Two reading modes are available: clean mode strips out signatures, forwarding headers, and reply chains to give you just the meaningful content; full mode returns everything as-is. Clean mode is the default and works best for most use cases.

get_email_attachment

Downloads an email attachment and returns it as base64-encoded data. Use this when you need the AI to read a PDF someone emailed you, analyze a spreadsheet, or reference an attached document.

list_email_folders

Returns all available email folders — inbox, sent, drafts, spam, and any custom folders or labels you've created. The AI uses this to know where to look when searching for specific types of emails.

Scheduling and Drafts

These tools give you control over messages that haven't been sent yet — whether they're scheduled for the future or waiting for your approval.

list_scheduled

Lists all scheduled messages with their planned send times. You can filter by status — pending, sent, or failed — to see what's queued up and what has already gone out. Useful for reviewing your upcoming message queue: "what messages do I have scheduled for this week?"

cancel_scheduled

Cancels one or more pending scheduled messages before they're sent. If you change your mind about a follow-up or realize the timing isn't right, just tell your AI to cancel it.

get_drafts

Retrieves draft messages that the AI created in draft mode, waiting for your review. Each draft shows the intended recipient, message content, and the platform it will be sent on. You can then approve, edit, or discard drafts through the SuperSocial dashboard.

LinkedIn Tools

get_linkedin_profile

Looks up a LinkedIn profile by username and returns structured data: headline, current position, work experience, education, skills, and more. This is valuable for research before outreach — "look up this person on LinkedIn and tell me about their background" — or for enriching contact information.

Note that this tool is subject to a daily rate limit to comply with platform policies. Your AI is aware of the limit and will let you know if it has been reached.

Settings and Feedback

submit_feedback

Sends feedback, bug reports, or feature requests directly to the SuperSocial team. If something isn't working the way you expect, or you have an idea for a new feature, just tell your AI — it will use this tool to pass your message along with relevant context.

How Tools Work Together

The real power of SuperSocial's MCP tools isn't any single tool — it's how your AI combines them. A typical workflow might look like this:

1. The AI calls get_user_context to understand your setup
2. It uses list_chats to find unread WhatsApp messages
3. It calls get_conversation to read the full thread
4. It uses get_linkedin_profile to research the person you're talking to
5. It drafts a reply using send_message in draft mode for your approval

All of this happens in a single conversation. You ask a question, and the AI orchestrates the right tools in the right order. No switching between apps, no copy-pasting between platforms.

Your AI assistant handles the tool calls automatically. Just describe what you need in plain language — "reply to that WhatsApp message," "schedule a follow-up for Friday," "summarize my unread emails" — and the right tools fire behind the scenes.