Who am I and what may I do?
whoamiCheck your account identity, permissions, budgets, sending capacity, and current send status before taking action or after a refusal; this read-only tool changes nothing.
Instructions
Purpose: the one read to make before deciding anything, and again after any refusal. Answers who you are and what you may do. NOT for: changing anything. Returns: the account and key, the scopes held, the tools those scopes can call, budget consumed and remaining with its refill time, the per-minute ceilings, whether the kill switch is down, the account trust standing, can_send_now as the summary for real recipients, can_send_to_simulator for test sends to @simulator.agentisend.com addresses, capacity.per_mail_system_per_hour (this account's own cap for one receiving mail system; 10 until the account is 7 days old) and capacity.shared_pool_per_mail_system_per_hour (all customers together), pending_approvals: sends from this key waiting for a person, which hold only those sends, test_send: before a domain verifies, the address a first test goes from and the account's own addresses it can go to, sending_domains.limit: how many verified sending domains this plan may hold (null when the plan has no cap), and next_step: when this account has no domain, one sentence telling you to offer setup plus the tools create_domain, get_domain and wait_for_domain (null once a domain exists).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "whoami"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| trust | No | ||
| budget | No | ||
| scopes | No | ||
| capacity | No | How fast mail can leave today. | |
| next_step | No | Set when this account has no domain. Null once a domain exists. | |
| test_send | No | Where a first test can go before a domain verifies, or null. | |
| account_id | No | Identifier. | |
| api_key_id | No | Identifier. | |
| loop_guard | No | How this key watches sends. repetition-only (the default) holds near-identical repeats. full also holds a send to an inbox the last hour collapsed onto. off holds nothing. A marketing send on a key with no setting still uses full. | |
| kill_switch | No | ||
| api_key_name | No | ||
| can_send_now | No | True when a real recipient would be accepted. | |
| callable_tools | No | ||
| quota_resets_at | No | ISO 8601 time. | |
| sending_domains | No | The domain cap create_domain enforces for this account. | |
| pending_approvals | No | ||
| can_send_to_simulator | No | True when an address ending in @simulator.agentisend.com would be accepted. | |
| rate_limits_per_minute | No |