get_me
Describe the person the token acts as — the team the token is scoped to, every team held, where alerts go, the unread count and whether Telegram is linked. Takes no input.
Learn who the agent is acting as before doing anything else: the person, the team the token is scoped to (current_team.id, the id every other tool acts in), every team they belong to, where their alerts are routed, how many Notifications Center entries they have not opened and whether their account is linked to the Telegram bot. The payload is exactly what GET /v1/me returns.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same actions as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
This tool takes no arguments.
What it returns
{ "data": { "id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "name": "Priya Patel", "email": "priya@example.com", "title": "Business Analyst", "locale": "en", "timezone": "Asia/Colombo", "email_verified": true, "current_team": { "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Zuse Technologies", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "created_at": "2026-05-18T10:05:00+00:00" }, "teams": [ { "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Zuse Technologies", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "created_at": "2026-05-18T10:05:00+00:00" } ], "alert_destinations": [], "alert_destinations_default": true, "unread_notifications": 3, "telegram_linked": false, "created_at": "2026-05-18T10:05:00+00:00" }, "meta": {}}alert_destinations_default is true while the person has written no destination of their own, so the application's default routing applies. current_team is null for a token minted without a team scope, or when the person has since left that team.
How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:read.
How is this guide?
Last updated on