# Informes y gráficos

> Ocho herramientas MCP de solo consulta para ver cómo va la comunidad y convertirlo en un gráfico o una tabla en la conversación — ventas, suscripciones y MRR, miembros activos, interacción y ranking, eventos, cursos, la actividad de un miembro y el panel del mes — con recetas listas.

Pregúntale al asistente cómo van las ventas, quién participa más o qué hizo una persona, y te responde con números y, si quieres, con un gráfico o una tabla en la propia conversación (en Claude, como un artefacto). Las ocho herramientas de esta página solo consultan: ninguna cambia nada en la comunidad.

## En resumen

| Herramienta | Qué hace | Rol mínimo | Tipo |
|---|---|---|---|
| [`sales_report`](#sales-report) | Ventas por día, semana o mes, por plan, producto o forma de pago, y el total desde la primera venta | Administrador o finanzas | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`subscriptions_report`](#subscriptions-report) | MRR, suscripciones nuevas y canceladas, churn, cortesías y downsell | Administrador o finanzas | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`members_report`](#members-report) | Miembros nuevos, activos e inactivos, por grupo y por etiqueta | Moderador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`engagement_report`](#engagement-report) | Posts, comentarios, reacciones, quién participa más, posts sin respuesta y los puntos del ranking | Moderador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`events_report`](#events-report) | Eventos y cuántos respondieron voy, quizás y no voy | Moderador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`courses_report`](#courses-report) | Matrículas, cursos completados y progreso por curso | Moderador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`member_activity`](#member-activity) | Qué hizo una persona: recuentos, puntos del ranking y enlaces | Administrador | <span class="tool-kind tool-kind-read">Solo consulta</span> |
| [`community_overview`](#community-overview) | Este mes frente al mes pasado, en una sola petición | Moderador o finanzas | <span class="tool-kind tool-kind-read">Solo consulta</span> |

**Quién ve qué.** El dinero (ventas y suscripciones) es del propietario, del administrador y de **finanzas**. La comunidad (miembros, interacción, eventos y cursos) es del propietario, del administrador y del **moderador**. La actividad de una persona concreta es solo del propietario y del administrador. En `community_overview`, cada uno ve solo el bloque de su área: finanzas ve el dinero, el moderador ve la comunidad.

## Cómo llegan las respuestas

Toda respuesta viene lista para convertirse en un gráfico:

| Parte | Qué es |
|---|---|
| `series` | Una fila por periodo (`period`), con los números de ese periodo. Los periodos sin nada aparecen con cero, para que el gráfico no se salte un mes |
| `totals` | La suma del intervalo pedido |
| `currency` | La moneda de los importes (una por consulta; por defecto, la moneda en la que más vende la comunidad) |
| `timezone` | La zona horaria usada para contar los días |

Parámetros comunes:

| Parámetro | Valores | Por defecto |
|---|---|---|
| `interval` | `day`, `week` (empieza el lunes) o `month` | `month` |
| `from`, `to` | Fechas `AAAA-MM-DD`, incluidas. Se amplían hasta el inicio y el fin del periodo: con `month`, el 15/03 pasa a ser el 01/03 | 30 días, 12 semanas o 12 meses hasta hoy |
| `timezone` | Una zona horaria como `America/Sao_Paulo` | La zona horaria del país de la comunidad |

Una consulta abarca como máximo 366 días, 156 semanas o 120 meses. Para un periodo más largo, usa un intervalo mayor.

**Qué significa cada número:**

- Las **ventas** salen del [extracto](/pagamentos/saldo-e-extrato): el neto del informe es el neto del extracto en el mismo periodo. La única comisión que aparece es la [comisión de la plataforma](/pagamentos/taxa-da-plataforma), que no depende del método de pago.
- El **MRR** es el ingreso recurrente mensual: cada suscripción de pago convertida al mes (la anual dividida entre 12). Las cortesías y las suscripciones en prueba quedan fuera.
- **Activo** es quien hizo al menos una cosa en el periodo: publicó, comentó, reaccionó, respondió a un evento (voy o quizás), se matriculó o estudió en un curso, o ganó puntos en el ranking (lo que incluye el inicio de sesión diario, cuando el ranking está activado). Solo leer no cuenta, porque las visualizaciones no se registran.
- La **asistencia a eventos** no existe: Memberfy guarda la respuesta de cada persona (voy, quizás, no voy), no quién asistió. El informe lo indica (`attendanceTracked: false`).

## `sales_report`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Informe de ventas.** Por periodo: bruto, comisión de la plataforma, intereses de las cuotas, neto, número de ventas, ticket medio, reembolsos y contracargos (por separado), y el neto después de ellos. Incluye también los retiros solicitados y completados y el total desde la primera venta. *Rol mínimo: administrador o finanzas.*

Parámetros: los comunes, más `group_by` (`product`, `plan`, `payment_method` o `product_type`) y `currency`.

**Devuelve:** `series`, `totals`, `allTime` (desde siempre), `payouts` y, con `group_by`, `groups`: cada plan, producto o forma de pago con su propia serie. Una venta que no pertenece a ningún plan cae en el grupo sin nombre.

**Pídelo así:** *"¿Cuánto he ganado en total desde que empecé a vender?"*

**Después:** la respuesta sugiere, en `next_steps`, el mismo informe del periodo inmediatamente anterior, con las fechas listas, para comparar. Ver [Próximos pasos](/mcp/ferramentas#proximos-pasos).

## `subscriptions_report`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Informe de suscripciones.** Por periodo: MRR, suscripciones de pago, nuevas, canceladas, churn (el porcentaje de las que estaban activas al principio del periodo y se cancelaron), en prueba y cortesías. *Rol mínimo: administrador o finanzas.*

Parámetros: los comunes, más `currency`.

**Devuelve:** `series`, `totals`, la foto de hoy en `current` (MRR, ARR, por estado, cuántas terminarán al final del periodo, vencidas, cortesías), `byPlan` y `downsell` (ofertas de última oportunidad mostradas y aceptadas).

**Pídelo así:** *"¿Cómo ha evolucionado el MRR este año? ¿Cuál fue el churn de cada mes?"*

> [!NOTE]
> El histórico se reconstruye a partir de las fechas de inicio y de fin de cada suscripción. Un retraso que ya se resolvió o una pausa no dejan fecha, así que solo aparecen en la foto de hoy.

## `members_report`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Informe de miembros.** Por periodo: cuántos entraron, cuántos estaban activos, el total al final del periodo y los inactivos. *Rol mínimo: moderador.*

Parámetros: los comunes.

**Devuelve:** `series`, `totals`, `current` (total, activos e inactivos en los últimos 30 días, por rol), `byGroup` y `byTag`.

**Pídelo así:** *"¿Cuántos miembros nuevos tuvimos por semana en el último trimestre, y cuántos estaban activos?"*

## `engagement_report`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Informe de interacción y ranking.** Por periodo: posts del feed, contenidos, comentarios, reacciones, miembros activos y puntos del ranking. Muestra también dónde ocurre la conversación, quién participó más, los posts que nadie respondió y los datos que forman el [ranking](/espacos/ranking). *Rol mínimo: moderador.*

Parámetros: los comunes, más `order_by` (`points`, `interactions`, `posts`, `comments` o `reactions`; por defecto `points` con el ranking activado), `page` y `limit` (hasta 100).

**Devuelve:** `series`, `totals`, `bySpace`, `members` (paginado: posts, comentarios, reacciones, interacciones, puntos en el periodo y el nivel de hoy), `unansweredPosts` y `ranking` (las reglas de puntos, los puntos por acción y por periodo, y cuántos miembros hay en cada nivel).

**Pídelo así:** *"¿Quiénes son los 10 que más participaron este mes? ¿Y qué acciones dieron más puntos?"*

## `events_report`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Informe de eventos.** Por periodo: los eventos que se celebraron y las respuestas recibidas. Por evento: cuántos dijeron voy, quizás y no voy, con el enlace. *Rol mínimo: moderador.*

Parámetros: los comunes, más `page` y `limit`.

**Devuelve:** `series`, `totals` y `events`. La asistencia no se registra, y el asistente lo dice si preguntas quién asistió.

**Pídelo así:** *"¿Cuántas personas confirmaron en cada evento de este semestre?"*

## `courses_report`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Informe de cursos.** Por periodo: matrículas, cursos completados y lecciones completadas. Por curso: matrículas, completados, tasa de finalización y el progreso medio de los matriculados. *Rol mínimo: moderador.*

Parámetros: los comunes, más `page` y `limit`.

**Devuelve:** `series`, `totals` y `courses`, con el enlace de cada curso.

**Pídelo así:** *"¿Qué curso tiene la tasa de finalización más baja?"*

## `member_activity`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Actividad de un miembro.** Lo que una persona hizo en la comunidad, en el periodo y desde siempre: posts, comentarios, reacciones, respuestas a eventos, matrículas, compras, suscripciones, cursos completados y certificados. Incluye los puntos del ranking por acción, el nivel y la posición, y los elementos recientes con enlace. *Rol mínimo: administrador.*

Parámetros: `member` (el id del perfil, de `list_members`, el correo o el enlace del perfil copiado de la app) y los comunes. Para la línea de tiempo de todo lo que hizo la persona, con fecha y hora, usa [`list_activity_logs`](/mcp/ferramentas-membros#list-activity-logs).

**Devuelve:** `counts`, `ranking` y `recent`. De las compras, solo el importe pagado y la forma de pago. No hay registro de navegación: el informe muestra lo que la persona hizo, no lo que vio.

**Pídelo así:** *"¿Qué hizo maria.silva@memberfy.net en la comunidad en los últimos 3 meses?"*

## `community_overview`

<span class="tool-kind tool-kind-read">Solo consulta</span>

**Panel general de la comunidad.** Este mes hasta ahora frente al mes pasado completo y frente al mes pasado hasta el mismo día: ingresos y MRR, miembros nuevos, interacción y los eventos de los próximos 30 días. *Rol mínimo: moderador o finanzas; cada uno ve el bloque de su área.*

Parámetros: `timezone`.

**Devuelve:** `money` (para propietario, administrador y finanzas) y `community` (para propietario, administrador y moderador).

**Pídelo así:** *"¿Cómo va el mes en comparación con el anterior?"*

## Recetas

### Gráfico de ingresos por mes por plan

**Para quién:** propietario, administrador o finanzas.

> Haz un gráfico de barras apiladas de los ingresos netos mes a mes en 2026, un color por plan, y debajo una tabla con el total de cada plan y el ticket medio.

| # | Herramienta | Qué hace |
|---|---|---|
| 1 | `sales_report` | `interval: month`, `from: 2026-01-01`, `to: 2026-12-31`, `group_by: plan` |

**Resultado:** el gráfico y la tabla en la conversación. Cada plan en `groups` ya viene con la serie completa, con cero en los meses sin ventas. Para ver también los reembolsos, pide *"y una línea con los reembolsos"*.

### Los 10 que más participan

**Para quién:** propietario, administrador o moderador.

> ¿Quiénes fueron los 10 miembros que más participaron en los últimos 30 días? Muéstralo en una tabla con posts, comentarios, reacciones, puntos y nivel, y dime qué acciones dieron más puntos.

| # | Herramienta | Qué hace |
|---|---|---|
| 1 | `engagement_report` | `interval: day`, `limit: 10`, `order_by: points` |

**Resultado:** la tabla con los 10 primeros y un resumen de `ranking.byAction`. Con el ranking desactivado, pide `order_by: interactions`. Para ver el detalle de una persona de la lista, sigue con `member_activity`.

### Resumen de la semana

**Para quién:** cualquier rol del equipo. Finanzas recibe solo la parte del dinero; el moderador, solo la de la comunidad.

> Haz el resumen de la semana: ventas y suscripciones nuevas, miembros nuevos, quién participó más, los posts que se quedaron sin respuesta y los próximos eventos con cuántos confirmaron. Termina con tres sugerencias de qué hacer.

| # | Herramienta | Qué hace |
|---|---|---|
| 1 | `community_overview` | El mes hasta ahora, para dar contexto |
| 2 | `sales_report` | `interval: day`, los últimos 7 días |
| 3 | `engagement_report` | `interval: day`, los últimos 7 días, `limit: 5` |
| 4 | `events_report` | De la semana que viene en adelante |

**Resultado:** el resumen en la conversación. Si quieres publicarlo, pide *"escribe un post con esto para el Feed y enséñamelo antes"*: el asistente usa `create_post` después de tu visto bueno.

## Relacionados

- [Herramientas](/mcp/ferramentas)
- [Recetas](/mcp/receitas)
- [Herramientas · Finanzas](/mcp/ferramentas-financeiro)
- [Seguridad y límites](/mcp/seguranca)