Skip to main content
Glama
pauloFroes

mcp-meta-inbox

by pauloFroes

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
META_PAGE_IDYesNumeric Page ID
META_IG_USER_IDNoInstagram Business account ID. Auto-discovered from the Page when omitted
META_PAGE_ACCESS_TOKENYesPage token issued to a person who administers the Page

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
check_accessA

Diagnose the configured token: its type, whether it never expires, which messaging scopes it carries, and which of the four capabilities (Messenger inbox, Instagram Direct, Facebook comments, Instagram comments) actually answer right now. Run this first when any other tool fails — it separates a wrong token type from a missing Advanced Access grant.

list_conversationsA

List inbox threads for the Page, newest activity first. Returns thread ID, participants, message count, unread count and a snippet of the last message. Use the returned thread ID with get_conversation or list_messages. Instagram Direct additionally requires Advanced Access to instagram_manage_messages (App Review). Without it Meta answers with a ~27s timeout, subcode 2534084. Instagram comments are NOT affected.

get_conversationA

Read one thread in full: participants plus the most recent messages with sender, body text, attachments and timestamps. This is the tool to call before replying to someone, so the reply has context.

list_messagesA

List messages inside a thread without the surrounding conversation metadata. Use get_conversation instead when you also want the participant list.

get_messageA

Read a single message by ID, including attachments and shared media. Useful when a thread listing shows an attachment you need the URL for.

send_messageA

Send a direct message from the Page to a person, on Messenger or Instagram Direct. This publishes to a real person's inbox — confirm the recipient and the text with a human before calling it. Meta only allows a free-form reply within 24 hours of that person's last message; outside that window the call fails and a message tag or paid channel is required. Instagram Direct additionally requires Advanced Access to instagram_manage_messages (App Review). Without it Meta answers with a ~27s timeout, subcode 2534084. Instagram comments are NOT affected.

send_sender_actionA

Mark a conversation as seen, or show/hide the typing indicator. Cosmetic and safe: it posts no content. Useful before a slow reply so the person sees the Page is responding.

list_postsA

List published posts on the Facebook Page, or media on the linked Instagram account. Returns each post's ID, caption/message, timestamp and engagement counts. Use the returned ID with list_comments to moderate its comment thread.

list_commentsA

List comments on a post (Facebook) or media (Instagram), including each author's ID — which doubles as the DM recipient ID for send_message or private_reply. Instagram results nest their replies; Facebook top-level comments carry a comment_count you can drill into by passing the comment ID back in as object_id. Passing a comment ID works on Instagram too — the tool falls back to the /replies edge and reports which edge answered. Works on both platforms with a plain Page token.

get_commentA

Read a single comment by ID, with its author, timestamp and moderation flags (can_hide / can_remove on Facebook, hidden on Instagram). Call this before hiding or deleting so the decision is made on the real text.

create_commentA

Post a new top-level comment on your own Facebook post. This publishes publicly under the Page's name — confirm the text with a human first. Instagram does not allow creating top-level comments via the API; use reply_to_comment there.

reply_to_commentA

Reply publicly to a comment, as the Page. Facebook and Instagram use different endpoints for this and the tool routes automatically. This publishes publicly — confirm the text with a human first. To answer someone privately instead, use private_reply.

update_commentA

Edit the text of a comment the Page authored. FACEBOOK ONLY — the Instagram Graph API has no edit operation for comments, so an Instagram reply can only be deleted and re-posted. This tool rejects Instagram IDs rather than failing opaquely.

hide_commentA

Hide or unhide someone else's comment. A hidden comment stays visible to its author and their friends but disappears for everyone else — the reversible alternative to delete_comment for spam or abuse.

delete_commentA

Permanently delete a comment. IRREVERSIBLE — the comment cannot be restored. Confirm with a human before calling. Prefer hide_comment when the intent is moderation rather than removal.

private_replyA

Answer a public comment with a private direct message to its author. Meta allows exactly one private reply per comment, and only within 7 days of the comment. This is the supported way to move a public question into the inbox. It messages a real person — confirm with a human first. Instagram private replies need the same Advanced Access as Instagram Direct.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pauloFroes/mcp-meta-inbox'

If you have feedback or need assistance with the MCP directory API, please join our Discord server