my_dashboard
Your full dashboard history for any dates: medians per platform, a time series, followers, ads per campaign.
- Returns
- Per platform and all together: posts, totals, medians, a series, top posts, ads.
- Does
- Reads
- Who
- Free on every account
- Limits
- Free on every account: 500 tool calls a day (1,500 on the paid plan), shared by all tools.
Try it on your account
Give it to your agent
Prompt for
No key in it: your agent reads it from SOCIALSCOUT_KEY or asks you.
Read the prompt
Set up SocialScout for me and use it: Belgian social-media data (viral brand videos, Flemish creators, Meta ads and what they say, the Belgian marketing calendar, my own numbers and my content calendar), as an MCP server.
## 1. Connect
You are Claude Code. Add SocialScout as an MCP server for my user (not in this project's .mcp.json, so the key never lands in git):
claude mcp add --transport http --scope user socialscout https://socialscout.be/api/mcp --header "Authorization: Bearer $SOCIALSCOUT_KEY"
First check that SOCIALSCOUT_KEY is set (echo ${SOCIALSCOUT_KEY:+set}); the shell fills it in when the command runs.
Then tell me to run /mcp (or restart Claude Code) so the socialscout tools load.
My key: use the environment variable SOCIALSCOUT_KEY. If it is not set, ask me for my key (I find it at https://socialscout.be/me/crew, under "SocialScout inside your AI": the part after ?key=). Treat it as a password: never print it back, never put it in a file that goes into git.
What the key may do: it reads everything my plan includes and may make drafts in my calendar (scopes read + drafts). It cannot schedule, publish or touch ads: schedule_post, reschedule_post, unschedule_post and delete_post answer "needs_confirmation" with a review_url. Give me that link; nothing happens until I confirm there.
Check the connection: call corpus_stats (works without a key), then list_accounts (needs the key), and tell me in one line what you see.
## The tool: my_dashboard
Your full dashboard history for any dates: medians per platform, a time series, followers, ads per campaign.
Returns: Per platform and all together: posts, totals, medians, a series, top posts, ads.
Does: Reads · Free on every account
Limits: Free on every account: 500 tool calls a day (1,500 on the paid plan), shared by all tools.
Parameters:
- from? (string): start date YYYY-MM-DD (default: `days` before `to`)
- to? (string): end date YYYY-MM-DD (default today)
- days? (integer): window length when `from` is not given
- platforms? (("instagram" | "tiktok" | "facebook" | "linkedin")[]): only these platforms (default all)
- accounts? (string[]): only these account names (as listed in `accounts`)
- metric? ("views" | "reach" | "likes" | "comments" | "shares" | "saves" | "interactions" | "eng" | "watch" | "hold" | "skip" | "fullwatch" | "follows" | "visits"): metric for the time series
- aggregate? ("sum" | "median" | "count"): per time bucket: sum, median per post, or number of posts
- granularity? ("day" | "week" | "month" | "auto")
- top? (integer): top posts per platform
- include_posts? (boolean): also return every post in the window (up to 1000)
- compare? ("prev" | "year" | "none"): compare per-platform totals/medians and ad totals with the previous period of the same length, or the same dates last year
## Worked example
"Show my Instagram views per week since September, median per post."
Call my_dashboard {"days":90,"platforms":["instagram"],"metric":"views","aggregate":"median","granularity":"week"} and answer from what it returns, with the links.
## Rules
- Every claim about a video, creator, brand or ad comes from a tool result. Say so when a tool returned nothing.
- Every result carries a link to its page on socialscout.be: put it next to each name.
- "5x" or "viral" means five times the account's own normal views, not a fixed number.
- Times without an offset are Belgian time (Europe/Brussels).
- A tool that answers with a sentence instead of data is telling you what it needs (a plan, a key): pass that on, do not guess.What your agent reads
Free with any SocialScout account. Your team's full dashboard, the same numbers as socialscout.be/me/performance: every post SocialScout knows of (connected accounts merged with its own tracking, years back), per platform AND all together. For any date range and platform/account: posts, totals and MEDIANS per platform (views, reach, likes, comments, shares, saves, interactions, engagement rate), posts per week, viral (5x normal) count, a time series per platform (day/week/month), followers and account reach over time, ad spend per platform and per campaign (spend, impressions, CPM, CTR, CPC, conversions, cost per conversion; Meta also ROAS/purchase value, frequency, link CTR, hook rate = 3-second plays / impressions, hold rate = ThruPlays / 3-second plays, video p25-p100 funnel), ad sets and a creative leaderboard per ad (thumbnail, spend, CTR, ROAS, hook, hold, CPA), watch quality per post where the platform gives it (avg watch time, hold = watch / length, skip rate, full-watch rate, follows and profile visits from a post), followers gained vs lost, a comparison with the previous period or the same period last year, your sector's monthly median, and the top posts.
| Parameter | Type | About |
|---|---|---|
from | string | start date YYYY-MM-DD (default: `days` before `to`) |
to | string | end date YYYY-MM-DD (default today) |
days | integer | window length when `from` is not given |
platforms | ("instagram" | "tiktok" | "facebook" | "linkedin")[] | only these platforms (default all) |
accounts | string[] | only these account names (as listed in `accounts`) |
metric | "views" | "reach" | "likes" | "comments" | "shares" | "saves" | "interactions" | "eng" | "watch" | "hold" | "skip" | "fullwatch" | "follows" | "visits" | metric for the time series |
aggregate | "sum" | "median" | "count" | per time bucket: sum, median per post, or number of posts |
granularity | "day" | "week" | "month" | "auto" | |
top | integer | top posts per platform |
include_posts | boolean | also return every post in the window (up to 1000) |
compare | "prev" | "year" | "none" | compare per-platform totals/medians and ad totals with the previous period of the same length, or the same dates last year |
More in your numbers
my_watchlistYour private watchlist: each account's last 30 days against the 30 before, and its best videos.watch_accountAdd a TikTok or Instagram account to your private watchlist.unwatch_accountTake an account off your watchlist.my_numbersYour own connected accounts: reach, views, engagement, followers and ad results, against the period before.ask_scoutAsk Scout, the data analyst, anything across the database and your own data, ad reads included.my_brandYour brand profile: company, website, handles, and the brief Scout writes from.my_overviewYour own numbers in short: reach, views, engagement and followers, free on every account.my_postsYour own posts with their numbers, sorted the way you ask.