MCP.Market

TOTVS Protheus MCP server

online · 100% uptime
by mcp-dir·io.github.mcp-dir/protheus-mcp·v0.1.0
No reviews yet

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

A88/100grade A
Write a reviewRun it
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody has reviewed TOTVS Protheus yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

TOTVS Protheus tools (32)

write = sends, deletes, buys or posts
  • authenticateFree

    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.

  • connectFree

    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.

  • marketplaceFree

    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.

  • protheus_apiFree

    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_catalogoFree

    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.

  • protheus_centros_custoFree

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

  • protheus_clientes_fornecedoresFree

    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_comissoesFree

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

  • protheus_compras_mrpFree

    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_pagamentoFree

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

  • protheus_contatosFree

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

  • protheus_diagnosticoFree

    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.

  • protheus_estoqueFree

    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_filiaisFree

    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_creditoFree

    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_accountsFree

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

  • protheus_modulosFree

    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_totaisFree

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

  • protheus_oportunidadesFree

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

  • protheus_ordens_producaoFree

    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_parametrosFree

    Consulta os parâmetros de sistema do Protheus.

  • protheus_pedidos_varejoFree

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

  • protheus_produtosFree

    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_comerciaisFree

    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_precosFree

    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_transportadorasFree

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

  • protheus_usuariosFree

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

  • protheus_vendas_varejoFree

    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_vendedoresFree

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

  • report_bugFree

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

  • show_versionFree

    Show the current MCP platform and adapter versions.

  • toolkit_infoFree

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

Public scan report

scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 1214ms20/20
  • Tool poisoning32 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 61 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How TOTVS Protheus compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 85% of 2,174 E-commerce servers
Tools
32
the typical E-commerce server has 6
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote E-commerce server answers 100%
Response time
42 ms
faster than 96% of 1,527 E-commerce servers

What its tools let an agent do: 31 read · 1 change

Install TOTVS Protheus in Claude Code, Cursor or VS Code

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

What the publisher says

From the TOTVS Protheus repository's README, as published. We do not edit it. Read it on GitHub

TOTVS Protheus

TOTVS Protheus MCP, your ERP answering in plain language

Talk to your company's TOTVS Protheus ERP from Claude, ChatGPT or any MCP client. It runs on the official TOTVS REST API, against your own installation: you provide the REST service URL and your Protheus user and password, and nothing goes through an ERP middleman. Unlike the Protheus MCPs that already exist, which are developer tools (compiling AdvPL, searching the TDN), this one reads business data: branches, customers and vendors, products, stock, price lists, sales and orders, invoice totals, production orders and MRP purchasing. Read-only. Not affiliated with TOTVS.

  • 🏢 Your Protheus, not a middleman — connects to your company's installation through the official TOTVS REST API
  • 🔎 Finds out what YOUR installation answers — every Protheus publishes a different set of APIs, and the diagnostic maps it in one question
  • 📦 Business data, not a dev tool — branches, customers and vendors, products, stock, price lists, sales, orders, invoice totals, production orders and MRP purchasing
  • 🧩 Calls any REST route, including the custom endpoints your company built in Protheus
  • 🔒 Read-only — v1 only queries, it never writes to the ERP
  • 💬 Works with any MCP client: Claude Desktop, ChatGPT, Cursor, VS Code, Cline, Continue

Versão em português · Full docs (PT-BR) · Agent skill

One-click install

Claude (Web and Desktop)

Anthropic unified MCP installation at claude.ai/customize/connectors. The same link works for Claude Web and Claude Desktop (just be logged in):

➕ Open in Claude and connect

Manual (if the deeplink does not open): claude.ai/customize/connectors → + → Add custom connector → paste Name TOTVS Protheus and URL https://api.mcp.ai/p_protheus.

Cursor

➕ Install TOTVS Protheus in Cursor

VS Code (Copilot Chat)

➕ Install TOTVS Protheus in VS Code

ChatGPT, Manus, OpenClaw and 40+ other clients

Works with any MCP client that speaks MCP over HTTP. The server URL is always:

https://api.mcp.ai/p_protheus

Per-client details: INSTALL.md.

Example prompts

Which Protheus APIs does my installation answer?
List the group's branches with their company codes
What is today's stock balance by product?
Show price list 001 with its items
Which production orders are scheduled for this week?
What is customer X's credit limit?

26 tools available

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

TOTVS Protheus: common questions

Is TOTVS Protheus MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the TOTVS Protheus safety report
How do I install TOTVS Protheus?
It runs remotely at api.mcp.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does TOTVS Protheus need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is TOTVS Protheus maintained?
The last commit was 66 days ago (2026-08-30). The latest release is v0.1.0.
Is TOTVS Protheus up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of TOTVS Protheus?
Servers from other publishers that do the same job: Omie MCP server, Shopware MCP server and Stripe MCP server.
How does TOTVS Protheus compare with other E-commerce MCP servers?
safety score 88/100 (higher than 85% of 2,174 E-commerce servers); tools 32 (the typical E-commerce server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to TOTVS Protheus

Same job from other publishers: the closest match first, then the best rated.

  • Omie
    MCP server for Omie — ERP, customers, products, orders, invoices, financials
    More from codespar →
    B
  • Shopware
    Query and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.
    B
  • Stripe
    MCP server integrating with Stripe - tools for customers, products, payments, and more.
    A
  • Polymarket Toolkit
    Read-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.
    B
  • Sv Number
    Phone numbers for AI agents: order a private number, read the SMS verification code, hand it back.
    B

More from mcp-dir →