Connecting a client

The server lives at one URL:

https://seosorted.ai/api/mcp

Paste it into your MCP client. The client discovers everything else, opens your browser, and you approve the connection by signing in the way you always do. There is no key to create, copy or store.

What happens

Your client discovers the server

It fetches /.well-known/oauth-protected-resource, finds the authorization server, and registers itself automatically. Nothing for you to configure.

Your browser opens

You land on seosorted.ai. If you are already signed in, you skip straight to the next step — it is the same session as the dashboard.

You choose what it gets

Pick the workspace it may work in, and tick what it may do. Then Connect.

Done

The client receives its own credential and the browser closes. Ask the agent to call get_cited_youtube_videos to confirm.

The approval screen

You are granting access to one workspace, not your whole account:


Workspace	Which site the agent works on. It can never see another one. If you only have one workspace, this is skipped.
Read your SEO data	Keywords, articles, audits, site profile.
Research and write content	Keyword lookups, audits, article generation. Spends your monthly credits.
Publish to your website	Send articles to your CMS. Off by default — tick it deliberately.

Anything you leave unticked is refused at the moment it is used, not just hidden. An agent without the publish permission cannot publish, whatever it tries. Access also never exceeds your own. The agent acts as you, and your role in that workspace is re-checked on every single call — if you are demoted or removed, its access changes with you.

Setting it up

Claude Code
Other MCP clients
API key (headless)

claude mcp add --transport http --scope user seosorted https://seosorted.ai/api/mcp

Your browser opens for approval on first use.--scope user makes it available in every project. Leave it off and the connection is only added to the directory you ran the command in.

Add a remote MCP server with:

Transport: HTTP (Streamable HTTP)
URL: https://seosorted.ai/api/mcp

Any client supporting the MCP authorization spec handles discovery, registration and the browser flow for you.

For CI, cron or a script with no browser, a workspace Admin can mint a long-lived key:

curl -X POST https://seosorted.ai/api/v1/workspaces/YOUR_WORKSPACE_ID/api-keys \
  -H 'Content-Type: application/json' \
  -b '__session=YOUR_SESSION_COOKIE' \
  -d '{ "name": "CI" }'

The key is returned once and only its hash is stored. Send it as Authorization: Bearer sk_ss_live_….

Prefer signing in. A key is a standing credential with no browser approval behind it — if it leaks, anyone can spend your credits and act with its role. Never commit one.

Checking it worked

Ask the agent for one intent, with transcripts off so it costs almost nothing:

2 cited video(s) across 1 intent(s); 0 transcript(s) retrieved.

| Intent                    | Video                            | Channel        | Transcript    |
|---------------------------|----------------------------------|----------------|---------------|
| how to change a flat tire | How To EASILY Change a Flat Tire | Roadside Fix   | not requested |
| how to change a flat tire | How to change a tire. Love, Dad  | Dad, how do I? | not requested |

_99 of 100 remaining this month on the FREE plan._

The last line tells you which workspace’s credits you are spending. If the workspace is wrong, reconnect and pick a different one on the approval screen.

Disconnecting

Remove the server in your MCP client, or revoke it from SeoSorted — either stops it. Access tokens last an hour and refresh silently until revoked.

When a connection stops working

You are no longer a member of this workspace

The connection acts as you. Losing membership ends it — there is no lingering access.

This workspace's subscription has lapsed

Payment failed and the grace period ran out. Resubscribe and it reconnects.

This credential has VIEWER access; EDITOR is required

Your workspace role is too low for that tool. Ask an admin to raise it — the connection picks the change up on its next call.

Too many MCP calls

120 calls per minute. Ask the agent to batch its work.

Get started

Reference

What happens

The approval screen

Setting it up

Checking it worked

Disconnecting

When a connection stops working

​What happens

​The approval screen

​Setting it up

​Checking it worked

​Disconnecting

​When a connection stops working

What happens

The approval screen

Setting it up

Checking it worked

Disconnecting

When a connection stops working