# TOTVS Protheus — MCP server on mcp.ai
> TOTVS Protheus ERP through the official REST API of your own installation. You provide the REST service URL, your Protheus user and password, and the platform authenticates against your server's oAuth2 API to read your data. Read-only: branches, customers and vendors, products, stock balance, price lists, retail sales and orders, invoice totals, production orders, MRP purchasing, cost centers, sales commissions and credit limits. Since every Protheus installation publishes a different set of APIs, there is a diagnostic tool that discovers what yours answers, and another that calls any REST route, including your company's custom ones.

By: mcp.ai · official
Page: https://mcp.ai/protheus

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_protheus?ms=1788152400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/protheus/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/protheus/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/protheus/skill.md
Postman collection (v2.1): https://mcp.ai/protheus/postman.json

## Tools
- protheus_api(path: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string) — 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 
- protheus_catalogo(termo?: string, segmento?: string, limit?: integer, account?: string) — 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_a
- protheus_centros_custo(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Lista os centros de custo da contabilidade, ou consulta um pelo id interno.
- protheus_clientes_fornecedores(tipo?: string, id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — 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.
- protheus_comissoes(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Consulta as comissões de venda, ou uma comissão pelo id interno.
- protheus_compras_mrp(tipo?: string, branch_id?: string, codigo?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, branch_ids?: string[]) — 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ífic
- protheus_condicoes_pagamento(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Lista as condições de pagamento cadastradas, ou consulta uma pelo id interno.
- protheus_contatos(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Lista os contatos do CRM, ou consulta um contato por id.
- protheus_diagnostico(termo?: string, limit?: integer, account?: string) — 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 p
- protheus_estoque(fonte?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string) — 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 dist
- protheus_filiais(page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string) — 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(cliente_id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, cliente_ids?: string[]) — Consulta o limite de crédito dos clientes. Com `cliente_id` traz o limite de um cliente específico.
- protheus_list_accounts(account?: string) — Lista as instalações Protheus conectadas a este install, com id e label (host/usuário).
- protheus_modulos(page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string) — 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(tipo?: string, canceladas?: boolean, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string) — Consulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.
- protheus_oportunidades(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Lista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno.
- protheus_ordens_producao(branch_id?: string, codigo?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, branch_ids?: string[]) — 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.
- protheus_parametros(page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string) — Consulta os parâmetros de sistema do Protheus.
- protheus_pedidos_varejo(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Lista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido.
- protheus_produtos(fonte?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string) — 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
- protheus_propostas_comerciais(oportunidade_id: string, id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, oportunidade_ids?: string[], ids?: string[]) — 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.
- protheus_tabela_precos(codigo?: string, itens?: boolean, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string) — 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(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Lista as transportadoras cadastradas, ou consulta uma pelo id interno.
- protheus_usuarios(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Lista os usuários do Protheus, ou consulta um usuário por id.
- protheus_vendas_varejo(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Consulta as vendas do varejo, ou uma venda pelo id interno. Exige o módulo de varejo publicado nesta instalação.
- protheus_vendedores(id?: string, page?: integer, page_size?: integer, order?: string, fields?: string, filter?: string, expand?: string, sql_filter?: string, params?: object, account?: string, ids?: string[]) — Lista os vendedores cadastrados, ou consulta um vendedor pelo código.

## Example prompts
- "Which Protheus APIs does my installation answer?"
- "List the group's branches and company codes"
- "What is today's stock balance by product?"

## Links
Docs: https://mcp.ai/docs/mcps/protheus
Website: https://mcp.ai/mcps/protheus