create_account
Make a SocialScout account from inside your AI.
- Returns
- A payment link, or a working key with an access code.
- Does
- Changes
- Who
- Free, no key
- Limits
- No key needed.
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: create_account
Make a SocialScout account from inside your AI.
Returns: A payment link, or a working key with an access code.
Does: Changes · Free, no key
Limits: No key needed.
Parameters:
- email (string): your work email
- name? (string): your name
- company? (string): company or team name
- access_code? (string): secret access code, if you were given one
## Worked example
"Make me a SocialScout account for hello@bakkerij.be."
Call create_account 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, no account needed. Create a paid SocialScout account (market research). With a valid access_code you get a working key instantly; without one you get a Stripe payment link and your key activates after payment. A free account (planner, calendar, memes, own analytics, all over this connection) needs no payment: sign up at https://socialscout.be/account?entry=signup. One account per email.
| Parameter | Type | About |
|---|---|---|
email | string | Required. your work email |
name | string | your name |
company | string | company or team name |
access_code | string | secret access code, if you were given one |
More in getting started
corpus_statsHow much is in the database: videos, creators, brands.