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.

Purpose

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.

Required ability

account:read

Input schema

{
  "type": "object",
  "properties": {}
}

Output shape

{
  "data": {
    "id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "name": "Ada Lovelace",
    "email": "[email protected]",
    "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.

Example prompts

"Who am I signed in as, and which team will you act in?"

"Do I have coupons and free plans on my current plan?"

"Which accounts are linked to my Subscriby account, and where do my alerts go?"

Failure modes

AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks account:read.