Meta

English | 한국어

meta-mcp

Full-coverage MCP server for Instagram Graph API (v26.0), Threads API, and Meta platform management.

When to Use

Tell your AI assistant things like:

• "Post a photo to Instagram" — publish photos, videos, reels, stories, and carousels
• "Publish a text post on Threads" — text posts with polls, GIFs, link attachments, and topic tags
• "Get my Instagram follower count and insights" — account and post-level analytics
• "Schedule a carousel post" — multi-image albums on Instagram (2-10) or Threads (2-20)
• "Reply to comments on my latest post" — read and respond to comments on both platforms
• "Cross-post to Instagram and Threads" — use the built-in content_publish prompt
• "Get analytics for my Threads account" — views, likes, replies, reposts, quotes, clicks
• "Manage Instagram DMs" — list conversations, read messages, send replies

AI Agent Integration: See llms.txt for a machine-readable summary, or copy templates/CLAUDE.md / templates/AGENTS.md into your project for automatic MCP discovery.

Features

• 66 tools across Instagram (33), Threads (27), and Meta platform (6)
• Instagram: Publish photos/videos/reels/stories/carousels with alt text, manage comments, view insights, search hashtags, handle DMs, manage collaboration invites
• Threads: Publish text/images/videos/carousels with polls, GIFs, topic tags, link attachments, alt text, spoiler flags, ghost posts, reply approvals, location tags, and Instagram Stories cross-sharing; manage replies and pending reply approvals; search posts and locations; profile/mentions discovery; oEmbed; view insights; delete posts
• Meta: Token exchange/refresh/debug, webhook management
• 2 resources: Instagram profile, Threads profile
• 2 prompts: Cross-platform content publishing, analytics report
• Rate limit tracking via x-app-usage header

What's New in v2.2.1

• Photos, image Stories, and every carousel child and parent now wait for container processing before publication. Processing errors stop the publish request.
• Mentioned comments use the Instagram user field expansion with documented default fields.

What's New in v2.2.0

• Fixed Instagram business discovery and collaboration invite requests. Use media_id and accept for invites; invite_id and action remain supported aliases.
• Account insights support metric_type, breakdown, and demographic timeframe. Metrics such as views select total_value automatically.
• Standalone videos now publish as Reels shared to the feed. Photo, Reel, and carousel publishing support AI info and paid-partnership labels; Reels also support trial_params.
• Public Threads oEmbed works without a token. Includes the token refresh, Instagram Messaging, publishing, and reply handling fixes since v2.1.1.

What's New in v2.1.0

• Graph API v26.0: Upgraded from v25.0 (no deprecated fields/endpoints from the v26.0 changelog were in use)
• Tenor removed: GIPHY is now the only GIF provider (Tenor was sunset March 31, 2026); gif_provider param dropped
• Threads Ghost Posts: is_ghost_post on threads_publish_text (auto-archived after 24h)
• Threads Reply Approvals: enable_reply_approvals on publish tools, plus threads_get_pending_replies and threads_manage_pending_reply
• Threads → Instagram Stories cross-share: crossreshare_to_ig / crossreshare_to_ig_dark_mode on all publish tools
• Threads Location Tagging: location_id on publish tools, plus threads_search_locations and threads_get_location
• Threads Profile Discovery: threads_lookup_profile and threads_get_profile_posts for public profiles
• Threads Mentions: threads_get_mentions
• Threads oEmbed: threads_get_oembed for embedding public posts
• Threads Conversations: threads_get_conversation for flattened (nested) reply threads
• Fixed `threads_search_posts`: now calls the correct /keyword_search endpoint with the correct search_mode/search_type parameters (previous version targeted a non-existent endpoint)
• Post/reply fields expanded with is_verified, profile_picture_url, location_id, root_post, replied_to, reply_audience

What's New in v2.0.0

• Graph API v25.0: Upgraded from v21.0 (expired Sep 2025) to v25.0 (current)
• Fixed deprecated metrics: impressions, video_views, engagement replaced with views, reach, saved, shares
• Threads polls: Create posts with interactive poll attachments
• Threads GIFs: Attach GIFs from GIPHY or Tenor
• Threads topic tags: Categorize posts with topic tags
• Threads link attachments: Attach URL preview cards to text posts
• Threads post search: Search public posts by keyword or topic tag
• Threads post deletion: Delete posts (rate limited to 100/day)
• Threads publishing limit: Check remaining quota
• Threads quote posts: Quote other posts by ID
• Threads spoiler flag: Mark content as spoiler
• Threads alt text: Add accessibility descriptions to all media types
• Threads new reply controls: parent_post_author_only and followers_only options
• Instagram alt text: Support for photo, reel, and carousel items
• Instagram collaboration invites: Query and respond to collab invites
• Updated insights metrics: New clicks, reposts, reels_skip_rate metrics

Account Requirements

Installation

Requires Node.js 20 or later, including the MCP host's npx environment.

npx (Recommended)

{

"mcpServers": { "meta": { "command": "npx", "args": ["-y", "@mikusnuz/meta-mcp"], "env": { "INSTAGRAM_ACCESS_TOKEN": "your_ig_token", "INSTAGRAM_USER_ID": "your_ig_user_id", "INSTAGRAM_MESSAGING_ACCESS_TOKEN": "your_page_access_token", "INSTAGRAM_PAGE_ID": "your_linked_page_id", "THREADS_ACCESS_TOKEN": "your_threads_token", "THREADS_USER_ID": "your_threads_user_id" } } } }

Manual

git clone https://github.com/mikusnuz/meta-mcp.git

cd meta-mcp npm install npm run build

{

"mcpServers": { "meta": { "command": "node", "args": ["/path/to/meta-mcp/dist/index.js"], "env": { "INSTAGRAM_ACCESS_TOKEN": "your_ig_token", "INSTAGRAM_USER_ID": "your_ig_user_id", "INSTAGRAM_MESSAGING_ACCESS_TOKEN": "your_page_access_token", "INSTAGRAM_PAGE_ID": "your_linked_page_id", "THREADS_ACCESS_TOKEN": "your_threads_token", "THREADS_USER_ID": "your_threads_user_id" } } } }

Environment Variables

You only need to set the variables for the platforms you use. For example, if you only use Threads, just set THREADS_ACCESS_TOKEN and THREADS_USER_ID.

Tools

Meta Platform (6)

Instagram — Publishing (6)

Instagram — Media (5)

Instagram — Comments (7)

Instagram — Profile & Insights (5)

Instagram — Hashtags (4)

Instagram — Mentions & Tags (2)

Instagram — Messaging (4)

Threads — Publishing (7)

| threads_publish_carousel | Publish a carousel (2-20 items, alt_text per item, reply approvals, location tag