Skip to main content
Glama

TOTVS Protheus

Server Details

TOTVS Protheus ERP for AI: stock, sales, orders, customers and MRP. Read-only, official API.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
95.7% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
mcp-dir/protheus-mcp
GitHub Stars
0
Server Listing
TOTVS Protheus MCP
ChatGPT
–
Claude
–

TDQS

B3.1/5.0

Scored across 32 tools

Disambiguation3/5

The many protheus_* tools are mostly distinct by entity, but the platform/admin tools overlap: marketplace bundles list_tools, report_bug, and install capabilities alongside separate report_bug and toolkit_info tools. The catalogo/diagnostico/api trio also requires careful reading, and several 'list or get by id' Protheus tools are easy to confuse at a glance.

Naming Consistency3/5

Domain tools mostly follow a predictable protheus_<entity> pattern, with protheus_list_accounts as a notable outlier and module-qualified names like protheus_compras_mrp and protheus_ordens_producao. The six platform tools break the pattern entirely, mixing bare nouns, imperative verbs, and noun_info names, so the overall naming style is inconsistent.

Tool Count2/5

32 tools is heavy, especially because six are platform-management utilities and marketplace is an oversized multi-action meta-tool. The Protheus entity wrappers are individually reasonable, but the set would be much tighter with fewer admin tools and consolidated or more deliberately scoped Protheus endpoints.

Completeness3/5

Read coverage is broad: dedicated wrappers plus protheus_catalogo, protheus_diagnostico, and protheus_api allow discovery and access to any official read-only REST route. However, every Protheus tool is read-only—there are no create, update, or delete operations—so any mutation workflow dead-ends unless handled through the generic marketplace tool.

Available Tools

32 tools
authenticateA
Idempotent
Inspect

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header Authorization: Bearer <token> for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "" } after the user pastes, or with no args to get the link.

Inputs: token.

connectA
Read-onlyIdempotent
Inspect

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Inputs: no named parameters.

marketplaceAInspect

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/ link that opens without login.

Inputs: limit, query, action, mcp_id, +19 more.

protheus_apiA
Read-onlyIdempotent
Inspect

Faz 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 a empresa criou. Somente leitura.

Inputs: path (required), page, order, expand, +6 more.

protheus_centros_custoA
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_clientes_fornecedoresA
Read-onlyIdempotent
Inspect

Consulta 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.

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, tipo, +8 more.

protheus_comissoesB
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_compras_mrpA
Read-onlyIdempotent
Inspect

Consulta 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ífico.

Bulk support: accepts branch_ids for batched execution.

Inputs: page, tipo, order, codigo, +9 more.

protheus_condicoes_pagamentoB
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_contatosB
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_diagnosticoA
Read-onlyIdempotent
Inspect

Descobre 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 primeiro numa conta nova: a TOTVS publica 125 APIs para a linha Protheus, mas cada instalação expõe um subconjunto, conforme a versão da LIB, os módulos licenciados e as customizações.

Inputs: limit, termo, account.

protheus_estoqueB
Read-onlyIdempotent
Inspect

Consulta 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 distintos e podem divergir.

Inputs: page, fonte, order, expand, +6 more.

protheus_filiaisA
Read-onlyIdempotent
Inspect

Lista 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.

Inputs: page, order, expand, fields, +5 more.

protheus_limite_creditoB
Read-onlyIdempotent
Inspect

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

Bulk support: accepts cliente_ids for batched execution.

Inputs: page, order, expand, fields, +7 more.

protheus_list_accountsB
Read-onlyIdempotent
Inspect

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

Inputs: account.

protheus_modulosB
Read-onlyIdempotent
Inspect

Lista 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.

Inputs: page, order, expand, fields, +5 more.

protheus_notas_totaisB
Read-onlyIdempotent
Inspect

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

Inputs: page, tipo, order, expand, +7 more.

protheus_oportunidadesB
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_ordens_producaoA
Read-onlyIdempotent
Inspect

Consulta 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.

Bulk support: accepts branch_ids for batched execution.

Inputs: page, order, codigo, expand, +8 more.

protheus_parametrosC
Read-onlyIdempotent
Inspect

Consulta os parâmetros de sistema do Protheus.

Inputs: page, order, expand, fields, +5 more.

protheus_pedidos_varejoB
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_produtosB
Read-onlyIdempotent
Inspect

Consulta 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, não duas visões do mesmo.

Inputs: page, fonte, order, expand, +6 more.

protheus_propostas_comerciaisA
Read-onlyIdempotent
Inspect

Lista 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.

Bulk support: accepts oportunidade_ids, ids for batched execution.

Inputs: oportunidade_id (required), id, ids, page, +9 more.

protheus_tabela_precosA
Read-onlyIdempotent
Inspect

Consulta 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.

Inputs: page, itens, order, codigo, +7 more.

protheus_transportadorasA
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_usuariosA
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_vendas_varejoB
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

protheus_vendedoresB
Read-onlyIdempotent
Inspect

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

Bulk support: accepts ids for batched execution.

Inputs: id, ids, page, order, +7 more.

report_bugA
Idempotent
Inspect

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Inputs: message (required), context, conversation.

show_versionA
Read-onlyIdempotent
Inspect

Show the current MCP platform and adapter versions.

Inputs: no named parameters.

toolkit_infoA
Read-onlyIdempotent
Inspect

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP connector for querying the Protheus (TOTVS) system, exposing 10 GET endpoints as MCP tools with OAuth2 authentication and friendly error handling.
      10
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Read-only MCP server for Omie ERP, enabling AI assistants to query financial data, accounts payable/receivable, bank reconciliation, invoices, and movements via natural language.
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying products and stock, sales orders, contacts, invoices, payables/receivables, and creating contacts through the official ERP API.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP server for Dynamics 365 Business Central, enabling AI clients to query live ERP data like customers, items, orders, and invoices via GET-only APIs with dual authentication and stdio/HTTP transports.
      10
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.