ChartMogul

Accede y gestiona datos de ChartMogul, incluyendo clientes, planes y análisis.

GitHub
8
Prueba este MCPPatrocinado

Documentación

Servidor MCP de ChartMogul

Herramientas compatibles

Cuenta y fuentes de datos

  • retrieve_account - Obtener información de la cuenta
  • list_sources - Listar todas las fuentes de datos con filtrado opcional
  • retrieve_source - Obtener una fuente de datos específica por UUID

Gestión de clientes

  • list_customers - Listar clientes con opciones de filtrado
  • search_customers - Buscar clientes por correo electrónico
  • retrieve_customer - Obtener cliente por UUID
  • create_customer - Crear nuevo cliente
  • update_customer - Actualizar atributos del cliente
  • list_customer_subscriptions - Obtener suscripciones del cliente
  • list_customer_activities - Obtener actividades del cliente
  • list_customer_attributes - Obtener atributos del cliente
  • add_customer_tags - Añadir etiquetas al cliente
  • add_customer_custom_attributes - Añadir atributos personalizados al cliente

Contactos

  • list_contacts - Listar todos los contactos
  • retrieve_contact - Obtener contacto por UUID
  • create_contact - Crear nuevo contacto
  • update_contact - Actualizar información del contacto

Notas del cliente

  • list_customer_notes - Listar notas y llamadas del cliente
  • retrieve_customer_note - Obtener nota específica por UUID
  • create_customer_note - Crear nueva nota o registro de llamada
  • update_customer_note - Actualizar nota existente

Ventas y CRM

  • list_opportunities - Listar oportunidades de venta
  • retrieve_opportunity - Obtener oportunidad por UUID
  • create_opportunity - Crear nueva oportunidad
  • update_opportunity - Actualizar detalles de la oportunidad
  • list_tasks - Listar tareas del cliente
  • retrieve_task - Obtener tarea por UUID
  • create_task - Crear nueva tarea
  • update_task - Actualizar información de la tarea

Planes

  • list_plans - Listar planes de suscripción
  • retrieve_plan - Obtener plan por UUID
  • create_plan - Crear nuevo plan
  • update_plan - Actualizar detalles del plan
  • list_plan_groups - Listar grupos de planes
  • retrieve_plan_group - Obtener grupo de planes por UUID
  • create_plan_group - Crear nuevo grupo de planes
  • update_plan_group - Actualizar grupo de planes
  • list_plan_group_plans - Listar planes en un grupo

Analítica y métricas

  • all_metrics - Obtener todas las métricas clave (MRR, ARR, ARPA, ASP, número de clientes, tasas de abandono, LTV)
  • mrr_metrics - Obtener métricas de ingresos recurrentes mensuales
  • arr_metrics - Obtener métricas de tasa de ejecución anual
  • arpa_metrics - Obtener métricas de ingresos promedio por cuenta
  • asp_metrics - Obtener métricas de precio de venta promedio
  • customer_count_metrics - Obtener métricas de número de clientes
  • customer_churn_rate_metrics - Obtener métricas de tasa de abandono de clientes
  • mrr_churn_rate_metrics - Obtener métricas de tasa de abandono de MRR
  • ltv_metrics - Obtener métricas de valor de vida del cliente

Operaciones de datos

  • list_subscription_events - Listar eventos de suscripción
  • create_subscription_event - Crear nuevo evento de suscripción
  • update_subscription_event - Actualizar detalles del evento de suscripción
  • list_invoices - Listar facturas con filtrado
  • import_invoices - Crear nueva factura
  • retrieve_invoice - Obtener factura por UUID
  • list_activities - Listar actividades comerciales (new_biz, expansion, churn, etc.)

Uso

  1. Abra el archivo de configuración de Claude Desktop ubicado en:

    • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • En Windows: %APPDATA%/Claude/claude_desktop_config.json

  2. Añada lo siguiente:

{
  "mcpServers": {
    "mcp-chartmogul": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/local/chartmogul-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "CHARTMOGUL_TOKEN": "<YOUR-CHARTMOGUL-TOKEN>"
      }
    }
  }
}

  1. Ejecute which uv para localizar la entrada de comando para uv y reemplácela con la ruta absoluta al ejecutable de uv.

  2. Reinicie Claude Desktop para aplicar los cambios.

Desarrollo

  1. Ejecute cp example.env .env en la raíz del repositorio para crear un archivo .env.

  2. Actualícelo con las siguientes variables de entorno.

CHARTMOGUL_TOKEN=<YOUR-CHARTMOGUL-TOKEN>

  1. Instale uv siguiendo las instrucciones aquí.

  2. Ejecute uv sync para instalar las dependencias.

  3. Ejecute source .venv/bin/activate para activar el entorno virtual creado.

  4. Ejecute mcp dev main.py:cm_mcp para iniciar el servidor MCP de desarrollo. Este comando requerirá la instalación de Node.js y npm.

  5. Inspeccione y conéctese al servidor MCP en http://127.0.0.1:6274