*MCP › Referencia › Cuenta y acceso › Cuenta*

# Obtener la cuenta

> Devuelve la cuenta que hizo la petición: su nombre, la zona horaria en la que se leen las fechas sin hora, su divisa y su país, los add-ons a los que tiene acceso (un recurso detrás de un add-on que no figura responde 402), si está en periodo de prueba, la clave de API que hizo la petición con sus…

Es la primera llamada de cualquier integración: sustituye a adivinar.

HERRAMIENTA `filmo_account_get` · `account:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente

## Argumentos

Esta herramienta no tiene argumentos.

## Resultado

En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`.

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `name` | string | Nombre de la cuenta. |
| `timezone` | string | Zona horaria IANA del negocio, aquella en la que se leen las fechas sin hora de los filtros. |
| `currency` | string | Moneda de la cuenta en ISO 4217; los documentos pueden llevar la suya. |
| `country` | string | País del negocio en ISO 3166-1 alpha-2. |
| `language` | string | Idioma por defecto de los mensajes de error de esta clave (BCP 47), salvo que Accept-Language indique otro. |
| `addons` | string[] | Ids de los add-ons a los que la cuenta tiene acceso hoy. Un recurso tras un add-on que no figura aquí responde 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 | Periodo de prueba de la cuenta. |
| `trial.active` | boolean | true mientras dura el periodo de prueba de la cuenta: todos los add-ons están desbloqueados. |
| `trial.endsAt` | string<date-time> | Fin de la prueba en ISO 8601 UTC; null si no hay. |
| `apiKey` | object | La clave que hizo la petición. Nunca su secreto. |
| `apiKey.id` | string | Identificador de la clave de API que hizo la petición. |
| `apiKey.name` | string | Nombre dado a la clave cuando se creó. |
| `apiKey.scopes` | string[] | Scopes concedidos a la clave, los que pueden usar sus peticiones. |
| `rateLimits` | object | Límites de uso de la clave, los que informan las cabeceras RateLimit-*. |
| `rateLimits.global` | object | Peticiones por minuto en toda la API. |
| `rateLimits.global.perMinute` | integer |  |
| `rateLimits.availability` | object | Peticiones por minuto de las consultas de disponibilidad, contadas aparte. |
| `rateLimits.availability.perMinute` | integer |  |
| `api` | object | El contrato con el que se sirve a esta cuenta. |
| `api.version` | string | Versión del contrato de la API pública. |
| `api.docsUrl` | string | Dónde está la documentación de esta versión. |

*Llamada · filmo_account_get*

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

*Resultado (generado desde el esquema)*

```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
      }
    }
  }
}
```

## Prompts de ejemplo

*Prompt*

```text
¿A qué cuenta de Filmo estoy conectado y cuáles son su zona horaria y su moneda?
```

## La misma operación por REST

Esta herramienta ejecuta [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/account/filmo-account-get  
Última actualización: 2026-10-25