Skip to main content
Glama
elevor-erp360

elevor-erp360

elevor-mcp — MCP server ERP360 / Elevor (DentalInoveh)

MCP server exposing Elevor's ERP360 to an agent/app. Built and live-tested (10/06) against the production installation s6.elevor.cloud/DentalInoveh/ERP360.

There are two APIs in the same ERP, with per-scope tokens (Bearer auth):

Scope

API

Token (.env)

Status

Customers

Commercial /api/v2/Clientes

ELEVOR_TOKEN_CLIENTES

✅ working (4,897 customers)

Orders

Commercial /api/Pedidos/ConsultarPedidos

ELEVOR_TOKEN_PEDIDOS

✅ working (83 orders with items)

Products/Stock

Ren9veCommerce /api/Ren9veCommerce/Produtos*

ELEVOR_TOKEN_PRODUTOS

🟡 auth OK, empty catalog*

* The product token authenticates (200 OK), but the catalog comes back empty until Elevor marks the groups/products for e-commerce in the ERP (production config). Once that is done, produtos_sync will return the catalog without any code changes.

Tools

Tool

Scope

What it does

clientes_list

customers

Lists customers (paginated; filter by date/CPF/CNPJ)

cliente_get

customers

Customer by code

cliente_limite_credito

customers

Credit limit

pedidos_consultar

orders

Queries orders (filters + pagination); returns Customer and Products

produtos_sync

products

Catalog: all | since | changed (delta)

produto_get / estoque_get

products

Product / balance by code (Stock + Grids)

produtos_categorias / produtos_grades

products

Categories / grids

pedido_ecommerce_criar

products

Write: creates order (stock deduction). Requires ELEVOR_ALLOW_WRITES=true

Related MCP server: business-central-mcp-server

Setup

cd ~/elevor-mcp
npm install
cp .env.example .env     # .env já tem os tokens reais (gitignored)
npm run build
node test-live.mjs       # teste read-only contra produção

Register in the MCP client (Claude Desktop / OpenClaw):

{
  "mcpServers": {
    "elevor-erp360": {
      "command": "node",
      "args": ["/Users/barboza/elevor-mcp/dist/index.js"],
      "env": { "ELEVOR_RADICAL_URL": "http://s6.elevor.cloud/DentalInoveh/ERP360" }
    }
  }
}

(tokens are read from .env, or can go in the env block.)

Only pending item: e-commerce config (Elevor)

Meeting with Lucas (Elevor) to configure in the ERP:

  1. Which groups/products go to e-commerce (unlocks the empty catalog).

  2. Exposed price table (Price / Promotion / Cash).

  3. Stock: is Estoque already the sum of the grids? Is there stock by warehouse/branch?

  4. Images via ProdutosImagens. IP allowlist. Who consumes the delta cursor /Produtos.

Full technical details in INTEGRATION_STUDY.md. Swagger saved in erp360-swagger.json.

Available Tools

26 tools
cidades_buscarBuscar cidadesA

Cidades cadastradas no ERP (por descrição).

Inputs: descricao (required).

cliente_arquivosArquivos do clienteC

Arquivos autorizados do cliente (por código/CPF/CNPJ).

Inputs: codCpfCnpj (required).

cliente_atualizarAtualizar clienteB

Atualiza cliente (por Cod). PRODUÇÃO — requer ELEVOR_ALLOW_WRITES=true.

Inputs: cod (required), cliente (required).

cliente_criarCriar clienteC

Cadastra cliente no ERP. PRODUÇÃO — requer ELEVOR_ALLOW_WRITES=true.

Inputs: cliente (required).

cliente_getObter clienteC

Retorna um cliente pelo Cod.

Inputs: cod (required).

cliente_limite_creditoLimite de crédito do clienteA

Consulta o limite de crédito por código/CPF/CNPJ.

Inputs: codCpfCnpj (required).

clientes_listListar clientesA

Lista clientes do ERP (paginado). Exige ao menos um filtro: codCpfCnpj OU uma data (cadastro/alteração). pageTake máx recomendado 100.

Inputs: pageSkip, pageTake, codCpfCnpj, dataCadastroMin, +1 more.

crm_consultar_atividadesCRM consultar atividadesC

Consulta atividades do CRM por filtros.

Inputs: filtros (required).

crm_criar_atividadeCRM criar atividadeC

Cria atividade no CRM. Requer ELEVOR_ALLOW_WRITES=true.

Inputs: atividade (required).

crm_criar_contaCRM criar contaC

Cria/atualiza conta no CRM. Requer ELEVOR_ALLOW_WRITES=true.

Inputs: conta (required).

crm_criar_contatoCRM criar contatoB

Cria contato no CRM. Requer ELEVOR_ALLOW_WRITES=true.

Inputs: contato (required).

crm_loginCRM loginA

Login no CRM (usuario/senha) → token temporário.

Inputs: senha (required), usuario (required).

estoque_getConsultar estoqueC

Saldo de estoque de um produto (Estoque total + Disponivel por variação).

Inputs: cod (required).

pedido_alterar_statusAlterar status do pedidoC

Altera status (AlterarPedido). PRODUÇÃO — requer ELEVOR_ALLOW_WRITES=true.

Inputs: request (required).

pedido_cancelarCancelar pedidoB

Cancela pedido/pré-venda (por id). PRODUÇÃO — requer ELEVOR_ALLOW_WRITES=true.

Inputs: id (required).

pedido_criar_v2Criar pedido V2D

Cria pedido (Ren9veCommerce V2). PRODUÇÃO — requer ELEVOR_ALLOW_WRITES=true.

Inputs: pedido (required).

pedido_ecommerce_criarCriar pedido (e-commerce)B

Cria pedido/pré-venda no ERP via Ren9veCommerce (baixa estoque). PRODUÇÃO — requer ELEVOR_ALLOW_WRITES=true.

Inputs: pedido (required).

pedido_por_dataPedidos por data (e-commerce)B

Pedidos/pré-vendas alterados após dd/MM/yyyy.

Inputs: data (required).

pedidos_consultarConsultar pedidosC

Consulta pedidos com filtros combinados e paginação. Cada pedido traz Cliente e Produtos (itens).

Inputs: pagina, status, codClientes, numeroPedido, +3 more.

pedido_statusStatus do pedidoB

Status + nota fiscal de um pedido (por id/número).

Inputs: id (required).

produto_getObter produtoB

Produto por Cod (com Estoque e Grades).

Inputs: cod (required).

produto_imagensImagens do produtoC

Imagens base64 do produto (por Cod).

Inputs: cod (required).

produtos_categoriasCategorias do e-commerceC

Árvore de grupos/categorias (ProdutosGruposECommerce).

Inputs: no named parameters.

produtos_gradesGrades/variaçõesC

Definições de grade cadastradas.

Inputs: no named parameters.

produtos_syncSincronizar produtosA

Puxa produtos do e-commerce. mode='all' (dump) | 'since' (alterados após since dd/MM/yyyy) | 'changed' (delta — AVANÇA o cursor no servidor). Cada produto traz Estoque e variações (Grades).

Inputs: mode (required), since.

separacao_consultarConsultar separaçãoC

Separação e produtos do pedido (com estoque/lote/validade).

Inputs: pageTake, numeroDocumento.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.5/5.0

    Scored across 26 tools

    Disambiguation2/5

    Several tools overlap: pedido_ecommerce_criar and pedido_criar_v2 both create orders, while pedidos_consultar and pedido_por_data both query orders by filters/date. produto_get includes stock and grades, making it unclear when estoque_get is needed. This is more than just one or two confusing pairs.

    Naming Consistency2/5

    Naming follows no clear convention: cliente_get, clientes_list, pedido_status, pedido_por_data, crm_consultar_atividades, and produtos_sync all use different patterns. It also mixes English and Portuguese verbs in a single toolset, which makes the API feel inconsistent despite the shared domain prefixes.

    Tool Count2/5

    With 26 tools, the count crosses the 25-tool heavy threshold. Although the ERP/CRM domain is broad, several overlapping order and product tools make the set feel larger than necessary and harder to navigate.

    Completeness4/5

    The toolset covers core ERP workflows: customer create/update/read, product and stock retrieval, order lifecycle including create/status/cancel, plus CRM account/contact/activity creation. Minor gaps remain, like product update/delete and CRM read endpoints for contacts, but the main integration flows are usable.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes ERP data (production orders, inventory, BOM, customers) to any MCP client through a backend-neutral interface, with a mock backend for testing.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes Dynamics 365 Business Central data to MCP clients via standard v2.0 API or custom AL APIs, supporting read, write, and destructive operations with multiple authentication modes.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Bling ERP, enabling read and write operations on sales orders, products, contacts, accounts payable/receivable, NF-e, inventory, and more via OAuth 2.0.
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      MCP server that enables AI platforms to search products, customers, and warehouses, and prepare and submit sales orders to a fixed ERP endpoint with per-session bearer authentication.
      -