Instagram Analytics

Track your Instagram performance — reach, followers, interactions, Reels metrics, and post-level engagement. Powered by Boring.

Security & Data Handling

MCP link is a credential: Your MCP Server URL (https://boring.aiagent-me.com/mcp/t/xxxxx...) contains an embedded authentication token. Treat it like a password — do not share it publicly.
Token scope: The embedded token is read-only for analytics. It can only fetch performance metrics and account metadata. It cannot publish, delete, or modify any content on your social media accounts.
Token storage: The token is stored server-side in Boring's database (MongoDB on DigitalOcean). It is never written to your local filesystem. You can regenerate or revoke it anytime at boring.aiagent-me.com/settings.
Data flow: Analytics queries are sent from Boring's server (Google Cloud, us-central1) to the platform's API on your behalf. Only performance metrics are retrieved — no content is uploaded or modified.
No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
Third-party service: This skill relies on Boring, an open-source social media management tool. Source code: github.com/snoopyrain.

Prerequisites

Sign up at boring.aiagent-me.com with Google
Connect Instagram — requires an Instagram Business or Creator account
Get your MCP link: Go to Settings → copy your MCP Server URL (contains your auth token — treat it like a password)
Add to Claude: Paste the MCP link as a Connector — no install, no API key needed

Available Tools

| Tool | Data Source | Best For | |------|-----------|----------| | boring_get_performance | Real-time platform API | Account-level overview (reach, followers, interactions) | | boring_get_video_analytics | Real-time platform API | Per-post/Reel metrics (views, likes, comments, shares) | | boring_get_posts_performance | Daily snapshots (collected at 2 AM) | Historical post performance over date ranges | | boring_get_publish_history | Boring database | Publishing history and status tracking |

Workflow

Step 1: List Accounts

Call boring_list_accounts and filter for instagram platform.

Step 2: Determine What the User Wants

| User Request | Tool to Use | |-------------|------------| | "How is my Instagram doing?" | boring_get_performance | | "Show my best Reels" | boring_get_video_analytics | | "Instagram performance this month" | boring_get_posts_performance | | "What did I post on IG?" | boring_get_publish_history |

Step 3: Fetch Data

Account-Level Performance

boring_get_performance(
  account_id="<account_id>",
  platform="instagram",
  period="week"       // "day", "week", or "month"
)

Per-Post Analytics (Real-Time)

boring_get_video_analytics(
  account_id="<account_id>",
  platform="instagram",
  limit=20             // max 100
)

Historical Post Performance (Snapshots)

boring_get_posts_performance(
  account_id="<account_id>",
  since="2025-12-01",
  until="2025-12-31",
  limit=20
)

Step 4: Present Results

Format the data clearly:

Account overview: Show reach, followers, profile views in a summary table
Post analytics: Rank posts by engagement, highlight top Reels
Historical: Show trends over time, compare Reels vs Photos vs Carousels

Instagram Metrics

| Metric | Description | |--------|-------------| | reach | Accounts reached | | follower_count | Total followers | | profile_views | Profile visits | | total_interactions | Likes + comments + saves + shares | | ig_reels_avg_watch_time | Average Reels watch time | | ig_reels_video_view_total_time | Total Reels view time |

Error Handling

| Error | Solution | |-------|----------| | InvalidApiKey | MCP link may be invalid — regenerate it at boring.aiagent-me.com Settings | | InvalidAccountId | Run boring_list_accounts to get valid IDs | | TokenExpired | Reconnect account at boring.aiagent-me.com | | No data returned | Account may be newly connected — data collection runs daily at 2 AM |

Documentation

Full API docs: boring-doc.aiagent-me.com