TikTok Analytics
Track your TikTok performance — video views, likes, comments, shares, and account-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 TikTok account via OAuth
- 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 (views, engagement) |
boring_get_video_analytics |
Real-time platform API | Per-video metrics (views, likes, comments, shares) |
boring_get_posts_performance |
Daily snapshots (collected at 2 AM) | Historical video 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 tiktok platform.
Step 2: Determine What the User Wants
| User Request | Tool to Use |
|---|---|
| "How is my TikTok doing?" | boring_get_performance |
| "Show my best TikToks" | boring_get_video_analytics |
| "TikTok performance this month" | boring_get_posts_performance |
| "What did I post on TikTok?" | boring_get_publish_history |
Step 3: Fetch Data
Account-Level Performance
boring_get_performance(
account_id="<account_id>",
platform="tiktok",
period="week" // "day", "week", or "month"
)
Per-Video Analytics (Real-Time)
boring_get_video_analytics(
account_id="<account_id>",
platform="tiktok",
limit=20 // max 100
)
Historical Video 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 key metrics in a summary table
- Video analytics: Rank videos by views or engagement, highlight viral hits
- Historical: Show trends over time
TikTok Metrics
| Metric | Description |
|---|---|
| Video views | Total views per video |
| Likes | Video likes |
| Comments | Video comments |
| Shares | Video shares |
| Account performance | Aggregated account-level metrics |
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