*MCP › Reference › Account & access › Account*

# Get the account

> Returns the account that made the request: its name, the timezone bare days are read in, its currency and country, the add-ons it has access to (a resource behind an add-on not listed responds 402), whether it is in its trial period, the API key that made the request with its scopes, the usage…

It is the first call of any integration: it replaces guessing.

TOOL `filmo_account_get` · `account:read` · 120/min · Server annotation: Read-only · Server annotation: Idempotent

## Arguments

This tool takes no arguments.

## Result

On success the result carries `structuredContent` with `data` and `meta`. These are the attributes of `data`.

| Name | Type | Description |
| --- | --- | --- |
| `name` | string | Name of the account. |
| `timezone` | string | IANA timezone of the business, the one bare days in filters are read in. |
| `currency` | string | ISO 4217 currency of the account; documents may carry their own. |
| `country` | string | ISO 3166-1 alpha-2 country of the business. |
| `language` | string | Default language of error messages for this key (BCP 47), unless Accept-Language says otherwise. |
| `addons` | string[] | Ids of the add-ons the account has access to today. A resource behind an add-on not listed here responds 402. `platform`, `user-seat`, `connected-account`, `extra-tax-cif`, `qr-codes`, `incidence`, `purchases`, `activity-log`, `custom-fields`, `profitability`, `web-builder`, `crm`, `consignments`, `email-calendar`, `sales-documents`, `internal-bookings`, `internal-communication`, `advanced-user-permissions`, `ai-pack-25k`, `ai-pack-55k`, `ai-pack-115k` |
| `trial` | object | Trial period of the account. |
| `trial.active` | boolean | true while the trial of the account lasts: every add-on is unlocked. |
| `trial.endsAt` | string<date-time> | End of the trial in ISO 8601 UTC; null if none. |
| `apiKey` | object | The key that made the request. Never its secret. |
| `apiKey.id` | string | Identifier of the API key that made the request. |
| `apiKey.name` | string | Name given to the key when it was created. |
| `apiKey.scopes` | string[] | Scopes granted to the key, the ones its requests can use. |
| `rateLimits` | object | Usage limits of the key, the ones the RateLimit-* headers report. |
| `rateLimits.global` | object | Requests per minute across the whole API. |
| `rateLimits.global.perMinute` | integer |  |
| `rateLimits.availability` | object | Requests per minute of the availability checks, counted apart. |
| `rateLimits.availability.perMinute` | integer |  |
| `api` | object | The contract this account is served with. |
| `api.version` | string | Version of the public API contract. |
| `api.docsUrl` | string | Where the documentation of this version lives. |

*Call · filmo_account_get*

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

*Result (generated from the schema)*

```json
{
  "structuredContent": {
    "data": {
      "name": "Example",
      "timezone": "<timezone>",
      "currency": "EUR",
      "country": "ES",
      "language": "es-ES",
      "addons": [
        "platform"
      ],
      "trial": {
        "active": true,
        "endsAt": "2026-09-01T08:00:00Z"
      },
      "apiKey": {
        "id": "id_8f2a1c",
        "name": "Example",
        "scopes": [
          "<scopes>"
        ]
      },
      "rateLimits": {
        "global": {
          "perMinute": 1
        },
        "availability": {
          "perMinute": 1
        }
      },
      "api": {
        "version": "<version>",
        "docsUrl": "https://example.com"
      }
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## Sample prompts

*Prompt*

```text
Which Filmo account am I connected to, and what are its time zone and currency?
```

## The same operation by REST

This tool runs [`GET /api/v1/account`](https://docs.filmo.io/rest-api/endpoint-reference/account/get-the-account).

---

Canonical URL: https://docs.filmo.io/mcp/tools/account/filmo-account-get  
Last updated: 2026-10-25