Skip to content

TOTVS Protheus

by mcp-dir · remote · no sign-in to list tools · v0.1.0 · published by GitHub user mcp-dir

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

Changes · 28
CompareRegistry entry

32 tools: 28 change things and 4 only read.

Scanned Oct 21, 2026

2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Findings

Matches of fixed checks, with the text they matched.

2 info
  • Infoconnect

    The description mentions "credentials".

    Matched text

    description: "...nticated:true and empty pending[]. When credentials are missing, returns connect_url for th..."

    What this check looks for
  • Infomarketplace

    The description mentions "credential".

    Matched text

    description: "...ating the tool list. If the MCP needs a credential/login, invoke returns a connect link; i..."

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

32 tools

Changes things 28Claude Code: ask
  • authenticateMCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Authenticate
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • marketplaceThe official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them.1 finding

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.

    Findings

    • Info

      The description mentions "credential".

      Matched text

      description: "...ating the tool list. If the MCP needs a credential/login, invoke returns a connect link; i..."

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Marketplace
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
  • protheus_apiFaz um GET em qualquer rota REST da instalação Protheus conectada.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_api
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_centros_custoLista os centros de custo da contabilidade, ou consulta um pelo id interno.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Lista os centros de custo da contabilidade, ou consulta um pelo id interno. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_centros_custo
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_clientes_fornecedoresConsulta o cadastro de clientes e fornecedores (API CustomerVendor).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_clientes_fornecedores
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_comissoesConsulta as comissões de venda, ou uma comissão pelo id interno.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Consulta as comissões de venda, ou uma comissão pelo id interno. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_comissoes
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_compras_mrpConsulta os pedidos de compra ou as solicitações de compra do MRP.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_compras_mrp
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_condicoes_pagamentoLista as condições de pagamento cadastradas, ou consulta uma pelo id interno.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Lista as condições de pagamento cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_condicoes_pagamento
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_contatosLista os contatos do CRM, ou consulta um contato por id.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Lista os contatos do CRM, ou consulta um contato por id. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_contatos
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_diagnosticoDescobre quais APIs REST esta instalação Protheus realmente responde.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_diagnostico
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_estoqueConsulta o saldo em estoque.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_estoque
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_filiaisLista as empresas e filiais do grupo (API TSIBranches).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_filiais
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_limite_creditoConsulta o limite de crédito dos clientes.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_limite_credito
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_modulosLista os módulos do sistema Protheus nesta instalação.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_modulos
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_notas_totaisConsulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Consulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.

    Annotations the server declares

    • title: protheus_notas_totais
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_oportunidadesLista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Lista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_oportunidades
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_ordens_producaoConsulta as ordens de produção do MRP.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_ordens_producao
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_parametrosConsulta os parâmetros de sistema do Protheus.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Consulta os parâmetros de sistema do Protheus.

    Annotations the server declares

    • title: protheus_parametros
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_pedidos_varejoLista os pedidos de venda do varejo.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Lista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_pedidos_varejo
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_produtosConsulta o cadastro de produtos.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_produtos
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_propostas_comerciaisLista as propostas comerciais de uma oportunidade, ou consulta uma proposta específica.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_propostas_comerciais
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_tabela_precosConsulta as tabelas de preço.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_tabela_precos
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_transportadorasLista as transportadoras cadastradas, ou consulta uma pelo id interno.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Lista as transportadoras cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_transportadoras
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_usuariosLista os usuários do Protheus, ou consulta um usuário por id.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Lista os usuários do Protheus, ou consulta um usuário por id. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_usuarios
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_vendas_varejoConsulta as vendas do varejo, ou uma venda pelo id interno.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: protheus_vendas_varejo
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_vendedoresLista os vendedores cadastrados, ou consulta um vendedor pelo código.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Lista os vendedores cadastrados, ou consulta um vendedor pelo código. Bulk support: accepts ids for batched execution.

    Annotations the server declares

    • title: protheus_vendedores
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • report_bugReport a bug, missing feature, or send feedback.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

    Annotations the server declares

    • title: Report Bug
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
Only reads 4Claude Code: allow
  • connectReturns connection status and URLs.1 finding

    Why it is in this group

    • The description's first verb is "return": a word for reading.

    Findings

    • Info

      The description mentions "credentials".

      Matched text

      description: "...nticated:true and empty pending[]. When credentials are missing, returns connect_url for th..."

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Connection Status
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • protheus_list_accountsLista as instalações Protheus conectadas a este install, com id e label (host/usuário).No findings

    Why it is in this group

    • The name "protheus_list_accounts" says "list": a word for reading.
    Description, as the server wrote it
    Lista as instalações Protheus conectadas a este install, com id e label (host/usuário).

    Annotations the server declares

    • title: protheus_list_accounts
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • show_versionShow the current MCP platform and adapter versions.No findings

    Why it is in this group

    • The name "show_version" says "show": a word for reading.
    Description, as the server wrote it
    Show the current MCP platform and adapter versions.

    Annotations the server declares

    • title: Show Version
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • toolkit_infoReturns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.No findings

    Why it is in this group

    • The description's first verb is "return": a word for reading.
    Description, as the server wrote it
    Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

    Annotations the server declares

    • title: Toolkit Info
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.0. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__protheus__protheus_list_accounts",
      "mcp__protheus__show_version",
      "mcp__protheus__connect",
      "mcp__protheus__toolkit_info"
    ],
    "ask": [
      "mcp__protheus__protheus_diagnostico",
      "mcp__protheus__protheus_catalogo",
      "mcp__protheus__protheus_api",
      "mcp__protheus__protheus_filiais",
      "mcp__protheus__protheus_modulos",
      "mcp__protheus__protheus_parametros",
      "mcp__protheus__protheus_usuarios",
      "mcp__protheus__protheus_clientes_fornecedores",
      "mcp__protheus__protheus_contatos",
      "mcp__protheus__protheus_vendedores",
      "mcp__protheus__protheus_oportunidades",
      "mcp__protheus__protheus_propostas_comerciais",
      "mcp__protheus__protheus_tabela_precos",
      "mcp__protheus__protheus_condicoes_pagamento",
      "mcp__protheus__protheus_limite_credito",
      "mcp__protheus__protheus_comissoes",
      "mcp__protheus__protheus_transportadoras",
      "mcp__protheus__protheus_centros_custo",
      "mcp__protheus__protheus_produtos",
      "mcp__protheus__protheus_estoque",
      "mcp__protheus__protheus_vendas_varejo",
      "mcp__protheus__protheus_pedidos_varejo",
      "mcp__protheus__protheus_notas_totais",
      "mcp__protheus__protheus_ordens_producao",
      "mcp__protheus__protheus_compras_mrp",
      "mcp__protheus__report_bug",
      "mcp__protheus__marketplace",
      "mcp__protheus__authenticate"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as protheus. Review it before you use it.