social·scout

Tools for your agent

my_posts

Your own posts with their numbers, sorted the way you ask.

Returns
Posts with platform, date, views, reach, engagement and a link.
Does
Reads · scope read
Who
Free on every account
Limits
Up to 200 results per call. 2,000 planner calls a day per account, 200 of them writes.
REST
GET /api/v1/analytics/posts

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_posts
Your own posts with their numbers, sorted the way you ask.
Returns: Posts with platform, date, views, reach, engagement and a link.
Does: Reads · Free on every account
Limits: Up to 200 results per call. 2,000 planner calls a day per account, 200 of them writes.

Parameters:
- days? (integer): default 28; 0 = all
- from? (string): YYYY-MM-DD (Belgian day)
- account_ids? (integer[])
- platform? ("instagram" | "facebook" | "tiktok" | "linkedin")
- sort? ("recent" | "best" | "worst"): best / worst = by the multiple of the account's usual
- limit? (integer)

## Worked example
"Which of my posts did best in the last 90 days?"
Call my_posts {"days":90,"limit":10} 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. This account's published posts of the last N days with their numbers and how each did against the account's usual. Read-only.

ParameterTypeAbout
daysintegerdefault 28; 0 = all
fromstringYYYY-MM-DD (Belgian day)
account_idsinteger[]
platform"instagram" | "facebook" | "tiktok" | "linkedin"
sort"recent" | "best" | "worst"best / worst = by the multiple of the account's usual
limitinteger

More in your numbers

  • my_watchlist Your private watchlist: each account's last 30 days against the 30 before, and its best videos.
  • watch_account Add a TikTok or Instagram account to your private watchlist.
  • unwatch_account Take an account off your watchlist.
  • my_numbers Your own connected accounts: reach, views, engagement, followers and ad results, against the period before.
  • my_dashboard Your full dashboard history for any dates: medians per platform, a time series, followers, ads per campaign.
  • ask_scout Ask Scout, the data analyst, anything across the database and your own data, ad reads included.
  • my_brand Your brand profile: company, website, handles, and the brief Scout writes from.
  • my_overview Your own numbers in short: reach, views, engagement and followers, free on every account.

← All 60 tools

my_posts · Tools · SocialScout