Instagram Complete MCP Server

Stop manually posting to Instagram. Schedule content, analyze performance, and manage your entire Instagram presence from your AI assistant.

Connect Claude (or any MCP-compatible AI) directly to your Instagram account and automate everything from publishing Reels to tracking hashtag performance.

Tools

Tool	Category	Description
publish_photo	Publishing	Post a photo to your Instagram feed with caption and user tags
publish_video	Publishing	Publish a video to your feed
publish_carousel	Publishing	Upload a 2-10 item carousel album
publish_story	Publishing	Post a photo or video to Instagram Stories
publish_reel	Publishing	Publish a short-form Reel (max 90 seconds)
get_profile	Profile	Get your account info, bio, and follower count
update_bio	Profile	Update your Instagram bio (max 150 chars)
get_followers	Profile	List your followers with pagination
get_following	Profile	List accounts you follow
get_media_insights	Analytics	Get impressions, reach, engagement for a specific post
get_profile_insights	Analytics	Account-level analytics over a date range
get_audience_demographics	Analytics	Age, gender, country, city breakdowns of your audience
search_hashtags	Discovery	Find hashtag IDs by name
get_hashtag_media	Discovery	Browse top or recent posts for a hashtag
get_trending_hashtags	Discovery	Compare reach across multiple hashtags at once
list_media	Media	List all your posts with pagination
get_media	Media	Get full details for a specific post
delete_media	Media	Delete a post permanently
get_media_comments	Media	Fetch comments on a post
schedule_post	Scheduling	Schedule a photo or video to publish at a future time

Quick Start

1. Get Your Instagram Credentials

You'll need a Business or Creator Instagram account connected to a Facebook Page.

1. Go to developers.facebook.com
2. Create an app and add the Instagram Graph API product
3. Generate a long-lived access token with these permissions:
   • instagram_basic
   • instagram_content_publish
   • instagram_manage_insights
   • instagram_manage_comments
4. Find your Instagram User ID via the API or a tool like Graph API Explorer

2. Configure Environment Variables

INSTAGRAM_ACCESS_TOKEN=your_access_token_here
INSTAGRAM_USER_ID=your_instagram_user_id_here

3. Run the Server

npm install
npm start

The server starts on port 8080 (or PORT env var).

Health check: GET http://localhost:8080/health

MCP endpoint: POST http://localhost:8080/mcp

Example Usage

"Publish this photo to my Instagram feed with the caption 'Morning in Bali #bali #travel'"
"Get my last 20 posts and show me which ones had the most engagement"
"Schedule a post for next Monday at 9am Bali time"
"What are my top hashtags performing this month?"

API Reference

This server wraps the official Instagram Graph API:

• Base URL: https://graph.facebook.com/v18.0
• Docs: developers.facebook.com/docs/instagram-api

Built with MCPize

Deploy and manage MCP servers at mcpize.com.

---

Built by Mastermindshq.business — AI systems for serious operators.