---
title: "What this key can do"
method: GET
path: "/api/mcp/whoami"
tags: ["AlphaYou"]
---

# What this key can do

`GET /api/mcp/whoami`

## Request

- Base URL: `https://api.alphayou.net`
- URL: `https://api.alphayou.net/api/mcp/whoami`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns the tier a key resolves to and the tools it may call. The published MCP package calls this at startup to decide which tools to register, so it answers on the lowest tier.

Plans: Free, Pro.

## Response `200`

The requested records.

## Other responses

- `401`: Missing, unrecognised or revoked API key (error key_revoked).
- `403`: This key's plan does not include this endpoint, or the key has been suspended (error key_suspended).
- `404`: Not an endpoint an API key may call.
- `429`: Rate limited. The scope field says which budget ran out: minute, day, account (shared by all of an account's keys), or concurrency (too many calls running at once). Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget. A call refused for going too fast (the per-minute limit) does not use up the day, so wait for Retry-After and try again.
- `503`: The request budget could not be checked right now. Retry after the number of seconds in Retry-After.

---

[API](https://skmtc.dev/alphayou/apis/alphayou-api.md) · [All operations](https://skmtc.dev/alphayou/apis/alphayou-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphayou/apis/alphayou-api/revisions/cde9e990c368?raw)