social·scout

Tools for your agent

get_meme

One meme template: what it means, how it is used, what to avoid, where the text goes.

Returns
Meaning, use, pitfalls, text places and a download link.
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: get_meme
One meme template: what it means, how it is used, what to avoid, where the text goes.
Returns: Meaning, use, pitfalls, text places and a download link.
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:
- id (string)

## Worked example
"Explain this meme and where my text goes."
Call get_meme 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. One meme template: what it means, how it is used, what to avoid, its text places and a download link.

ParameterTypeAbout
idstringRequired.

More in 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.
  • creator_breakouts The biggest videos by people (not brands): each at least 5x their normal reach.
  • get_video Everything about one video: what happens, the format, the numbers, who made it and why it spread.
  • 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.
  • 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.

← All 60 tools

get_meme · Tools · SocialScout