social·scout

Tools for your agent

set_posting_times

Set the posting times of one connected account.

Returns
The account's new posting times.
Does
Drafts · scope drafts
Who
Free on every account
Limits
2,000 planner calls a day per account, 200 of them writes.
REST
PUT /api/v1/accounts/{id}/posting-times

Try it on your account

This one needs a file or changes your account's settings, so it runs from your agent, 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: set_posting_times
Set the posting times of one connected account.
Returns: The account's new posting times.
Does: Drafts · Free on every account
Limits: 2,000 planner calls a day per account, 200 of them writes.

Parameters:
- account_id? (integer): any connected account of this SocialScout account; the times are shared
- slots (object[])
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
"Post on Instagram at 12:00 and 19:30 on weekdays."
Call set_posting_times 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. Set the weekly posting times (Belgian time, whole hours, up to 14). They are what "next_free_time" picks from, and the same times the dashboard's best-times card saves: one set per SocialScout account, shared by its connected accounts. Replaces the earlier times; an empty list clears them. Nothing is published.

ParameterTypeAbout
account_idintegerany connected account of this SocialScout account; the times are shared
slotsobject[]Required.

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

set_posting_times · Tools · SocialScout