List who can open the dashboard

Lists the people who can sign in to this brand's dashboard, as the team panel on the Workspace page shows them: each address, when it was added, and which one is you.

GEThttps://api.tryscouty.com/v1/team

Scopeteam:manage
Read
MCP toolscouty_list_team

Markdown version for your agent

Authorization

Send a Scouty token as a bearer token in the Authorization header. The token needs the team:manage scope, or the call answers 403 insufficient_scope. Tokens and scopes

Authorization: Bearer $SCOUTY_TOKEN

Details

scouty_list_team shows what the team panel on the Workspace page shows. It needs team:manage, which is off unless someone ticked it.

json

{
  "members": [
    { "email": "maya@glow.example", "addedAt": "2026-08-02T10:14:00.000Z", "isYou": true },
    { "email": "sam@glow.example", "addedAt": "2026-09-11T16:40:00.000Z", "isYou": false }
  ]
}

Errors

A refusal answers { "error": { "code", "message" } }. Branch on code; the message is for a person. Every error and its fix

Status	error.code	Meaning
401 Unauthorized	`missing_token` `invalid_token` `token_revoked` `token_expired` `token_orphaned`	No token, or one that is not recognized, revoked or expired.
403 Forbidden	`insufficient_scope` `wrong_principal`	The token does not carry the scope this capability needs.
429 Too Many Requests	`rate_limited`	Too many requests this minute. Retry-After says how long is left.

import os import requests token = os.environ["SCOUTY_TOKEN"] response = requests.get( "https://api.tryscouty.com/v1/team", headers={"Authorization": f"Bearer {token}"}, ) print(response.json())

{ "members": [ { "email": "maya@acme.example", "addedAt": "2026-08-02T10:14:00.000Z", "isYou": true }, { "email": "sam@acme.example", "addedAt": "2026-09-11T16:40:00.000Z", "isYou": false } ] }