# Messenger MCP

> The Messenger MCP connects your AI client directly to your Facebook Page, giving you full control over conversations without ever touching the Meta dashboard. Audit message history, manage brand personas, and send direct replies instantly from your workflow.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** instant-messaging, customer-engagement, social-platform, chat-automation, conversation-management, persona-management

## Description

Managing a high-volume Facebook Page used to mean navigating complex dashboards just to check if someone needed help or what messages were being sent out. This MCP changes that. It lets your agent act as a real-time communications assistant right inside your existing workflow. You can list all active conversations and pull up detailed message histories with timestamps—all without logging into Meta. Need to respond? Your agent sends direct text replies instantly, keeping your response rate high. Furthermore, you don't just manage chats; you keep brand consistency by listing and retrieving persona details and ensuring the correct media assets are available for responses. When you connect this MCP through Vinkius, your AI client handles all that messy operational work, turning enterprise messaging into a natural conversation.

## Tools

### get_messages
Pulls the full message history for a single conversation thread.

### get_page_info
Retrieves basic information about your connected Facebook Page.

### get_page_settings
Gets specific operational settings for the Facebook Page itself.

### get_persona_info
Fetches detailed information about a specific brand persona or bot identity.

### list_conversations
Lists all recent, active conversations currently happening on the Page.

### list_message_creative
Retrieves a list of media assets and creatives available for automated messaging.

### list_personas
Lists every registered brand persona associated with the Page account.

### send_message
Sends a direct text message reply to any user or recipient.

## Prompt Examples

**Prompt:** 
```
List all active Messenger conversations for my Page.
```

**Response:** 
```
I've retrieved your conversations. You have 5 recent threads, including interactions with 'John Doe' and 'Jane Smith'. Which conversation ID would you like to audit for history?
```

**Prompt:** 
```
Send 'Thank you for contacting us!' to recipient ID 12345678.
```

**Response:** 
```
Message sent! I've successfully delivered your reply to recipient 12345678. The response is now visible in the Messenger thread.
```

**Prompt:** 
```
Show me the message history for conversation t_xxxx.
```

**Response:** 
```
I've retrieved the history for t_xxxx. There are 10 messages in this thread. The latest was 'Hello, I have a question about my order' from the user. Would you like the full log?
```

## Capabilities

### Audit Conversation Threads
List active conversations and retrieve detailed message history for any specific thread.

### Automate Customer Replies
Send direct text replies to users instantly, ensuring rapid response times.

### Manage Brand Identity
List and pull information on brand personas and message creatives to maintain consistent messaging.

## Use Cases

### Handling a sudden PR crisis
A social media manager needs to track public sentiment immediately. They ask their agent to run list_conversations, quickly identifying all threads mentioning 'outage' or 'delay'. The agent then uses get_messages on the top five threads to pull full context for human review.

### Onboarding a new team member
A training manager needs to verify which brand voice is active. They ask their agent to execute list_personas and then use get_persona_info on the correct profile, ensuring all staff know the required messaging guidelines.

### Responding after a campaign launch
A marketing lead needs to send out follow-up materials. They check list_message_creative to confirm the latest image is available, and then use send_message to push the updated content directly into all relevant threads.

### Reviewing old customer complaints
An operations manager needs context on a ticket from six months ago. They tell their agent to get_messages for that specific conversation ID, instantly retrieving the full log so they can update the internal record accurately.

## Benefits

- Stop switching between dashboards. Use list_conversations to get a summary of all active threads in one go, allowing you to triage issues immediately without manual navigation.
- Maintain high customer satisfaction by using send_message to deliver direct replies the moment an inquiry comes in, keeping conversations flowing even outside business hours.
- Keep your brand voice consistent. By listing and retrieving persona data via get_persona_info, you ensure every automated reply matches your established identity.
- Deeply understand user issues. The get_messages tool pulls full conversation histories for auditing, letting agents answer complex questions by reviewing the entire thread context.
- Control your page's structure. You can use get_page_settings and get_page_info to verify that necessary operational settings are maintained correctly.

## How It Works

The bottom line is, you tell your agent what needs doing—auditing chats, updating personas, or replying—and it does it using the data and functions of your Facebook Page.

1. Subscribe to this MCP, providing your Facebook Page Access Token and Page ID.
2. Connect the credentials to your preferred AI client (like Claude or Cursor).
3. Ask your agent to perform tasks like listing conversations or sending a reply; it executes the action via the connected tools.

## Frequently Asked Questions

**How do I audit old chat history using Messenger MCP?**
You can retrieve detailed message history for any specific conversation ID by calling the get_messages tool. This pulls a full log so you know exactly what was said and when.

**Does Messenger MCP help me update brand personas?**
It helps you manage and verify them, not update their core definition. You can use list_personas to see all available profiles, and get_persona_info to check the current details.

**Can I send replies using Messenger MCP from my IDE?**
Yes, your agent uses the send_message tool to deliver direct text replies. This keeps your response rapid and conversational, even when you're working inside VS Code or Cursor.

**What if I need to check page operational settings? Use Messenger MCP.**
You can use get_page_settings to monitor the Page's core configuration. This is useful for operations managers who need to ensure compliance and proper setup.

**Is list_conversations limited to only recent chats?**
It lists active conversations, giving you a clear snapshot of current activity without needing to dig through massive archives manually.