ChartMogul

Acesse e gerencie dados do ChartMogul, incluindo clientes, planos e análises.

GitHub
8
Experimente este MCPPatrocinado

Documentação

Servidor MCP do ChartMogul

Ferramentas Suportadas

Conta e Fontes de Dados

  • retrieve_account - Obter informações da conta
  • list_sources - Listar todas as fontes de dados com filtragem opcional
  • retrieve_source - Obter fonte de dados específica por UUID

Gerenciamento de Clientes

  • list_customers - Listar clientes com opções de filtragem
  • search_customers - Pesquisar clientes por e-mail
  • retrieve_customer - Obter cliente por UUID
  • create_customer - Criar novo cliente
  • update_customer - Atualizar atributos do cliente
  • list_customer_subscriptions - Obter assinaturas do cliente
  • list_customer_activities - Obter atividades do cliente
  • list_customer_attributes - Obter atributos do cliente
  • add_customer_tags - Adicionar tags ao cliente
  • add_customer_custom_attributes - Adicionar atributos personalizados ao cliente

Contatos

  • list_contacts - Listar todos os contatos
  • retrieve_contact - Obter contato por UUID
  • create_contact - Criar novo contato
  • update_contact - Atualizar informações do contato

Notas do Cliente

  • list_customer_notes - Listar notas e chamadas do cliente
  • retrieve_customer_note - Obter nota específica por UUID
  • create_customer_note - Criar nova nota ou registro de chamada
  • update_customer_note - Atualizar nota existente

Vendas e CRM

  • list_opportunities - Listar oportunidades de vendas
  • retrieve_opportunity - Obter oportunidade por UUID
  • create_opportunity - Criar nova oportunidade
  • update_opportunity - Atualizar detalhes da oportunidade
  • list_tasks - Listar tarefas do cliente
  • retrieve_task - Obter tarefa por UUID
  • create_task - Criar nova tarefa
  • update_task - Atualizar informações da tarefa

Planos

  • list_plans - Listar planos de assinatura
  • retrieve_plan - Obter plano por UUID
  • create_plan - Criar novo plano
  • update_plan - Atualizar detalhes do plano
  • list_plan_groups - Listar grupos de planos
  • retrieve_plan_group - Obter grupo de planos por UUID
  • create_plan_group - Criar novo grupo de planos
  • update_plan_group - Atualizar grupo de planos
  • list_plan_group_plans - Listar planos em um grupo

Análises e Métricas

  • all_metrics - Obter todas as métricas principais (MRR, ARR, ARPA, ASP, contagem de clientes, taxas de churn, LTV)
  • mrr_metrics - Obter métricas de Receita Recorrente Mensal
  • arr_metrics - Obter métricas de Taxa de Execução Anual
  • arpa_metrics - Obter métricas de Receita Média por Conta
  • asp_metrics - Obter métricas de Preço Médio de Venda
  • customer_count_metrics - Obter métricas de contagem de clientes
  • customer_churn_rate_metrics - Obter métricas de taxa de churn de clientes
  • mrr_churn_rate_metrics - Obter métricas de taxa de churn de MRR
  • ltv_metrics - Obter métricas de Valor do Tempo de Vida do Cliente

Operações de Dados

  • list_subscription_events - Listar eventos de assinatura
  • create_subscription_event - Criar novo evento de assinatura
  • update_subscription_event - Atualizar detalhes do evento de assinatura
  • list_invoices - Listar faturas com filtragem
  • import_invoices - Criar nova fatura
  • retrieve_invoice - Obter fatura por UUID
  • list_activities - Listar atividades de negócio (new_biz, expansion, churn, etc.)

Uso

  1. Abra o arquivo de configuração do Claude Desktop localizado em:

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

  2. Adicione o seguinte:

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

  1. Execute which uv para localizar a entrada de comando para uv e substitua-a pelo caminho absoluto para o executável uv.

  2. Reinicie o Claude Desktop para aplicar as alterações.

Desenvolvimento

  1. Execute cp example.env .env na raiz do repositório para criar um arquivo .env.

  2. Atualize-o com as seguintes variáveis de ambiente.

CHARTMOGUL_TOKEN=<YOUR-CHARTMOGUL-TOKEN>

  1. Instale uv seguindo as instruções aqui.

  2. Execute uv sync para instalar as dependências.

  3. Execute source .venv/bin/activate para ativar o ambiente virtual criado.

  4. Execute mcp dev main.py:cm_mcp para iniciar o servidor MCP de desenvolvimento. Este comando exigirá a instalação do Node.js e do npm.

  5. Inspecione e conecte-se ao servidor MCP em http://127.0.0.1:6274