MCP server

TOTVS Protheus

io.github.mcp-dir/protheus-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

32

Token cost

About 6,771 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http protheus-mcp https://api.mcp.ai/p_protheus

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.protheus-mcp]
url = "https://api.mcp.ai/p_protheus"

Gemini CLI

{"mcpServers":{"protheus-mcp":{"httpUrl":"https://api.mcp.ai/p_protheus"}}}

Cursor

{"mcpServers":{"protheus-mcp":{"url":"https://api.mcp.ai/p_protheus"}}}

VS Code

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

Antigravity

agy mcp add protheus-mcp https://api.mcp.ai/p_protheus

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"protheus-mcp","server_url":"https://api.mcp.ai/p_protheus","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"protheus-mcp","server_url":"https://api.mcp.ai/p_protheus"}

Tools

• protheus_api ~226 tokens
  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.
• protheus_catalogo ~161 tokens
  Consulta 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_api. É documentação, não disponibilidade: para saber o que esta instalação responde, use protheus_dia
• protheus_centros_custo ~206 tokens
  Lista os centros de custo da contabilidade, ou consulta um pelo id interno. Bulk support: accepts ids for batched execution.
• protheus_clientes_fornecedores ~245 tokens
  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.
• protheus_comissoes ~202 tokens
  Consulta as comissões de venda, ou uma comissão pelo id interno. Bulk support: accepts ids for batched execution.
• protheus_compras_mrp ~272 tokens
  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.
• protheus_condicoes_pagamento ~209 tokens
  Lista as condições de pagamento cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.
• protheus_contatos ~200 tokens
  Lista os contatos do CRM, ou consulta um contato por id. Bulk support: accepts ids for batched execution.
• protheus_diagnostico ~175 tokens
  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 u
• protheus_estoque ~226 tokens
  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.
• protheus_filiais ~205 tokens
  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.
• protheus_limite_credito ~220 tokens
  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.
• protheus_list_accounts ~76 tokens
  Lista as instalações Protheus conectadas a este install, com id e label (host/usuário).
• protheus_modulos ~185 tokens
  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.
• protheus_notas_totais ~204 tokens
  Consulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.
• protheus_oportunidades ~210 tokens
  Lista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno. Bulk support: accepts ids for batched execution.
• protheus_ordens_producao ~254 tokens
  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.
• protheus_parametros ~162 tokens
  Consulta os parâmetros de sistema do Protheus.
• protheus_pedidos_varejo ~208 tokens
  Lista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido. Bulk support: accepts ids for batched execution.
• protheus_produtos ~227 tokens
  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.
• protheus_propostas_comerciais ~280 tokens
  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.
• protheus_tabela_precos ~207 tokens
  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.
• protheus_transportadoras ~206 tokens
  Lista as transportadoras cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.
• protheus_usuarios ~201 tokens
  Lista os usuários do Protheus, ou consulta um usuário por id. Bulk support: accepts ids for batched execution.
• protheus_vendas_varejo ~217 tokens
  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.
• protheus_vendedores ~204 tokens
  Lista os vendedores cadastrados, ou consulta um vendedor pelo código. Bulk support: accepts ids for batched execution.

Browse

• GitHub tools
• CRM
• GitHub and code hosting

Related MCP servers

• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• Laudus MCP by usefulapi
  Read Laudus ERP customers, sales, purchases, stock and accounting reports; create customers.
• Cin7 Core MCP by usefulapi
  Read Cin7 Core products, stock by location, sales, purchases, customers, suppliers and transfers.
• vintrace MCP by usefulapi
  Read vintrace vessels, batches, work orders, lab results, stock; assign work orders, add notes.
• KiotViet MCP by usefulapi
  Read KiotViet products, customers, invoices, orders and stock; create customers and orders.
• PHP Point of Sale MCP by usefulapi
  Read PHP Point of Sale items, sales, customers and 138 reports; manage customers, items, expenses.
• Lightspeed Retail (X-Series) MCP by usefulapi
  Read Lightspeed X-Series products, stock, sales, customers, stock orders; one-call sales reports.
• Unleashed Software MCP by usefulapi
  Check products, stock on hand, customers, orders, invoices and quotes, and create records.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.mcp-dir/protheus-mcp.svg)](https://aptlynx.net/servers/io.github.mcp-dir/protheus-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents