# instagram-mcp

Connect Instagram to your workflows. Access account and media data, and streamline content tasks from one place.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add maxbeech/instagram-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list maxbeech/instagram-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get maxbeech/instagram-mcp get_profile_info

# Call a tool
npx -y @smithery/cli@latest tool call maxbeech/instagram-mcp get_profile_info '{}'
```

## Direct MCP Connection

Endpoint: `https://instagram-mcp--maxbeech.run.tools`

## Tools (10)

- `get_profile_info` — Get Instagram business profile information including followers, bio, and account details
- `get_media_posts` — Get recent media posts from Instagram account with engagement metrics and pagination support
- `get_media_insights` — Get detailed analytics and performance metrics for a specific Instagram post
- `publish_media` — Upload and publish an image or video to Instagram with caption, location, and automatic aspect ratio validation
- `get_account_insights` — Get account-level analytics including reach, profile views, and website clicks over a time period
- `validate_access_token` — Validate your Instagram access token and check permissions
- `get_account_pages` — Get Facebook pages connected to your account (needed for some Instagram operations)
- `get_conversations` — Get Instagram DM conversations (requires instagram_manage_messages permission and Advanced Access)
- `get_conversation_messages` — Get messages from a specific Instagram DM conversation (requires Advanced Access)
- `send_dm` — Send a direct message on Instagram (requires Advanced Access and 24-hour response window)

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get maxbeech/instagram-mcp <tool-name>
```

## Resources

- `instagram://profile` — Your Instagram business profile information
- `instagram://media/recent` — Your 10 most recent Instagram posts with metrics
- `instagram://insights/account` — Account-level analytics and performance metrics
- `instagram://pages` — Facebook pages connected to your account

## Prompts (3)

- `analyze_engagement` (media_id) — Analyze engagement metrics for a specific Instagram post and provide insights
- `content_strategy` (focus_area, time_period) — Generate a content strategy based on your Instagram performance data
- `hashtag_analysis` (post_count) — Analyze hashtag performance across your recent posts