social·scout

Tools for your agent

save_agent

Make a new hosted agent or change one: its task, when it runs, its tools and where results go.

Returns
The agent as saved.
Does
Changes
Who
Paid plan · plans
Limits
1,500 tool calls a day on the paid plan, shared by all tools.

Try it on your account

This one changes your account (an account, your watchlist), so it runs from your agent, where you asked for it, not from a test form.

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: save_agent
Make a new hosted agent or change one: its task, when it runs, its tools and where results go.
Returns: The agent as saved.
Does: Changes · Paid plan
Limits: 1,500 tool calls a day on the paid plan, shared by all tools.

Parameters:
- id? (integer)
- name? (string)
- what? (string)
- face? ("scout" | "mila" | "gus" | "rae" | "tijs" | "noor" | "dex" | "lena")
- chores? (object[])
- tools? (string[])
- deliver? (object)
- limits? (object)
- on? (boolean)

Use it well: Keys for Apify, SERP API and YouTube are pasted on the AI crew page, never sent here.

## Worked example
"Make an agent that tells me every Monday what our competitors posted."
Call save_agent 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

Paid plan (market research). Create a hosted agent (no id) or change one (with id). what: the task in plain words. chores: when it runs (a schedule or an event); none = only by hand. tools: socialscout, accounts, apify, serpapi, youtube, or a saved endpoint like "http:12"/"mcp:3" from list_agents' tools. Keys for Apify, SERP API and YouTube are pasted by a person at https://socialscout.be/me/crew#connections, never here.

ParameterTypeAbout
idinteger
namestring
whatstring
face"scout" | "mila" | "gus" | "rae" | "tijs" | "noor" | "dex" | "lena"
choresobject[]
toolsstring[]
deliverobject
limitsobject
onboolean

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

save_agent · Tools · SocialScout