fansly-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DB_PATH | No | Path to the SQLite database file where metrics are stored. | ./fansly_analytics.db |
| HEADLESS | No | Whether to run the browser headlessly (true/false). | true |
| FANSLY_TOKEN | No | Fansly access token (obtain from localStorage session_active_session.token). Used to authenticate API requests. Optional if you have run `npm run login` to store a session in USER_DATA_DIR. | |
| USER_DATA_DIR | No | Directory containing persistent browser session data from `npm run login`. Used for authentication if FANSLY_TOKEN is not provided. | ./browser_data |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| verificar_sesionA | Comprueba si existe token de sesión (browser_data/ o FANSLY_TOKEN) y reporta el estado de autenticación. |
| obtener_metricas_perfilA | Extrae seguidores, contenido publicado, tiers de suscripción y muros del perfil activo desde /account/me. |
| obtener_reporte_crecimientoB | Genera el reporte comparativo de crecimiento (WoW / MoM) analizando SQLite local. |
| analizar_rendimiento_postsA | Extrae likes, comentarios y propinas de las publicaciones recientes del propio timeline (timelinenew) y las persiste en SQLite. |
| obtener_tendencias_hashtagA | Busca publicaciones propias cuyo contenido incluya el hashtag (contentSearch en timelinenew) y resume interacción acumulada. |
| generar_mapa_calor_horarioA | Extrae las publicaciones del propio timeline y genera una matriz 7x24 con el volumen de publicaciones por hora/día. |
| obtener_top_fansA | Lista los fans con chats activos desde /messaging/groups, el origen de datos real para perfiles que interactúan. |
| analizar_churnA | Mide la cancelación de suscriptores (churn) a partir de los snapshots diarios registrados en SQLite. |
| auditar_promociones_tiersA | Audita tiers de suscripción, precios y planes desde el perfil real (account/me). |
| obtener_flujo_mensajesB | Lista conversaciones (messaging/groups) y agrega propinas recibidas en los mensajes recientes (message). |
| calcular_elasticidad_ppvA | Analiza patrones históricos de compra desde SQLite y sugiere un precio orientativo para PPV. |
| analizar_atribucion_linksA | Analiza qué publicaciones generan más ingresos por propinas desde los datos persistidos en SQLite (post_metrics). |
| auditar_caja_fuerteA | Inspecciona el media publicado en el muro del perfil (mediaoffers/location) identificando tipos de contenido. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| auditar-perfil | Ejecuta las herramientas clave del servidor y resume recomendaciones de monetización. |
| analizar-contenido-rezagado | Inspecciona la caja fuerte y sugiere publicaciones para monetizar. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resumen | Snapshot más reciente de métricas del perfil desde SQLite. |
TDQS
Scored across 13 tools
Most tools have clearly distinct purposes, but a few overlap: analizar_rendimiento_posts, obtener_tendencias_hashtag, and analizar_atribucion_links all analyze post performance from slightly different angles. Descriptions help, but some tools could be confused without careful reading.
All 13 tools use a consistent verb_noun pattern (verificar_sesion, obtener_metricas_perfil, analizar_rendimiento_posts, etc.). The verbs vary (obtener, analizar, generar, auditar, calcular) but follow a predictable structure, making the set easy to navigate.
With 13 tools, the server is well-scoped for a Fansly analytics suite. Each tool covers a distinct aspect of analytics (profile, posts, fans, churn, PPV, content), and the count falls comfortably within the ideal 3-15 range without feeling excessive.
The server provides broad coverage of analytics: session check, profile metrics, growth, post performance, hashtag trends, time heatmap, top fans, churn, tier audit, message flow, PPV pricing, attribution, and content audit. Minor gaps exist, such as no tool to refresh all data at once or to directly set PPV prices, but these are workable around.