TOTVS Protheus

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Lets an assistant query read-only business data from a company's own TOTVS Protheus ERP installation through its official REST API.

What you can do
Connects to a company's own Protheus installation via the official TOTVS REST API and answers questions in plain language. Tools cover branches and companies, customers and vendors, contacts, sales reps, carriers, cost centers, products, stock balances, price lists, payment terms, commissions, credit limits, retail sales and orders, invoice totals, production orders, and MRP purchase orders and requests. A diagnostic tool maps which REST APIs a given installation actually answers, a catalog tool lists the 125 official Protheus-line APIs, and a wildcard tool issues GET requests to any REST route, including custom endpoints.
When to use it
Useful when an assistant needs to read ERP business data from a specific Protheus installation, for example stock balances, price lists, customer credit limits, sales orders, or production and purchasing data. It is aimed at business data rather than AdvPL development, and it is read-only, so it is not for creating or changing records in the ERP.
Requirements
A remote MCP endpoint over HTTP; no local package or runtime. The company's Protheus REST service must be published and reachable, and the user supplies the REST service URL plus a Protheus user and password. The Protheus user must not have two-factor authentication enabled. Network access to the endpoint is needed.
Before you install
Credentials are supplied: the Protheus REST service URL, user and password, which the service says it stores encrypted and uses only to obtain a transient oAuth2 token. The REST service must be reachable by the platform, so exposure should be restricted by IP or VPN. Data returned by the tools is sent to the chosen LLM host, a sub-processor outside the provider's control. Access is limited to what the Protheus user can already see; the server is independent and not affiliated with TOTVS.

Installation

In SourceWeft

  1. Open TOTVS Protheus in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fprotheus-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "totvs-protheus": {
      "type": "http",
      "url": "https://api.mcp.ai/p_protheus"
    }
  }
}

README

This repository has no README.

Tools

32

protheus_list_accounts

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

Parametersaccount

protheus_diagnostico

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.

Parameterslimittermoaccount

protheus_api

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.

Parameterspagepathrequiredorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_filiais

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.

Parameterspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_modulos

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.

Parameterspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_parametros

Consulta os parâmetros de sistema do Protheus.

Parameterspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_usuarios

Lista os usuários do Protheus, ou consulta um usuário por id. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_clientes_fornecedores

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.

Parametersididspagetipoorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_contatos

Lista os contatos do CRM, ou consulta um contato por id. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_vendedores

Lista os vendedores cadastrados, ou consulta um vendedor pelo código. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_oportunidades

Lista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_propostas_comerciais

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.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filteroportunidade_idrequired+1 more

protheus_tabela_precos

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.

Parameterspageitensordercodigoexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_condicoes_pagamento

Lista as condições de pagamento cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_limite_credito

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.

Parameterspageorderexpandfieldsfilterparamsaccountpage_sizecliente_idsql_filtercliente_ids

protheus_comissoes

Consulta as comissões de venda, ou uma comissão pelo id interno. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_transportadoras

Lista as transportadoras cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_centros_custo

Lista os centros de custo da contabilidade, ou consulta um pelo id interno. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_produtos

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.

Parameterspagefonteorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_estoque

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.

Parameterspagefonteorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_vendas_varejo

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.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_pedidos_varejo

Lista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido. Bulk support: accepts ids for batched execution.

Parametersididspageorderexpandfieldsfilterparamsaccountpage_sizesql_filter

protheus_notas_totais

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

Parameterspagetipoorderexpandfieldsfilterparamsaccountpage_sizecanceladassql_filter

protheus_ordens_producao

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.

Parameterspageordercodigoexpandfieldsfilterparamsaccountbranch_idpage_sizebranch_idssql_filter

protheus_compras_mrp

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.

Parameterspagetipoordercodigoexpandfieldsfilterparamsaccountbranch_idpage_sizebranch_ids+1 more

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

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

Parameterscontextmessagerequiredconversation

connect

Connection Status

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.

Takes no parameters.

toolkit_info

Toolkit Info

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

Takes no parameters.

marketplace

Marketplace

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/<slug> link that opens without login.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

Authenticate

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: "<jwt>" } after the user pastes, or with no args to get the link.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.