Facebook Analytics

Track your Facebook Page performance — reach, engagement, video views, and post-level metrics. 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 Facebook — requires admin access to a Facebook Page
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 Tools

Tool	Data Source	Best For
INLINECODE1	Real-time platform API	Page-level overview (reach, engagement, video views)
INLINECODE2

Real-time platform API | Per-post 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 facebook platform. Show the user their connected Pages.

Step 2: Determine What the User Wants

User Request	Tool to Use
"How is my Facebook doing?"	INLINECODE7
"Show my best Facebook posts"

boring_get_video_analytics | | "Facebook performance over the last month" | boring_get_posts_performance | | "What did I post on Facebook?" | boring_get_publish_history |

Step 3: Fetch Data

Page-Level Performance

CODEBLOCK0

Per-Post Analytics (Real-Time)

CODEBLOCK1

Historical Post Performance (Snapshots)

CODEBLOCK2

Step 4: Present Results

Format the data clearly:

• - Page overview: Show key metrics in a summary table
• Post analytics: Rank posts by engagement, highlight top performers
• Historical: Show trends over time

Facebook Metrics

Metric	Description
INLINECODE11	Total video views
INLINECODE12

Likes, comments, shares | | page_total_actions | Total page actions |

Error Handling

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

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