Threads Analytics#

Track your Threads performance — views, likes, replies, reposts, quotes, and follower growth. 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. Sign up at boring.aiagent-me.com with Google
2. Connect Threads account via OAuth
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#

ToolData SourceBest Forboring_get_performanceReal-time platform APIAccount-level overview (views, followers)boring_get_video_analyticsReal-time platform APIPer-post metrics (views, likes, replies, reposts)boring_get_posts_performanceDaily snapshots (collected at 2 AM)Historical post performance over date rangesboring_get_publish_historyBoring databasePublishing history and status tracking

Workflow#

Step 1: List Accounts#

Call boring_list_accounts and filter for threads platform.

Step 2: Determine What the User Wants#

User RequestTool to Use"How are my Threads doing?"boring_get_performance"Show my best Threads posts"boring_get_video_analytics"Threads performance this month"boring_get_posts_performance"What did I post on Threads?"boring_get_publish_history

Step 3: Fetch Data#

Account-Level Performance

text

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

Per-Post Analytics (Real-Time)

text

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

Historical Post Performance (Snapshots)

text

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 views, followers in a summary table
• Post analytics: Rank posts by engagement (likes + replies + reposts)
• Historical: Show trends over time

Threads Metrics#

MetricDescriptionviewsPost viewslikesPost likesrepliesPost repliesrepostsPost repostsquotesPost quotesfollowers_countAccount followers

Error Handling#

ErrorSolutionInvalidApiKeyMCP link may be invalid — regenerate it at boring.aiagent-me.com SettingsInvalidAccountIdRun boring_list_accounts to get valid IDsTokenExpiredReconnect account at boring.aiagent-me.comNo data returnedAccount may be newly connected — data collection runs daily at 2 AM

Documentation#

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