Meta Social Technologies MCP Server
This MCP server lets you manage and automate Facebook Pages, Instagram Professional accounts, and Threads through publishing, messaging, engagement, analytics, and funnel tools.
Retrieve Facebook Page, Instagram, and Threads profiles, posts, media, comments, conversations, and insights.
Publish Facebook text/photo posts and Instagram photo/reel content.
Send Instagram DMs with text, links, images, files, audio, reusable attachments, quoted replies, reactions, sender actions, quick replies, button templates, and carousel templates.
Manage Instagram comments by replying, liking, sending private replies, checking follower status, and running keyword-based follow-gated comment funnels.
Configure Instagram chat tools such as ice breakers, persistent menus, and ig.me DM links.
Upload reusable attachments for faster Instagram DM delivery.
Use HUMAN_AGENT tagged messaging for extended Instagram response windows.
Publish and reply to Threads posts, fetch recent threads, and retrieve Threads profile/insight data.
Provides tools for Facebook Pages, including profile retrieval, publishing text and photo posts, fetching recent posts, reading and replying to comments, and liking comments.
Provides tools for Instagram Business/Creator accounts, including publishing photos and Reels, sending DMs with text, images, PDFs, and audio voice notes, message reactions, quoted replies, interactive templates, follower-gated comment funnels, chat moderation, and account/media insights.
Provides tools for the Threads API, including profile retrieval, publishing text/photo/video posts, fetching recent posts, replying to thread conversations, and retrieving insights.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Meta Social Technologies MCP Server Publish a photo to Instagram with the caption 'Launch day!'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Meta Social Technologies MCP Server & Automation Suite v4.0
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)
🔍 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).
📢 Publishing & Media Production:
publish_instagram_carousel: Publish multi-image/video carousel albums (2 to 20 items) with optionalis_ai_generatedlabel.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.
💬 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: Showtyping_onindicator ormark_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 withHUMAN_AGENTtag.upload_reusable_attachment: Upload media once to obtain reusable attachment ID.
🛡️ 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.
🧵 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.
🛠️ 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_id2. 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 toolscheck_user_follows_accountA
Check whether an Instagram user follows @in.yogeshwar (Follower Verification).
Inputs: user_id (required).
generate_ig_me_linkA
Generate an ig.me short link (https://ig.me/m/in.yogeshwar?ref=...) that opens Instagram DMs directly with a tracking/referral payload.
Inputs: ref_payload.
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.
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
Scored across 35 tools
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).
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.
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.
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
Related MCP Connectors
Social media API for AI agents: publish, DMs, comments, Meta ads and leads.
Instagram for AI agents: publish, comments, DM by keyword, inbox, insights. Facebook Pages soon.
Instagram for AI agents: publish, read comments and DMs, insights, and engage from your account.
Manage Instagram and Facebook automations, conversations, templates, and analytics with AI.
Related MCP Servers
- FlicenseBqualityNot gradedmaintenanceEnables AI assistants to interact with Instagram and Facebook accounts through their APIs, supporting messaging, post management, commenting, and content creation.14-
- AlicenseAqualityCmaintenanceEnables AI assistants to manage Instagram and Threads accounts — publish content, handle comments, view insights, search hashtags, and manage DMs through the Meta Graph API.5938 npm14MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to automate Facebook Page management including posting, commenting, and analytics via the Facebook Graph API.MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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 npmMIT