get_me
Describe the creator the token belongs to — plan and capabilities, the team the token is scoped to, every team held, connected accounts and alert destinations. Takes no input.
Learn who the agent is acting as before doing anything else: the creator, the team the token is scoped to (current_team.id, the id the other tools act in), every team they belong to, the platform plan and the capabilities it grants, the accounts linked on the connectors, and where alerts go. 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": "Ada Lovelace", "email": "ada@example.com", "locale": "en", "email_verified": true, "plan": "growth", "capabilities": { "no_branding": true, "custom_handle": true, "time_limited_passes": true, "coupons": true, "free_plans": true, "teams": true, "disaster_recovery_prevention": true, "multi_connector": true }, "current_team": { "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Analytical Engines", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "personal": true, "created_at": "2026-05-18T10:05:00Z" }, "teams": [{ "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86", "name": "Analytical Engines", "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80", "personal": true, "created_at": "2026-05-18T10:05:00Z" }], "identities": [{ "id": "0c2d8a7e-4b1f-4d3e-9a6b-2f5e8c1d7a90", "connector": "telegram", "purpose": "primary", "source": "handshake", "external_id": "123456789", "display_name": "Ada Lovelace", "username": "ada", "linked_at": "2026-09-12T10:05:00Z", "verified_at": "2026-09-12T10:05:00Z" }], "alert_destinations": [], "alert_destinations_default": true, "created_at": "2026-05-18T10:05:00Z" }}alert_destinations_default is true while the creator has written no destination: every class of alert then reaches their primary connected account, and the critical classes their email. plan is null without an active platform subscription.
How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks account:read.
How is this guide?
Last updated on