Every tool your agent can use
Try any tool on your own account, or copy a prompt into Claude, Cursor or ChatGPT.
Set up all 60 at once
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 tools (59)
### Belgian brands
- get_brand: Everything a brand page shows: numbers, rank, format mix, rhythm, creators, Meta ads.
- list_sectors: Every sector in the database with how many viral videos it has.
- rising_brands: The brands growing fastest right now, with the evidence: followers, new ads, views.
- compare: Two to six brands or creators side by side on the same numbers.
### Creators
- search_creators: Describe who you need in plain words and get the Flemish creators who fit.
- creator_breakouts: The biggest videos by people (not brands): each at least 5x their normal reach.
- get_creator: Everything a creator page shows: reach per platform, niche rank, price estimate, brands.
### Videos & formats
- search_viral_videos: Describe a video idea in plain words and get the viral brand videos that match.
- top_viral: The biggest brand videos: each one did at least 5x the account's normal views.
- get_video: Everything about one video: what happens, the format, the numbers, who made it and why it spread.
- explore: Exactly what an Explore view shows: the cards and the charts with their findings.
- stats_query: Any count across all posts: group by sector, format, weekday, hour and more, with filters.
- list_formats: The formats and trends library: hook, mechanic, what it is best for, example videos.
- search_memes: Search the meme templates (pictures and video), brand-safe by default. (free on every account)
- get_meme: One meme template: what it means, how it is used, what to avoid, where the text goes. (free on every account)
### Meta ads & ad reads
- openings: Positioning gaps: what Belgians watch in a sector's videos while few competitor ads say it, and what every ad already says.
- brand_moves: What one brand changed month by month: Meta ads started, its posts, and what its website began to say.
- search_inspiration: Search the Inspired wall: great ads from everywhere, each with why it works and where it came from. (free on every account)
- get_inspiration: One ad from the Inspired wall: why it works, its angles, its source and the ads like it. (free on every account)
- list_ad_plays: The play book: named advertising tricks behind great ads, what each one is and how to make one. (free on every account)
### Calendar & moments
- list_moments: The Belgian marketing calendar: holidays, school breaks, sales, local events, with the day to start planning. (free on every account)
- 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. (free on every account)
### 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. (free on every account)
- my_dashboard: Your full dashboard history for any dates: medians per platform, a time series, followers, ads per campaign. (free on every account)
- 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. (free on every account)
- my_overview: Your own numbers in short: reach, views, engagement and followers, free on every account. (free on every account)
- my_posts: Your own posts with their numbers, sorted the way you ask. (free on every account)
- my_post: One of your posts in full, with its numbers. (free on every account)
- my_benchmark: You against your sector: your medians next to the sector's. (free on every account)
- my_best_times: When your posts do best, per weekday and hour (your sector's when you have too few). (free on every account)
- list_agents: The agents your team set up on SocialScout: what each does, when it runs and its last run.
- save_agent: Make a new hosted agent or change one: its task, when it runs, its tools and where results go.
- switch_agent: Pause or resume one of your agents.
- run_agent: Run one of your agents once, now, and read its report.
### Planner
- list_accounts: The social accounts you connected, with what each can post. (free on every account)
- get_platform_rules: Text and media limits per platform, as scheduling checks them. (free on every account)
- list_calendar: Your calendar between two days: drafts, scheduled and published posts. (free on every account)
- get_post: One post on your calendar, with what would stop it from going out. (free on every account)
- list_posting_times: The posting times set for one connected account. (free on every account)
- suggest_times: Free times to post, with the reason for each. (free on every account)
- create_draft: Make a draft post on your calendar. It never goes out by itself. (free on every account)
- update_draft: Change a draft: text, accounts, media, time. (free on every account)
- duplicate_post: Copy a post as a new draft. (free on every account)
- create_plan: A set of drafts in one go, up to 31 (a month of daily posts). (free on every account)
- request_upload_link: Get a link to upload a picture or video for a draft. (free on every account)
- import_media: Fetch a picture or video from a link into your files, for a draft. (free on every account)
- set_posting_times: Set the posting times of one connected account. (free on every account)
- schedule_post: Put a draft on a time. Without your switch on the key, a person confirms with one click. (free on every account)
- reschedule_post: Move a scheduled post to another time. (free on every account)
- unschedule_post: Take a scheduled post back to a draft. (free on every account)
- delete_post: Delete a post from your calendar. (free on every account)
### Getting started
- create_account: Make a SocialScout account from inside your AI. (free, no key)
- corpus_stats: How much is in the database: videos, creators, brands. (free, no key)
Each tool's parameters come with the connection (tools/list). Full reference for machines: https://socialscout.be/mcp. One page per tool: https://socialscout.be/agents/tools.
## Worked example
"Find the 10 Belgian food brands whose Meta ads changed their hook this week, and what they changed to."
1. rising_brands {"belgian": true, "advertisers": true, "limit": 30}: the Belgian advertisers moving now; keep the food ones (list_sectors has the sector names).
2. brand_moves {"handle": "<each>"}: which of them started new Meta ads this month, by format, and their longest-running ads.
3. ask_scout {"question": "For <brands>: which started Meta ads this week with a different hook than their ads before? Give the hook before and after, with the ad links."}: Scout reads Gemini's read of every ad (hook, angle, offer). It takes up to a minute.
4. Answer as a table: brand (linked), hook before → hook now, the ad link, and one line on what that tells me.
## 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.search_viral_videosDescribe a video idea in plain words and get the viral brand videos that match.search_creatorsDescribe who you need in plain words and get the Flemish creators who fit.top_viralThe biggest brand videos: each one did at least 5x the account's normal views.top_breakoutsThe same tool as top_viral, under its older name.creator_breakoutsThe biggest videos by people (not brands): each at least 5x their normal reach.get_brandEverything a brand page shows: numbers, rank, format mix, rhythm, creators, Meta ads.get_creatorEverything a creator page shows: reach per platform, niche rank, price estimate, brands.get_videoEverything about one video: what happens, the format, the numbers, who made it and why it spread.list_sectorsEvery sector in the database with how many viral videos it has.create_accountMake a SocialScout account from inside your AI.corpus_statsHow much is in the database: videos, creators, brands.rising_brandsThe brands growing fastest right now, with the evidence: followers, new ads, views.openingsPositioning gaps: what Belgians watch in a sector's videos while few competitor ads say it, and what every ad already says.brand_movesWhat one brand changed month by month: Meta ads started, its posts, and what its website began to say.list_momentsThe Belgian marketing calendar: holidays, school breaks, sales, local events, with the day to start planning.moment_videosThe videos made for one moment, with how sure the model is that they were.todayToday on SocialScout: the date, today's and upcoming moments, and the posts that just took off.exploreExactly what an Explore view shows: the cards and the charts with their findings.stats_queryAny count across all posts: group by sector, format, weekday, hour and more, with filters.compareTwo to six brands or creators side by side on the same numbers.list_formatsThe formats and trends library: hook, mechanic, what it is best for, example videos.search_memesSearch the meme templates (pictures and video), brand-safe by default.get_memeOne meme template: what it means, how it is used, what to avoid, where the text goes.search_inspirationSearch the Inspired wall: great ads from everywhere, each with why it works and where it came from.get_inspirationOne ad from the Inspired wall: why it works, its angles, its source and the ads like it.list_ad_playsThe play book: named advertising tricks behind great ads, what each one is and how to make one.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.my_dashboardYour full dashboard history for any dates: medians per platform, a time series, followers, ads per campaign.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.list_accountsThe social accounts you connected, with what each can post.get_platform_rulesText and media limits per platform, as scheduling checks them.get_momentOne calendar moment in full: its dates, why it matters and how brands used it.list_calendarYour calendar between two days: drafts, scheduled and published posts.get_postOne post on your calendar, with what would stop it from going out.list_posting_timesThe posting times set for one connected account.suggest_timesFree times to post, with the reason for each.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.my_postOne of your posts in full, with its numbers.my_benchmarkYou against your sector: your medians next to the sector's.my_best_timesWhen your posts do best, per weekday and hour (your sector's when you have too few).create_draftMake a draft post on your calendar. It never goes out by itself.update_draftChange a draft: text, accounts, media, time.duplicate_postCopy a post as a new draft.create_planA set of drafts in one go, up to 31 (a month of daily posts).request_upload_linkGet a link to upload a picture or video for a draft.import_mediaFetch a picture or video from a link into your files, for a draft.set_posting_timesSet the posting times of one connected account.schedule_postPut a draft on a time. Without your switch on the key, a person confirms with one click.reschedule_postMove a scheduled post to another time.unschedule_postTake a scheduled post back to a draft.delete_postDelete a post from your calendar.list_agentsThe agents your team set up on SocialScout: what each does, when it runs and its last run.save_agentMake a new hosted agent or change one: its task, when it runs, its tools and where results go.switch_agentPause or resume one of your agents.run_agentRun one of your agents once, now, and read its report.
Recipes
Weekly competitor ad digest
Every Monday, what my competitors changed in their Meta ads: new ads, new hooks, ads that keep running.
my_brandRead my competitors from my brand profile. If none are listed, ask me for three handles.brand_movesFor each competitor: Meta ads started this month and last month by format, and the ads running longest.get_brandFor each: its Meta ads block (count, reach, top ads) and its viral videos of the last weeks.ask_scoutOne question for all of them: which ads started in the last 7 days, and how do their hook, angle and offer differ from the ads before?
Plan a month around Belgian moments
Next month's posts, each one hung on a Belgian moment that matters to my sector, as drafts on my calendar.
my_brandRead my sector, voice and pillars.list_momentsNext month's moments for my sector (tier 1 and 2, Belgian only), with plan_from.get_momentFor the four best: what it is and what Belgian accounts posted for it before.moment_videosFor each of the four, the brand videos that did best for it (on the founding plan).list_accountsWhich accounts I can post to.suggest_timesA good time on each day, with its reason.create_planAll drafts as one plan, each with its moment slug, a time_reason and a fresh idempotency_key.
Creators who already made content for your competitors
A shortlist of Flemish creators with proof they work for brands like mine, and who they worked with.
my_brandRead my competitors and my audience.get_brandFor each competitor: the creators it was seen with and the views each brought.get_creatorFor the creators who show up for two or more competitors, or brought the most views: reach, niche rank, paid posts, post price.search_creatorsThree more who fit my audience but have not worked for a competitor yet.
Compare my numbers to my sector
Where my accounts stand against Belgian brands in my sector, and the two things to change first.
my_overviewMy numbers for the last 90 days against the 90 before.my_benchmarkMy medians next to my sector's.my_best_timesWhen my posts do best.stats_queryFor my sector this year: viral rate and median views by format, and by weekday (founding plan).top_viralFive of my sector's biggest hits this year, as examples (founding plan).
How it connects
Every tool lives on one MCP server, https://socialscout.be/api/mcp. Your key goes in the link (?key=) or as Authorization: Bearer. It reads everything your plan includes and may make drafts; scheduling always waits for a person. Step by step for ChatGPT and Claude: Connect your AI. The planner's REST API and its rules: planner reference. For machines: socialscout.be/mcp.