novacrm-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOVACRM_API_KEY | Yes | Sua chave de API do NovaCRM (produção `ncrm_live.…` ou sandbox `ncrm_test.…`). Gere em Console da API → Chaves de API. A chave define os escopos de leitura/escrita disponíveis para a IA. | |
| NOVACRM_BASE_URL | No | URL base da API v1 do NovaCRM. Para apontar para o sandbox use https://sandbox.novacrm.com.br/api/v1 com uma chave ncrm_test.… | https://console.novacrm.com.br/api/v1 |
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": false
} |
| prompts | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| novacrm_pingA | Testa a conectividade e a autenticação da chave de API com o NovaCRM. Use antes de qualquer outra ferramenta para validar a configuração. |
| novacrm_get_metricsB | Resumo analítico da loja: faturamento pago, ticket médio, pedidos por status, total de clientes e produtos. |
| novacrm_get_store_visitsA | Acessos à loja pública nos últimos 30 dias (dados anônimos agregados): visitantes únicos, visualizações da vitrine, produtos mais vistos, sacolas abertas, taxa de checkout, série diária, dispositivos e origem do tráfego. |
| novacrm_list_clientsB | Lista clientes da loja com paginação. |
| novacrm_get_clientB | Obtém os detalhes de um cliente específico pelo ID. |
| novacrm_create_clientC | Cadastra um novo cliente na loja. |
| novacrm_update_clientC | Atualiza dados de um cliente existente (envie apenas os campos a alterar). |
| novacrm_import_clientsB | Importa clientes em lote (até 500 por chamada) — ideal para migração de dados de outro sistema. |
| novacrm_list_productsB | Lista produtos do catálogo da loja com paginação. |
| novacrm_get_productC | Obtém os detalhes de um produto específico pelo ID. |
| novacrm_create_productC | Cadastra um novo produto no catálogo da loja. |
| novacrm_update_productC | Atualiza dados, preço ou estoque de um produto existente (envie apenas os campos a alterar). |
| novacrm_delete_productA | Remove um produto do catálogo. Por padrão arquiva (reversível); com permanent=true exclui definitivamente (exige escopo dangerous:delete). |
| novacrm_inventory_alertsA | Lista produtos em estoque baixo (abaixo do limite informado ou de 5 unidades). |
| novacrm_adjust_stockC | Ajusta o estoque de um produto com registro de movimentação (entrada/saída). |
| novacrm_list_ordersB | Lista pedidos da loja, com filtro opcional por status e paginação. |
| novacrm_get_orderA | Obtém os detalhes de um pedido específico (itens, cliente, endereço e pagamento). |
| novacrm_create_orderC | Registra um novo pedido para a loja. |
| novacrm_update_order_statusC | Atualiza o status de um pedido (ex.: marcar como pago, em processamento ou concluído). |
| novacrm_cancel_orderC | Cancela um pedido informando o motivo. |
| novacrm_list_couponsB | Lista os cupons de desconto da loja. |
| novacrm_create_couponC | Cria um cupom de desconto. |
| novacrm_validate_couponC | Valida um cupom para um determinado subtotal e calcula o desconto. |
| novacrm_get_storeA | Obtém as informações públicas da loja (nome, descrição, WhatsApp, tema, horários). |
| novacrm_update_storeC | Atualiza informações da loja (envie apenas os campos a alterar). |
| novacrm_set_store_statusC | Abre/fecha a loja ou publica/despublica a vitrine. |
| novacrm_list_webhooksB | Lista os webhooks configurados na loja. |
| novacrm_create_webhookA | Cria um webhook para receber notificações de eventos da loja em uma URL HTTPS. O signing secret é exibido apenas uma vez na resposta. |
| novacrm_list_automationsA | Lista as regras de automação da loja (gatilhos e ações). Use includeArchived para ver cópias arquivadas pela revisão de duplicatas. |
| novacrm_get_automationA | Obtém uma regra de automação pelo ID, com condição, ação e estatísticas de execução. |
| novacrm_create_automationB | Cria uma regra de automação: quando um gatilho ocorre (ex: order_paid), executa uma ação (ex: criar tarefa de follow-up). |
| novacrm_update_automationC | Atualiza uma regra de automação existente (envie apenas os campos a alterar). |
| novacrm_delete_automationB | Exclui permanentemente uma regra de automação. |
| novacrm_list_tasksB | Lista tarefas da agenda comercial com filtro por status e paginação. |
| novacrm_get_taskA | Obtém uma tarefa pelo ID, com cliente vinculado e datas. |
| novacrm_create_taskC | Cria uma tarefa na agenda comercial (follow-up, ligação, reunião, e-mail…). |
| novacrm_update_taskC | Atualiza uma tarefa existente (envie apenas os campos a alterar). |
| novacrm_complete_taskB | Marca uma tarefa como concluída e registra a data de conclusão. |
| novacrm_delete_taskB | Exclui permanentemente uma tarefa. |
| novacrm_list_proposalsB | Lista propostas comerciais com filtro por status e paginação. |
| novacrm_get_proposalA | Obtém uma proposta pelo ID, com cliente, itens e totais. |
| novacrm_create_proposalC | Cria uma proposta comercial. subtotal e total são calculados automaticamente a partir dos itens quando omitidos. |
| novacrm_update_proposalC | Atualiza uma proposta existente, incluindo mudança de status (ex: sent, approved, rejected). |
| novacrm_delete_proposalC | Exclui permanentemente uma proposta. |
| novacrm_list_opportunitiesA | Lista oportunidades do pipeline de vendas com filtro por estágio e paginação. |
| novacrm_get_opportunityA | Obtém uma oportunidade pelo ID, com cliente, valor e estágio. |
| novacrm_create_opportunityC | Cria uma oportunidade (negócio) no pipeline de vendas. |
| novacrm_move_opportunityB | Move uma oportunidade de estágio no funil (lead → contact → proposal → negotiation → won/lost). Ganho ajusta a probabilidade para 100; perdido zera e aceita motivo da perda. |
| novacrm_update_opportunityC | Atualiza uma oportunidade existente (envie apenas os campos a alterar). |
| novacrm_delete_opportunityB | Exclui permanentemente uma oportunidade do pipeline. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| resumo_diario_loja | Briefing executivo da loja: faturamento, pedidos pendentes e alertas de estoque. |
| auditoria_estoque | Audita o catálogo e identifica produtos esgotados ou com estoque crítico, com plano de reposição. |
| analise_trafego_loja | Analisa o tráfego da loja pública nos últimos 30 dias: visitantes, origens, dispositivos, produtos mais vistos e taxa de checkout. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 50 tools
Most tools map cleanly to a resource+action, but several pairs overlap: novacrm_update_product explicitly updates stock while novacrm_adjust_stock exists for stock movement, novacrm_update_opportunity can plausibly change stage while novacrm_move_opportunity is the dedicated stage-mover, and novacrm_update_store overlaps with novacrm_set_store_status for open/closed and published state. Descriptions partially disambiguate, but an agent can still easily pick the wrong tool for a stage change, stock edit, or store status toggle.
The novacrm_ prefix plus verb_noun pattern (list_clients, get_order, create_task, update_proposal, delete_coupon-style) is applied across nearly all 50 tools. Minor deviations exist: novacrm_ping has no verb_noun form and novacrm_inventory_alerts is a bare noun rather than an action, and novacrm_complete_task / novacrm_move_opportunity use verbs outside the standard CRUD set (though still readable).
50 tools is heavy for any single MCP server, but the surface spans many distinct sub-domains (clients, products, orders, coupons, store, webhooks, automations, tasks, proposals, opportunities, analytics), each with only a handful of tools. The count is defensible by domain breadth but sits at the borderline where an agent's tool-selection context becomes unwieldy.
Core entities — clients, products, orders, tasks, automations, proposals, opportunities — have near-full CRUD/lifecycle coverage including delete and lifecycle actions like cancel, complete, and stage moves. Gaps remain: coupons have only list/create/validate (no update/delete) and webhooks have only list/create (no delete/update or rotation), which are minor but real dead ends.