Question 1

What is TOTVS Protheus MCP?

Accepted Answer

It's an MCP (Model Context Protocol) server that connects TOTVS Protheus to your AI, giving the agent tools to act on your data, through a single remote link.

Question 2

Which AI clients does it work with?

Accepted Answer

Any MCP-compatible client: Claude (web, desktop and mobile), Cursor, ChatGPT with connectors, OpenClaw and other agents.

Question 3

Do I need to code?

Accepted Answer

No. Paste the remote URL into your client, authenticate once, and you're done. No packages to install, no code to write.

Question 4

Is it secure? Can the AI change my data?

Accepted Answer

Access is authorized by you and can be revoked anytime. Permissions follow what TOTVS Protheus exposes; you approve them when connecting.

Question 5

Is my customers' data stored on mcp.ai?

Accepted Answer

No. Whatever TOTVS Protheus returns passes through our infrastructure solely to reach the AI assistant you chose, and that content is not stored. By design we don't persist tool-call payloads: the log keeps metadata only (which tool, timestamp, status, duration, size and a hash of the arguments). Your credentials are stored encrypted and you can revoke the connection at any time. Retention periods and details are in the Privacy Policy at mcp.ai/privacy.

Question 6

Is my data used to train AI models?

Accepted Answer

No. Nothing that flows through the connector is used to train or improve AI models, nor shared with third parties for that purpose. The conversation itself, meaning your prompts and the AI's answers, is processed by the AI provider you choose (Claude, ChatGPT and the like), under their own privacy policy.

Question 7

How much does it cost?

Accepted Answer

You start free and upgrade when you need more usage. Billing and limits are managed in your mcp.ai account.

Question 8

Can I cancel anytime?

Accepted Answer

Yes. Plans are monthly and can be cancelled at any time, with no lock-in.

TOTVS Protheus

Tools (26)

API & agent docs

Guides and tutorials

Como oferecer um MCP dentro do seu produto

Cada usuário do seu app com o MCP dele

Frequently asked questions

Example prompts

TOTVS Protheus

Tools (26)

protheus_apiFaz um GET em qualquer rota REST da instalação Protheus conectada. Use para as APIs oficiais que não têm tool dedicada (descubra a rota com protheus_catalogo) e para os endpoints MVC customizados que

protheus_catalogoConsulta o catálogo das 125 APIs REST oficiais da linha Protheus (id, título, módulo e rotas de leitura), extraído da documentação pública da TOTVS. Serve para descobrir qual rota passar em protheus_a

protheus_centros_custoLista os centros de custo da contabilidade, ou consulta um pelo id interno.

protheus_clientes_fornecedoresConsulta o cadastro de clientes e fornecedores (API CustomerVendor). Sem filtro traz a coleção inteira; `tipo` separa a entidade e, junto com `id`, traz um registro específico.

protheus_comissoesConsulta as comissões de venda, ou uma comissão pelo id interno.

protheus_compras_mrpConsulta os pedidos de compra ou as solicitações de compra do MRP. Aceita filtros da API em `params` (branchId, product, deliveryDate, warehouse). Com `branch_id` e `codigo` traz um registro específic

protheus_condicoes_pagamentoLista as condições de pagamento cadastradas, ou consulta uma pelo id interno.

protheus_contatosLista os contatos do CRM, ou consulta um contato por id.

protheus_diagnosticoDescobre quais APIs REST esta instalação Protheus realmente responde. Sonda cada API do catálogo oficial com uma consulta mínima e classifica em disponivel, ausente, sem_permissao ou erro. Rode isto p

protheus_estoqueConsulta o saldo em estoque. Escolha a fonte: varejo (saldo em estoque do varejo) ou mrp (estoque do MRP, com armazém, lote e saldos bloqueado, consignado e em controle de qualidade). São módulos dist

protheus_filiaisLista as empresas e filiais do grupo (API TSIBranches). É o ponto de partida prático: os códigos de empresa e filial daqui alimentam o header tenantId da conexão e os filtros branchId das demais tools

protheus_limite_creditoConsulta o limite de crédito dos clientes. Com `cliente_id` traz o limite de um cliente específico.

protheus_list_accountsLista as instalações Protheus conectadas a este install, com id e label (host/usuário).

protheus_modulosLista os módulos do sistema Protheus nesta instalação. Indica o que está ativo e ajuda a explicar por que uma API responde ou não.

protheus_notas_totaisConsulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.

protheus_oportunidadesLista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno.

protheus_ordens_producaoConsulta as ordens de produção do MRP. Aceita filtros da própria API em `params` (branchId, product, warehouse, deliveryDate, startDate). Com `branch_id` e `codigo` traz uma ordem específica.

protheus_parametrosConsulta os parâmetros de sistema do Protheus.

protheus_pedidos_varejoLista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido.

protheus_produtosConsulta o cadastro de produtos. O Protheus expõe produto por módulo, então escolha a fonte: varejo (API de produtos do varejo) ou mrp (produto do planejamento de manufatura). São cadastros diferentes

protheus_propostas_comerciaisLista as propostas comerciais de uma oportunidade, ou consulta uma proposta específica. No Protheus a proposta vive dentro da oportunidade, então `oportunidade_id` é obrigatório.

protheus_tabela_precosConsulta as tabelas de preço. Sem argumentos lista os cabeçalhos; com `codigo` traz uma tabela; com `codigo` e `itens` traz os itens e preços dela.

protheus_transportadorasLista as transportadoras cadastradas, ou consulta uma pelo id interno.

protheus_usuariosLista os usuários do Protheus, ou consulta um usuário por id.

protheus_vendas_varejoConsulta as vendas do varejo, ou uma venda pelo id interno. Exige o módulo de varejo publicado nesta instalação.

protheus_vendedoresLista os vendedores cadastrados, ou consulta um vendedor pelo código.