Before you start
You need Claude Code and a SocialRouter account. No API key: Claude Code signs you in itself. Sign up at socialrouter.io if you have not yet.1
Run one command
--scope user makes SocialRouter available in every project on your machine, which
is what you want in doubt.2
Sign in
Start Claude Code and type
/mcp. Pick socialrouter, and it opens your browser
on the SocialRouter consent screen. Approve, and the connection is live. Claude Code
keeps the token and reconnects on its own from now on.Using an API key instead
Using an API key instead
Use a key where a browser flow cannot run, such as a shared config or a machine
you never sit in front of. Pass it as a header and no sign-in ever runs:Create the key in the dashboard. It is
shown once, at creation.
3
Check it is connected
socialrouter should show up as connected. Inside a session, typing /mcp shows
the same thing plus the tools it adds.4
Ask for something
Get me Satya Nadella’s LinkedIn profile.Claude finds the right service on its own. If you are not sure what to ask, try “What social media data can you pull with SocialRouter?”
Removing it
If something goes wrong
/mcp shows the server as failed
/mcp shows the server as failed
Call the endpoint yourself to see the real answer:A
401 means the credential is wrong, revoked, or missing from the header. Anything
else with "serverInfo" in it means the endpoint is fine and the problem is in the
client config.The sign-in never starts, or fails with a 404
The sign-in never starts, or fails with a 404
Remove the server and add it again:
claude mcp remove socialrouter --scope user,
then the command above. Adding it with a header configured also skips the sign-in
entirely, because a client that holds a credential never asks for one.
Authentication has the rest.It connected, then started failing
It connected, then started failing
The connection may have been disconnected from the
dashboard, where every app you approved is
listed. Run
/mcp and authenticate again to restore it.The project-level header comes through empty
The project-level header comes through empty
${SOCIALROUTER_API_KEY} is expanded from the environment Claude Code runs in.
Export it in your shell profile, or drop the header and sign in instead.Next steps
Tools reference
What
list_services, run, get_extraction and get_account do.Skills
Ready-made workflows on top of the API, installable as a Claude Code plugin.