# mikusnuz/meta-mcp [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/mikusnuz/meta-mcp  
**GitHub Stars:** 36  
**npm Downloads (last month):** 1974  
**Views:** 11  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mikusnuz-meta-mcp

## Description
Full-coverage MCP server for Instagram Graph API v25.0, Threads API & Meta platform — 57 tools for publishing, comments, insights, hashtags, DMs, and token management.

## Tools
Capabilities this server exposes over MCP:

- **meta_exchange_token** — Exchange a short-lived token for a long-lived token (valid ~60 days). Requires META_APP_ID and META_APP_SECRET.
- **meta_refresh_token** — Extend an Instagram/Facebook user token through the token-exchange flow, or refresh a Threads long-lived token through the Threads refresh endpoint.
- **meta_debug_token** — Debug/inspect an access token to check validity, expiration, scopes and associated user.
- **meta_get_app_info** — Get Meta App basic information (name, category, namespace, etc.).
- **meta_subscribe_webhook** — Subscribe to webhook notifications for an object (e.g., 'instagram', 'page'). Requires META_APP_ID and META_APP_SECRET.
- **meta_get_webhook_subscriptions** — List current webhook subscriptions for the Meta App.
- **ig_publish_photo** — Publish a photo to Instagram. Two-step process: creates container then publishes. Requires image_url (publicly accessible HTTPS URL).
- **ig_publish_video** — Publish a standalone video as a Reel and share it to the feed. Waits for video processing before publishing.
- **ig_publish_carousel** — Publish a carousel (album) post with 2-10 images/videos. Each item needs an image_url or video_url.
- **ig_publish_reel** — Publish a Reel (short video). Waits for video processing.
- **ig_publish_story** — Publish a Story (image or video). Stories disappear after 24 hours.
- **ig_get_container_status** — Check the processing status of a media container (useful for videos).
- **ig_get_media_list** — Get list of media published on the Instagram account.
- **ig_get_media** — Get details of a specific Instagram media post.
- **ig_delete_media** — Delete an Instagram media post (posts, carousels, reels, stories). This action is irreversible. Requires instagram_manage_contents permission.
- **ig_get_media_insights** — Get insights/analytics for a specific media post. Note: 'impressions' and 'video_views' were deprecated in v22.0 — use 'views' instead. Available metrics: views, reach, saved, shares, likes, comments, reposts, reels_skip_rate.
- **ig_toggle_comments** — Enable or disable comments on an Instagram media post.
- **ig_get_comments** — Get comments on a specific Instagram media post.
- **ig_get_comment** — Get details of a specific comment.
- **ig_post_comment** — Post a top-level comment on a media post.
- **ig_get_replies** — Get replies to a specific comment.
- **ig_reply_to_comment** — Reply to a specific comment.
- **ig_hide_comment** — Hide or unhide a comment on your post.
- **ig_delete_comment** — Delete a comment from your media post. This action is irreversible.
- **ig_get_profile** — Get Instagram Business/Creator account profile information.
- **ig_get_account_insights** — Get Instagram account insights. Note: 'impressions', 'email_contacts', 'phone_call_clicks', 'text_message_clicks', 'get_directions_clicks', 'website_clicks', 'profile_views' were deprecated in v22.0. Use 'views', 'reach', 'follower_count', 'reposts' instead.
- **ig_business_discovery** — Look up another Instagram Business/Creator account's public info by username.
- **ig_get_collaboration_invites** — Get pending collaboration invites for the Instagram account. Added in December 2025.
- **ig_respond_collaboration_invite** — Accept or decline a collaboration invite. Added in December 2025.
- **ig_search_hashtag** — Search for a hashtag ID by name. Required before querying hashtag media. Limited to 30 unique hashtags per 7-day rolling window.
- **ig_get_hashtag** — Get hashtag information by ID.
- **ig_get_hashtag_recent** — Get recent media tagged with a specific hashtag.
- **ig_get_hashtag_top** — Get top (most popular) media tagged with a specific hashtag.
- **ig_get_mentioned_comments** — Get comments where the account was @mentioned. Returns the media and comment details.
- **ig_get_tagged_media** — Get media where the account is tagged (photo tags, not @mentions).
- **ig_get_conversations** — Get Instagram DM conversations using Instagram Messaging with Facebook Login. Requires a Page access token, the linked Facebook Page ID, instagram_manage_messages, and pages_manage_metadata.
- **ig_get_messages** — Get messages in a specific DM conversation.
- **ig_send_message** — Send an Instagram DM using Instagram Messaging with Facebook Login. Requires a Page access token, instagram_manage_messages, and pages_manage_metadata. The recipient must have messaged the professional account first.
- **ig_get_message** — Get details of a specific DM message.
- **threads_publish_text** — Publish a text-only post on Threads. Supports optional link attachment, poll, GIF, topic tag, and quote post.
- **threads_publish_image** — Publish an image post on Threads. Supports topic tag, quote post, alt text, and spoiler flag.
- **threads_publish_video** — Publish a video post on Threads. Waits for video processing. Supports topic tag, quote post, alt text, and spoiler flag.
- **threads_publish_carousel** — Publish a carousel post on Threads with 2-20 images/videos.
- **threads_delete_post** — Delete a Threads post. This action is irreversible. Rate limited to 100 deletions per 24 hours.
- **threads_get_container_status** — Check the processing status of a Threads media container.
- **threads_get_publishing_limit** — Check how many posts you can still publish within the current 24-hour window (max 250 posts/day).
- **threads_get_posts** — Get a list of published Threads posts.
- **threads_get_post** — Get details of a specific Threads post.
- **threads_get_profile_posts** — Get a public profile's posts by username (Profile Discovery). Requires threads_profile_discovery permission; with standard access, only @meta, @threads, @instagram, and @facebook are queryable.
- **threads_search_posts** — Search for public Threads posts by keyword or topic tag via the /keyword_search endpoint. Results can be filtered by media type and author.
- **threads_get_replies** — Get replies (conversation) for a specific Threads post.
- **threads_get_conversation** — Get a flattened list of all replies (top-level and nested) to a Threads post, in chronological or reverse-chronological order.
- **threads_reply** — Reply to a Threads post or another reply.
- **threads_hide_reply** — Hide a reply on your Threads post. Hidden replies are still visible if directly accessed.
- **threads_unhide_reply** — Unhide a previously hidden reply on your Threads post.
- **threads_get_pending_replies** — Get pending/ignored replies awaiting approval on a post that has reply approvals enabled (enable_reply_approvals).
- **threads_manage_pending_reply** — Approve or ignore a pending reply on a post with reply approvals enabled. Ignored replies can still be approved later.
- **threads_get_profile** — Get Threads user profile information including verification status.
- **threads_lookup_profile** — Look up a public Threads user's profile by username (Profile Discovery). Requires threads_profile_discovery permission and target must have >=100 followers; with standard access, only @meta, @threads, @instagram, and @facebook are queryable.
- **threads_get_user_threads** — Get all threads published by the user (alias for threads_get_posts with user context).
- **threads_get_post_insights** — Get insights/analytics for a specific Threads post (views, likes, replies, reposts, quotes, clicks).
- **threads_get_user_insights** — Get account-level Threads insights (views, likes, replies, reposts, quotes, clicks, followers, follower demographics).
- **threads_get_mentions** — Get public Threads posts where the authenticated user has been @mentioned by another profile. Requires threads_manage_mentions permission (without advanced access, only mentions by app testers are returned).
- **threads_search_locations** — Search for locations to tag in a Threads post, by query text or by coordinates. Provide q, or latitude+longitude, or both.
- **threads_get_location** — Get a Threads location object by ID (from threads_search_locations or a post's location_id field).
- **threads_get_oembed** — Get the embed HTML and metadata for a public Threads post, for rendering a rich preview on an external site. No access token required.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "meta-mcp": {
    "command": "npx",
    "args": ["-y","@mikusnuz/meta-mcp"],
    "env": {
      "INSTAGRAM_ACCESS_TOKEN": "",
      "INSTAGRAM_USER_ID": "",
      "INSTAGRAM_MESSAGING_ACCESS_TOKEN": "",
      "INSTAGRAM_PAGE_ID": "",
      "THREADS_ACCESS_TOKEN": "",
      "THREADS_USER_ID": "",
      "META_APP_ID": "",
      "META_APP_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `INSTAGRAM_ACCESS_TOKEN`, `INSTAGRAM_USER_ID`, `INSTAGRAM_MESSAGING_ACCESS_TOKEN`, `INSTAGRAM_PAGE_ID`, `THREADS_ACCESS_TOKEN`, `THREADS_USER_ID`, `META_APP_ID`, `META_APP_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What mikusnuz/meta-mcp MCP server does

mikusnuz/meta-mcp MCP server connects MCP-compatible agents to the Instagram Graph API, Threads API, and selected Meta platform management endpoints. Its Instagram coverage includes publishing photos, videos, Reels, Stories, and carousels; reading and moderating comments; retrieving account and media insights; looking up public business or creator profiles; and searching hashtags.

For Threads, the repository documents text and media publishing, carousels, polls, GIFs, topic tags, link attachments, alt text, spoiler flags, ghost posts, reply controls, location tags, and cross-sharing to Instagram Stories. It also describes Threads reply management, public-post search, profile discovery, mentions, oEmbed, conversations, post deletion, and analytics. Meta platform tools handle token exchange, token refresh, token inspection, app information, and webhook subscriptions.

## How it works

The package runs as a Node.js MCP process and sends API requests using credentials supplied through environment variables. Publishing Instagram media uses the platform’s container workflow; video-based operations wait for processing before publication. Carousel publishing accepts between two and ten media items.

Requests that use Instagram require a Business or Creator account rather than a personal account. Threads access is available to any Threads account according to the repository requirements. Meta token and webhook operations require a Meta Developer App.

## Setup and configuration

mikusnuz/meta-mcp MCP server requires Node.js 20 or later. The recommended setup runs `npx -y @mikusnuz/meta-mcp` from the MCP client configuration. Alternatively, clone the repository, run `npm install`, build it with `npm run build`, and start `dist/index.js` with Node.

Set only the variables needed for the APIs you plan to use:

- `INSTAGRAM_ACCESS_TOKEN` and `INSTAGRAM_USER_ID` for Instagram operations.
- `INSTAGRAM_MESSAGING_ACCESS_TOKEN` and `INSTAGRAM_PAGE_ID` for Instagram DMs.
- `THREADS_ACCESS_TOKEN` and `THREADS_USER_ID` for Threads operations.
- `META_APP_ID` and `META_APP_SECRET` for token and webhook tools.

The Instagram publishing tools require publicly accessible HTTPS media URLs where specified. Token exchange and webhook subscription operations require the Meta app credentials.

## Tools and capabilities

The documented capability areas include:

- Publish Instagram photos, videos, Reels, Stories, and carousels.
- Retrieve media, profiles, comments, replies, account insights, and media insights.
- Post, reply to, hide, unhide, or delete Instagram comments; deletion is irreversible.
- Search Instagram hashtags and manage collaboration invites.
- Publish and analyze Threads content, including polls, GIFs, links, topics, quotes, and media.
- Inspect, refresh, and exchange tokens, and manage Meta webhook subscriptions.

## Limitations and notes

Instagram API access is restricted by account type and required permissions. Hashtag search is limited to 30 unique hashtags in a rolling seven-day period. Deleting media or comments cannot be undone. Long-lived token exchange produces a token valid for approximately 60 days, so applications should plan for refresh and inspection flows.

_Full upstream README: https://allmcps.com/mcp/mikusnuz-meta-mcp/readme_

