social·scout

Tools for your agent

create_plan

A set of drafts in one go, up to 31 (a month of daily posts).

Returns
The plan with every draft and one link to review them all.
Does
Drafts · scope drafts
Who
Free on every account
Limits
Up to 31 drafts per plan. 2,000 planner calls a day per account, 200 of them writes.
REST
POST /api/v1/plans

Try it on your account

This makes a real draft on your calendar. It never goes out by itself; delete it there if you do not want it.

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: create_plan
A set of drafts in one go, up to 31 (a month of daily posts).
Returns: The plan with every draft and one link to review them all.
Does: Drafts · Free on every account
Limits: Up to 31 drafts per plan. 2,000 planner calls a day per account, 200 of them writes.

Parameters:
- title (string)
- items (object[])
- idempotency_key (string): Any unique string for this create (a UUID). Sending the same key again returns the first result instead of making a second post.
A draft never goes out by itself. Send a fresh idempotency_key with every create, and give me the review_url from the answer.

## Worked example
"Plan December around the Belgian moments: one post a week."
Call create_plan 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. Make several drafts in one go (a week, a month, a campaign), up to 31. Each item takes the same fields as create_draft. All of them are drafts on the calendar: a person reviews the set and schedules it with one click, or post by post.

ParameterTypeAbout
titlestringRequired.
itemsobject[]Required.
idempotency_keystringRequired. Any unique string for this create (a UUID). Sending the same key again returns the first result instead of making a second post.

More in planner

  • list_moments The Belgian marketing calendar: holidays, school breaks, sales, local events, with the day to start planning.
  • list_accounts The social accounts you connected, with what each can post.
  • get_platform_rules Text and media limits per platform, as scheduling checks them.
  • get_moment One calendar moment in full: its dates, why it matters and how brands used it.
  • list_calendar Your calendar between two days: drafts, scheduled and published posts.
  • get_post One post on your calendar, with what would stop it from going out.
  • list_posting_times The posting times set for one connected account.
  • suggest_times Free times to post, with the reason for each.

← All 60 tools

create_plan · Tools · SocialScout