Boring Social Analytics

Track performance and engagement across all your social media platforms. Powered by Boring.

Security & Data Handling

• - MCP link is a credential: Your MCP Server URL contains an embedded authentication token. Treat it like a password — do not share it publicly. Regenerate anytime in Settings.
• Data flow: Analytics queries are sent from Boring's server to social media platform APIs (Facebook, Instagram, Threads, YouTube, TikTok) on your behalf. Only performance metrics are retrieved — no content is uploaded.
• No local credentials: No local API keys or environment variables needed. All auth is embedded in the MCP link.

Prerequisites

1. 1. Sign up at boring.aiagent-me.com with Google
2. Connect accounts — supports Facebook, Instagram, Threads, YouTube, TikTok
3. Get your MCP link: Go to Settings → copy your MCP Server URL (contains your auth token — treat it like a password)
4. Add to Claude: Paste the MCP link as a Connector — no install, no API key needed

Available Analytics Tools

Tool	Data Source	Best For
INLINECODE0	Real-time platform API	Account-level overview (reach, engagement, followers)
INLINECODE1

Real-time platform API | Per-post/video 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 to see all connected platforms. Show a summary to the user.

Step 2: Determine What the User Wants

User Request	Tool to Use
"How is my account doing?"	INLINECODE5
"Show my best posts"

boring_get_video_analytics | | "Performance over the last month" | boring_get_posts_performance | | "What did I post recently?" | boring_get_publish_history | | "Compare platforms" | boring_get_performance for each platform |

Step 3: Fetch Data

Account-Level Performance

CODEBLOCK0

Returns metrics like reach, follower count, engagement rate, profile views.

Per-Post Analytics (Real-Time)

CODEBLOCK1

Returns per-post data: views, likes, comments, shares for up to 100 recent posts.

Historical Post Performance (Snapshots)

CODEBLOCK2

Returns post-level engagement, metrics, and content from daily collected snapshots.

Publishing History

CODEBLOCK3

Returns recent publishing activity with status and post IDs.

Step 4: Present Results

Format the data clearly for the user:

For account overview: Show key metrics in a summary table
For post analytics: Rank posts by engagement, highlight top performers
For cross-platform comparison: Side-by-side metrics across platforms
For historical data: Show trends over time

Metrics by Platform

Facebook

• - page_media_view: Total video views
• INLINECODE11: Likes, comments, shares
• INLINECODE12: Total page actions

Instagram

• - reach: Accounts reached
• INLINECODE14: Total followers
• INLINECODE15: Profile visits
• INLINECODE16: Likes + comments + saves + shares
• Reels: ig_reels_avg_watch_time, INLINECODE18

Threads

• - views: Post views
• INLINECODE20, replies, reposts, INLINECODE23
• INLINECODE24: Account followers

YouTube

• - views, likes, comments, INLINECODE28
• INLINECODE29: Total watch time
• INLINECODE30: Average view duration
• INLINECODE31 / INLINECODE32

TikTok

• - Video views, likes, comments, shares
• Account-level performance metrics

Cross-Platform Comparison

When the user asks to compare platforms, fetch boring_get_performance for each connected account and present a unified table:

CODEBLOCK4

Error Handling

Error	Solution
INLINECODE34	MCP link may be invalid — regenerate it at boring.aiagent-me.com Settings
INLINECODE35

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