social·scout

Tools for your agent

list_moments

The Belgian marketing calendar: holidays, school breaks, sales, local events, with the day to start planning.

Returns
Moments with dates, kind, region, the sectors they matter to and plan_from.
Does
Reads · scope read
Who
Free on every account
Limits
Up to 500 results per call. Free on every account: 500 tool calls a day (1,500 on the paid plan), shared by all tools.
REST
GET /api/v1/moments

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: list_moments
The Belgian marketing calendar: holidays, school breaks, sales, local events, with the day to start planning.
Returns: Moments with dates, kind, region, the sectors they matter to and plan_from.
Does: Reads · Free on every account
Limits: Up to 500 results per call. Free on every account: 500 tool calls a day (1,500 on the paid plan), shared by all tools.

Parameters:
- from? (string): YYYY-MM-DD, default today (Brussels)
- to? (string): YYYY-MM-DD, default from + 60 days
- q? (string): words in the name, English, Dutch or French
- kind? ("national" | "local" | "all")
- belgian_only? (boolean): only moments specific to Belgium
- limit? (integer)

## Worked example
"Which Belgian moments matter for a bakery in the next two months?"
Call list_moments {"belgian_only":true,"limit":15} 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. The Belgian marketing calendar for 2026 and 2027: holidays, school holidays per community, sales periods, retail and charity campaign days, sports, festivals, religious days, awareness days and Belgian local events, with dates, the sectors each matters to and the day to start planning (plan_from). Default window: today to 60 days ahead. Use the slug with moment_videos.

ParameterTypeAbout
fromstringYYYY-MM-DD, default today (Brussels)
tostringYYYY-MM-DD, default from + 60 days
qstringwords in the name, English, Dutch or French
kind"national" | "local" | "all"
belgian_onlybooleanonly moments specific to Belgium
limitinteger

More in calendar & moments

  • moment_videos The videos made for one moment, with how sure the model is that they were.
  • today Today on SocialScout: the date, today's and upcoming moments, and the posts that just took off.
  • get_moment One calendar moment in full: its dates, why it matters and how brands used it.

← All 60 tools

list_moments · Tools · SocialScout