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 (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

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
INLINECODE1	Real-time platform API	Account-level overview (reach, engagement, followers)
INLINECODE2

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?"	INLINECODE6
"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
• INLINECODE12: Likes, comments, shares
• INLINECODE13: Total page actions

Instagram

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

Threads

• - views: Post views
• INLINECODE21, replies, reposts, INLINECODE24
• INLINECODE25: Account followers

YouTube

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

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
INLINECODE35	MCP link may be invalid — regenerate it at boring.aiagent-me.com Settings
INLINECODE36

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