TOTVS Protheus
TOTVS Protheus ERP for AI: stock, sales, orders, customers and MRP. Read-only, official API.
| Endpoint | https://api.mcp.ai/p_protheus (streamable-http) |
|---|---|
| Registry version | 0.1.0 |
| Now | 32 tools · grade D (58) · pin ts_9cd399598844d8f55482b903ba0b4d49 · protocol 2025-06-18 |
| First / last listed | 2026-11-06 01:26 UTC / 2026-11-06 01:26 UTC |
| Grade over time | 2026-11-06: D (58), 32 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: protheus_list_accounts protheus_diagnostico protheus_catalogo protheus_api protheus_filiais protheus_modulos protheus_parametros protheus_usuarios protheus_clientes_fornecedores protheus_contatos protheus_vendedores protheus_oportunidades protheus_propostas_comerciais protheus_tabela_precos protheus_condicoes_pagamento protheus_limite_credito protheus_comissoes protheus_transportadoras protheus_centros_custo protheus_produtos protheus_estoque protheus_vendas_varejo protheus_pedidos_varejo protheus_notas_totais protheus_ordens_producao protheus_compras_mrp show_version report_bug connect toolkit_info marketplace authenticate
protheus_list_accounts | Lista as instalações Protheus conectadas a este install, com id e label (host/usuário). params: account |
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. params: termo, limit, account |
protheus_catalogo | 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_diagnostico. params: termo, segmento, limit, account |
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. params: path*, page, page_size, order, fields, filter, expand, sql_filter, params, account |
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. params: page, page_size, order, fields, filter, expand, sql_filter, params, account |
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. params: page, page_size, order, fields, filter, expand, sql_filter, params, account |
protheus_parametros | Consulta os parâmetros de sistema do Protheus. params: page, page_size, order, fields, filter, expand, sql_filter, params, account |
protheus_usuarios | Lista os usuários do Protheus, ou consulta um usuário por id.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
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. params: tipo, id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
protheus_contatos | Lista os contatos do CRM, ou consulta um contato por id.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
protheus_vendedores | Lista os vendedores cadastrados, ou consulta um vendedor pelo código.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
protheus_oportunidades | Lista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
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. params: oportunidade_id*, id, page, page_size, order, fields, filter, expand, sql_filter, params, account, oportunidade_ids, ids |
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. params: codigo, itens, page, page_size, order, fields, filter, expand, sql_filter, params, account |
protheus_condicoes_pagamento | Lista as condições de pagamento cadastradas, ou consulta uma pelo id interno.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
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. params: cliente_id, page, page_size, order, fields, filter, expand, sql_filter, params, account, cliente_ids |
protheus_comissoes | Consulta as comissões de venda, ou uma comissão pelo id interno.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
protheus_transportadoras | Lista as transportadoras cadastradas, ou consulta uma pelo id interno.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
protheus_centros_custo | Lista os centros de custo da contabilidade, ou consulta um pelo id interno.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
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. params: fonte, page, page_size, order, fields, filter, expand, sql_filter, params, account |
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. params: fonte, page, page_size, order, fields, filter, expand, sql_filter, params, account |
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. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
protheus_pedidos_varejo | Lista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido.
Bulk support: accepts ids for batched execution. params: id, page, page_size, order, fields, filter, expand, sql_filter, params, account, ids |
protheus_notas_totais | Consulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas. params: tipo, canceladas, page, page_size, order, fields, filter, expand, sql_filter, params, account |
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. params: branch_id, codigo, page, page_size, order, fields, filter, expand, sql_filter, params, account, branch_ids |
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. params: tipo, branch_id, codigo, page, page_size, order, fields, filter, expand, sql_filter, params, account, branch_ids |
show_version | Show the current MCP platform and adapter versions. params: none |
report_bug | Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. params: message*, context, conversation |
connect | 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. params: none |
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. params: none |
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. params: action, query, mcp_id, limit, tier_slug, immediate, cancel_reason, cancel_comment, message, report_context, conversation, request_name, request_details, tool_id, arguments, prompt_slug, prompt_vars, prompt_category, prompt_tool, prompt_title, prompt_description, prompt_body, prompt_targets |
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. params: token |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.