whoami

Self-test tool. A successful whoami call confirms the mcp client is connected to spirby with a valid token, and tells the agent what scope and rate budget it has.

required scope: read.

example prompts

• “who am i on spirby and what scope do i have?”
• “before you start, check your spirby permissions.”

input

{} — no arguments.

output

{
  "organization_id": "org_01H8...",
  "scope": "read:write",
  "rate_limit": {
    "limit": 1000,
    "remaining": 947,
    "reset_at_sec": 1731000018
  }
}

Use the rate_limit.remaining value before kicking off a long sequence — if you have fewer than 50 calls left and your task needs more, wait until reset_at_sec.