Reference

Who am I

The token in use, its scopes, which client is calling, and how many agents it can reach.

REST	`GET /api/v1/me`
MCP tool	`get_account`
Classification	Read (changes nothing)
Scope	Any valid token
Minimum role on the agent	any member
Confirmation	Not needed
Retry safety	Safe to retry with the same input
Success status	200

What it does

The token in use, its scopes, which client is calling, and how many agents it can reach. Call this first.

Side effects

None. It only reads.

Inputs

No inputs.

Example

REST

curl "https://covo.lanaai.io/api/v1/me" \
  -H "Authorization: Bearer $COVO_TOKEN"

MCP (POST /mcp)

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_account",
    "arguments": {}
  }
}

Response

Returns an object with token, client, agents, restricted_to_agents and scopes. This is a real response, shortened to two items per list.

200 response

{
  "token": {
    "id": "9203ec5c-173c-46e8-aa45-1a643266fdab",
    "name": "Docs examples",
    "scopes": [
      "agents:read",
      "agents:write"
    ]
  },
  "client": {
    "name": "docs-examples",
    "interface": "rest"
  },
  "agents": 1,
  "restricted_to_agents": false,
  "scopes": {
    "agents:read": "See agents, their configuration, versions, drafts, deployment and diagnostics.",
    "agents:write": "Change configuration, add knowledge, create drafts and versions.",
    "agents:delete": "Remove links, offers, knowledge and Places as part of a change. Needs confirmation.",
    "agents:test": "Run test conversations. Test replies count toward the AI reply allowance.",
    "agents:publish": "Publish, unpublish and restore earlier versions of a live agent. Needs confirmation.",
    "conversations:read": "Read conversations visitors had with an agent. These contain personal data."
  }
}

Over MCP the same object comes back as the tool result, in structuredContent and as JSON text.

Errors

Status	Code	Meaning
401	`unauthorized`	No token, or it is unknown, revoked or expired. OAuth apps refresh or reconnect.
403	`account_suspended`	The account that owns the token is paused.
400	`bad_request`	An input is invalid; `field` names it.
429	`rate_limited`	Wait `Retry-After` seconds.