Skip to main content
Glama
Meta Social Technologies MCP Server

Meta Social Technologies MCP Server

by inyogeshwar

Meta Social Technologies MCP Server & Automation Suite v4.0

Node.js MCP Meta Graph API License: MIT Author

An enterprise-grade Model Context Protocol (MCP) server and AI automation suite for Facebook Pages, Instagram Business/Creator accounts, and Threads. Build ManyChat & Superprofile-style comment funnels, send audio voice notes (.m4a), trigger double-tap reactions (❤️), execute threaded quoted replies, publish carousels, discover competitor accounts, track hashtags, and troubleshoot errors using official Meta specifications.


👨‍💻 Author & Attribution

  • Developer: Yogeshwar Kumar

  • GitHub: @inyogeshwar

  • Target Platforms: Facebook Pages, Instagram Professional Accounts, and Threads Profiles

  • Official Docs Mirror: Complete offline archive of 70 official Meta Markdown guides located in docs/meta-api-reference/


Related MCP server: meta-mcp

⚡ Core Capabilities (45 Enterprise Tools)

  1. 🔍 Business Discovery & Intelligence:

    • discover_business_profile: Search any public creator/brand to inspect followers, bio, media count, website, and top posts.

    • search_instagram_hashtag: Lookup static hashtag IDs from Meta's database.

    • get_hashtag_top_media & get_hashtag_recent_media: Fetch top-performing or recent reels/posts for any hashtag.

    • get_content_publishing_limit: Check rolling 24-hour rate limit quota usage (50 posts limit).

  2. 📢 Publishing & Media Production:

    • publish_instagram_carousel: Publish multi-image/video carousel albums (2 to 20 items) with optional is_ai_generated label.

    • publish_instagram_reel: Upload and publish MP4 video reels.

    • publish_instagram_photo: Post images with captions and hashtags.

    • publish_facebook_post & publish_facebook_photo: Post status and photos to Facebook Pages.

    • get_instagram_stories: Read active 24-hour stories.

    • get_media_children: Inspect individual items in carousel albums.

  3. 💬 Direct Messaging & Rich Media:

    • send_instagram_dm: Deliver text, links, images, PDFs, and audio voice notes.

    • react_to_message: Send double-tap heart (❤️), flame (🔥), or thumbs-up reactions.

    • send_sender_action: Show typing_on indicator or mark_seen.

    • send_quick_replies: Send interactive pill buttons.

    • send_button_template & send_generic_template: Send card buttons and horizontal carousels.

    • send_human_agent_message: 7-day extended messaging window with HUMAN_AGENT tag.

    • upload_reusable_attachment: Upload media once to obtain reusable attachment ID.

  4. 🛡️ Comment Moderation & Funnels:

    • moderate_comment: Hide, unhide, or delete comments on any post or reel.

    • reply_to_comment & like_comment: Publicly reply and auto-like comments.

    • send_instagram_private_reply: Privately DM a commenter.

    • run_instagram_comment_growth_funnel: End-to-end ManyChat/Superprofile-style Follow-to-Unlock automation.

  5. 🧵 Threads API Studio:

    • get_threads_profile: Fetch profile info, bio, and picture.

    • publish_threads_post: Publish 500-char text, images, or video threads.

    • get_threads_posts: Inspect recent published threads.

    • reply_to_threads_post: Automated reply to thread discussions.

    • get_threads_insights: Real-time views, likes, replies, and repost analytics.

  6. 🛠️ Troubleshooting & Error Resolver:

    • get_error_code_info: Official Meta explanation, cause, and exact fix for codes (100, 190, 2207004, 2207042, etc.).


🚀 Quick Setup

1. Configuration (.env or MCP Config)

FB_PAGE_ACCESS_TOKEN=your_facebook_page_access_token
FB_PAGE_ID=your_facebook_page_id
INSTAGRAM_ID=your_instagram_professional_account_id
INSTAGRAM_USERNAME=your_instagram_handle
THREADS_ACCESS_TOKEN=your_threads_access_token
THREADS_USER_ID=your_threads_user_id

2. Antigravity / Claude Desktop MCP Configuration

Add to your mcp_config.json:

{
  "mcpServers": {
    "meta_social_technologies": {
      "command": "node",
      "args": ["D:\\meta-social-technologies-mcp\\server.js"],
      "env": {
        "FB_PAGE_ACCESS_TOKEN": "YOUR_FB_PAGE_ACCESS_TOKEN",
        "FB_PAGE_ID": "YOUR_FB_PAGE_ID",
        "INSTAGRAM_ID": "YOUR_INSTAGRAM_ID",
        "INSTAGRAM_USERNAME": "your_instagram_handle",
        "THREADS_ACCESS_TOKEN": "YOUR_THREADS_ACCESS_TOKEN",
        "THREADS_USER_ID": "YOUR_THREADS_USER_ID"
      }
    }
  }
}

📚 Official Meta Documentation Archive

The docs/meta-api-reference/ directory contains an offline archive of all 70 official Meta Markdown guides:


🔒 Security & Privacy Notice

This repository contains zero hardcoded credentials, tokens, or private IDs. All secrets are loaded dynamically via environment variables or encrypted databases.

Licensed under the MIT License. Built by Yogeshwar Kumar.

Available Tools

35 tools
check_user_follows_accountA

Check whether an Instagram user follows @in.yogeshwar (Follower Verification).

Inputs: user_id (required).

get_conversation_messagesB

Fetch messages within a specific conversation thread on Instagram.

Inputs: conversation_id (required), limit.

get_conversationsB

Fetch active Instagram direct message conversations/threads, participant IDs, and unread counts.

Inputs: limit.

get_facebook_postsB

Fetch recent posts published on the Facebook Page In.yogeshwar.

Inputs: limit.

get_instagram_account_insightsA

Fetch account-level metrics (reach, content interactions, accounts engaged) for @in.yogeshwar.

Inputs: period.

get_instagram_mediaB

Fetch recent media (posts/reels) published on Instagram account in.yogeshwar.

Inputs: limit.

get_instagram_media_insightsA

Fetch post/reel metrics (reach, saved count, total interactions) for a specific Instagram post.

Inputs: media_id (required).

get_instagram_profileB

Get profile info, followers count, bio, and media count for Instagram account in.yogeshwar.

Inputs: no named parameters.

get_media_commentsB

Fetch comments for an Instagram post or reel with commenter details and like counts.

Inputs: media_id (required), limit.

get_page_profileB

Get profile details, followers, and information for Facebook Page In.yogeshwar.

Inputs: no named parameters.

get_threads_insightsA

Fetch insights (views, likes, replies, reposts, quotes) for a specific thread or the Threads profile.

Inputs: thread_id.

get_threads_postsC

Fetch recent published threads and posts for @in.yogeshwar.

Inputs: limit.

get_threads_profileB

Fetch profile details, username, bio, and picture for Threads account @in.yogeshwar (ID: 2072594220036802).

Inputs: user_id.

get_user_profileB

Fetch profile details for an Instagram user by IGSID (username, name, profile pic, follow status).

Inputs: user_id (required).

like_commentB

Like an Instagram comment on behalf of @in.yogeshwar.

Inputs: comment_id (required).

manage_ice_breakersB

View, set, or delete Instagram Ice Breakers (frequently asked questions shown to new chatters).

Inputs: action (required), ice_breakers.

manage_persistent_menuB

View, set, or delete the Instagram Persistent Menu (navigation menu in the chat composer).

Inputs: action (required), call_to_actions.

publish_facebook_photoC

Publish a photo with caption to Facebook Page In.yogeshwar.

Inputs: photo_url (required), caption.

publish_facebook_postB

Publish a status update or text message to Facebook Page In.yogeshwar.

Inputs: message (required), link.

publish_instagram_photoC

Publish a photo post with caption and hashtags to Instagram account in.yogeshwar.

Inputs: image_url (required), caption.

publish_instagram_reelC

Publish a video reel with caption to Instagram account in.yogeshwar.

Inputs: video_url (required), caption.

publish_threads_postB

Publish a post (text, image, or video) to Threads account @in.yogeshwar using the official Threads API.

Inputs: text (required), image_url, video_url, media_type.

react_to_messageB

React to a specific Instagram Direct Message with an emoji (e.g. double-tap heart "❤️", "👍", "🔥", etc.) or unreact.

Inputs: message_id (required), recipient_id (required), action, reaction.

reply_to_commentA

Post a public reply to a specific comment on an Instagram post or reel.

Inputs: message (required), comment_id (required).

reply_to_threads_postB

Publish a reply to a specific post/thread on Threads.

Inputs: text (required), thread_id (required).

run_instagram_comment_growth_funnelB

ManyChat/Superprofile style automated funnel: scans comments for keywords (e.g. "guide"), likes the comment, replies publicly, and DMs the guide/link with a "User Must Follow" gate.

Inputs: keyword (required), unlocked_content_text (required), media_id, attachment_id, +6 more.

send_button_templateC

Send a Button Template message (text with up to 3 action buttons: URL links or postback triggers).

Inputs: text (required), buttons (required), recipient_id (required).

send_generic_templateC

Send a Generic Template carousel card (image, title, subtitle, and action buttons) to Instagram chat.

Inputs: elements (required), recipient_id (required).

send_human_agent_messageA

Send a message using the HUMAN_AGENT escalation tag (allows human agents to reply up to 7 days outside the 24-hr window).

Inputs: message_text (required), recipient_id (required).

send_instagram_dmA

Send a Direct Message (text, image, audio/voice, or PDF/file) to an Instagram user by their IGSID. Supports quoting/replying to an exact message (threaded reply). For audio, supported formats are AAC, M4A, WAV, or MP4 up to 25MB.

Inputs: recipient_id (required), message_text, attachment_id, attachment_url, +2 more.

send_instagram_private_replyB

Send a private Direct Message (DM) to an Instagram user in response to their comment.

Inputs: comment_id (required), message_text (required).

send_quick_repliesC

Send a message with interactive Quick Reply buttons that users can tap in Instagram DMs.

Inputs: message_text (required), recipient_id (required), quick_replies (required).

send_sender_actionB

Trigger sender actions in Instagram chat: typing indicator ("typing_on", "typing_off") or mark as seen ("mark_seen").

Inputs: action (required), recipient_id (required).

upload_reusable_attachmentA

Upload an attachment to Meta servers using Attachment Upload API to get a reusable attachment_id for fast zero-reupload DM delivery.

Inputs: url (required), attachment_type (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 35 tools

    Disambiguation3/5

    Platform prefixes (facebook/instagram/threads) help separate otherwise parallel tools, but the DM-sending cluster (send_instagram_dm, send_instagram_private_reply, send_human_agent_message, send_quick_replies, send_button_template, send_generic_template) overlaps heavily and requires careful description reading to pick correctly. Similarly get_instagram_profile vs get_user_profile vs get_threads_profile have fuzzy boundaries (own account vs IGSID lookup).

    Naming Consistency4/5

    Overwhelmingly consistent verb_noun snake_case (publish_*, get_*, send_*, reply_to_*, like_*), with platform qualifiers applied predictably. Minor deviations: manage_ice_breakers/manage_persistent_menu bundle view/set/delete under a non-verb prefix, and the scoping of get_threads_insights vs get_instagram_account_insights vs get_instagram_media_insights is uneven.

    Tool Count3/5

    35 tools is heavy; while the domain (FB Page + Instagram + Threads + DM automation) is broad, the count is inflated by six near-parallel DM-send tools and could be consolidated. It sits at the top edge of justified rather than being well-scoped.

    Completeness3/5

    Strong publishing, media listing, comment handling, insights, and DM/chat-configuration coverage for Instagram, but there are notable gaps: no delete/edit operations for published posts or media, and Facebook/Threads surfaces are read-and-publish only (no comment management, DMs, or insights for Facebook).

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to manage Instagram and Threads accounts — publish content, handle comments, view insights, search hashtags, and manage DMs through the Meta Graph API.
      59
      38 npm
      14
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables reading and replying to direct messages, comments, and templates across Instagram, WhatsApp, and Messenger through official Meta Business APIs, with support for human handover and AI assistant controls.
      53 npm
      MIT