meta-mcp

# meta-mcp

> Full-coverage MCP server for Instagram Graph API (v26.0), Threads API, and Meta platform management. Publish content, manage comments, view insights, and handle DMs — all through AI assistants.

## Package

- npm: `@mikusnuz/meta-mcp`
- Run: `npx @mikusnuz/meta-mcp`
- GitHub: https://github.com/mikusnuz/meta-mcp

## Environment Variables

- `INSTAGRAM_ACCESS_TOKEN` (for Instagram) — Instagram Graph API access token
- `INSTAGRAM_USER_ID` (for Instagram) — Instagram Business/Creator account ID
- `INSTAGRAM_MESSAGING_ACCESS_TOKEN` (for Instagram DMs with Facebook Login) — linked Page access token
- `INSTAGRAM_PAGE_ID` (for Instagram DMs with Facebook Login) — linked Facebook Page ID
- `THREADS_ACCESS_TOKEN` (for Threads) — Threads API access token
- `THREADS_USER_ID` (for Threads) — Threads user ID
- `META_APP_ID` (for token/webhook tools) — Meta App ID
- `META_APP_SECRET` (for token/webhook tools) — Meta App Secret

Only set variables for the platforms you use.

## MCP Config

```json
{
  "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_token",
        "INSTAGRAM_PAGE_ID": "your_linked_page_id",
        "THREADS_ACCESS_TOKEN": "your_threads_token",
        "THREADS_USER_ID": "your_threads_user_id"
      }
    }
  }
}
```

## Account Requirements

- Instagram: Business or Creator account (free to switch in settings)
- Threads: Any account
- Meta token/webhook tools: Meta Developer App

## Tools (66)

### Meta Platform (6)
- meta_exchange_token — Exchange short-lived token for long-lived (~60 days)
- meta_refresh_token — Extend an Instagram/Facebook token or refresh a Threads token (select with `platform`)
- meta_debug_token — Inspect token validity, expiration, and scopes
- meta_get_app_info — Get Meta App information
- meta_subscribe_webhook — Subscribe to webhook notifications
- meta_get_webhook_subscriptions — List current webhook subscriptions

### Instagram — Publishing (6)
- ig_publish_photo — Publish a photo post (supports alt_text)
- ig_publish_video — Publish a video post
- ig_publish_carousel — Publish a carousel/album (2-10 items, alt_text per item)
- ig_publish_reel — Publish a Reel (supports alt_text)
- ig_publish_story — Publish a Story (24hr)
- ig_get_container_status — Check media container processing status

### Instagram — Media (5)
- ig_get_media_list — List published media
- ig_get_media — Get media details
- ig_delete_media — Delete a media post
- ig_get_media_insights — Get media analytics (views, reach, saved, shares)
- ig_toggle_comments — Enable/disable comments on a post

### Instagram — Comments (7)
- ig_get_comments — Get comments on a post
- ig_get_comment — Get comment details
- ig_post_comment — Post a comment
- ig_get_replies — Get replies to a comment
- ig_reply_to_comment — Reply to a comment
- ig_hide_comment — Hide/unhide a comment
- ig_delete_comment — Delete a comment

### Instagram — Profile & Insights (5)
- ig_get_profile — Get account profile info
- ig_get_account_insights — Get account-level analytics (views, reach, follower_count)
- ig_business_discovery — Look up another business account
- ig_get_collaboration_invites — Get pending collaboration invites
- ig_respond_collaboration_invite — Accept or decline collaboration invites

### Instagram — Hashtags (4)
- ig_search_hashtag — Search hashtag by name
- ig_get_hashtag — Get hashtag info
- ig_get_hashtag_recent — Get recent media for a hashtag
- ig_get_hashtag_top — Get top media for a hashtag

### Instagram — Mentions & Tags (2)
- ig_get_mentioned_comments — Get comments mentioning you
- ig_get_tagged_media — Get media you're tagged in

### Instagram — Messaging (4)
- ig_get_conversations — List DM conversations
- ig_get_messages — Get messages in a conversation
- ig_send_message — Send a DM
- ig_get_message — Get message details

### Threads — Publishing (7)
- threads_publish_text — Publish text post (polls, GIFs, link attachments, topic tags, quote, spoiler, ghost posts, reply approvals, location, IG Stories cross-share)
- threads_publish_image — Publish image post (alt_text, topic tags, spoiler, reply approvals, location, IG Stories cross-share)
- threads_publish_video — Publish video post (alt_text, topic tags, spoiler, reply approvals, location, IG Stories cross-share)
- threads_publish_carousel — Publish carousel (2-20 items, alt_text per item, reply approvals, location, IG Stories cross-share)
- threads_delete_post — Delete a post (max 100/day)
- threads_get_container_status — Check container processing status
- threads_get_publishing_limit — Check remaining quota (250 posts/day)

### Threads — Media & Search (4)
- threads_get_posts — List published posts
- threads_get_post — Get post details
- threads_get_profile_posts — List a public profile's posts by username (Profile Discovery)
- threads_search_posts — Search public posts via /keyword_search by keyword or topic tag

### Threads — Replies (7)
- threads_get_replies — Get top-level replies to a post
- threads_get_conversation — Get all replies to a post, flattened
- threads_reply — Reply to a post (supports image/video attachments)
- threads_hide_reply — Hide a reply
- threads_unhide_reply — Unhide a reply
- threads_get_pending_replies — Get replies awaiting approval
- threads_manage_pending_reply — Approve or ignore a pending reply

### Threads — Profile & Discovery (3)
- threads_get_profile — Get Threads profile info
- threads_get_user_threads — List user's threads
- threads_lookup_profile — Look up a public profile by username (Profile Discovery)

### Threads — Mentions (1)
- threads_get_mentions — Get posts where the user was @mentioned

### Threads — Locations (2)
- threads_search_locations — Search for locations to tag, by query or coordinates
- threads_get_location — Get a location object by ID

### Threads — Tools & Resources (1)
- threads_get_oembed — Get embed HTML/metadata for a public post

### Threads — Insights (2)
- threads_get_post_insights — Post analytics (views, likes, replies, reposts, quotes, clicks)
- threads_get_user_insights — Account-level analytics

## Resources
- instagram://profile — Instagram account profile data
- threads://profile — Threads account profile data

## Prompts
- content_publish — Cross-post content to Instagram and Threads
- analytics_report — Generate combined analytics report