# get_account

Who the assistant is acting for, how many documents are left, and which custom domains it can send under.

MCP tool at `https://api.signwithsigil.com/mcp`. Read-only. Idempotent.

## Description (what the model sees)

> The account this server acts for: email, plan, documents left (documents.available; null when unmetered) with this month's allowance and pack documents, and verified custom domains. Sending a pact uses one document per 3 signers (CCs are free).

## Arguments

None.

## Returns

The [account object](/api-reference/objects/account). Returned as one `text` content item holding JSON.

- `email` (string): The account's email address.
- `plan` (string): The membership. One of: `free`, `starter`, `pro`, `business`.
- `member_level` (integer): The membership as a number: 0 Free, 1 Starter, 2 Pro, 3 Business.
- `documents` (object): What you can still send. See [Documents and plans](/concepts/documents).
  - `available` (integer | null): Documents you can use now: this month's remaining allowance plus pack documents. `null` when unmetered.
  - `unmetered` (boolean): `true` for an account that is never charged documents.
  - `monthly` (object | null): This month's allowance. `null` when unmetered.
    - `granted` (integer): This month's allowance.
    - `used` (integer): Used from it so far.
    - `remaining` (integer): Left in it.
    - `period_start` (string (date-time)): The start of the month (UTC).
    - `resets` (string (date-time)): When the next allowance starts. Unused documents do not roll over.
  - `packs` (integer): Documents left in purchased packs. Packs never expire.
  - `signers_per_document` (integer): Signers one document covers (3).
- `domains` (array of strings): Your verified custom domains, usable as `domain_host` when creating a pact.

## Example call

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

## Example result

```json
{
  "email": "you@example.com",
  "plan": "pro",
  "member_level": 2,
  "documents": {
    "available": 97,
    "unmetered": false,
    "monthly": {
      "granted": 100,
      "used": 7,
      "remaining": 93,
      "period_start": "2026-10-01T00:00:00Z",
      "resets": "2026-11-01T00:00:00Z"
    },
    "packs": 4,
    "signers_per_document": 3
  },
  "domains": [
    "sign.example.com"
  ]
}
```