mcpbeat Sign in

TOTVS Protheus MCP Server

by mcp-dir Your server? Claim it
answering

TOTVS Protheus is answering right now. Last checked 2 min ago. It exposes 32 tools. Last commit 28 Aug 2026.

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

Uptime history 4 days of history
4 days agonow
100.0%
Uptime 24h
91 of 91 checks
32
Tools
read from the server
716 ms
Response time
average over 24h
0
Stars
last commit 28 Aug 2026

Nothing serious here today

Today is the operative word: we check TOTVS Protheus every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 2 min ago.

run in your terminal
claude mcp add protheus-mcp --transport http https://api.mcp.ai/p_protheus
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "protheus-mcp": {
      "url": "https://api.mcp.ai/p_protheus"
    }
  }
}
~/.codex/config.toml
[mcp_servers.protheus-mcp]
url = "https://api.mcp.ai/p_protheus"
.cursor/mcp.json
{
  "mcpServers": {
    "protheus-mcp": {
      "url": "https://api.mcp.ai/p_protheus"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "protheus-mcp": {
      "url": "https://api.mcp.ai/p_protheus"
    }
  }
}

Available tools 32

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

protheus
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.
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.
protheus_centros_custo
Lista os centros de custo da contabilidade, ou consulta um pelo id interno. Bulk support: accepts ids for batched execution.
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.
protheus_comissoes
Consulta as comissões de venda, ou uma comissão pelo id interno. Bulk support: accepts ids for batched execution.
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.
protheus_condicoes_pagamento
Lista as condições de pagamento cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.
protheus_contatos
Lista os contatos do CRM, ou consulta um contato por id. Bulk support: accepts ids for batched execution.
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.
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.
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.
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.
protheus_list_accounts
Lista as instalações Protheus conectadas a este install, com id e label (host/usuário).
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.
protheus_notas_totais
Consulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.
protheus_oportunidades
Lista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno. Bulk support: accepts ids for batched execution.
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.
protheus_parametros
Consulta os parâmetros de sistema do Protheus.
protheus_pedidos_varejo
Lista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido. Bulk support: accepts ids for batched execution.
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.
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.
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.
protheus_transportadoras
Lista as transportadoras cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.
protheus_usuarios
Lista os usuários do Protheus, ou consulta um usuário por id. Bulk support: accepts ids for batched execution.
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.
protheus_vendedores
Lista os vendedores cadastrados, ou consulta um vendedor pelo código. Bulk support: accepts ids for batched execution.
authenticate
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.
connect
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.
marketplace
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. 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.
report
report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
show
show_version
Show the current MCP platform and adapter versions.
toolkit
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.

Endpoints

URLTransportStateLatencyChecked
https://api.mcp.ai/p_protheus streamable-http answering 739 ms 2 min ago

Alternatives to TOTVS Protheus

same job, measured the same way
Olist Tiny ERP
by mcp-dir

Olist Tiny e-commerce ERP (formerly Tiny ERP) with the full official REST API v3, products, stock, o

7 tools answering
MCP Omie
by codespar

MCP server for Omie — ERP, customers, products, orders, invoices, financials

48 installs/wk local only
Conta Azul MCP
by douglac

Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.

57 tools answering
Trendyol Seller MCP
by koraynar

Unofficial Trendyol seller API for AI assistants: products, orders, Q&A, guarded stock/price writes.

local only
Wfirma MCP
by agente-dev

Unofficial read-only MCP server for the wFirma API v2: invoices, contractors, expenses, payments.

156 installs/wk local only
MCP Stripe
by infoinlet-marketplace

Read-only Stripe for AI agents — customers, charges, subscriptions, invoices, balance.

39 installs/wk local only
Tradingale
by tradingale

Read-only martingale data: Martingale Score & Startingale for 250+ cryptos and US stocks.

7 tools answering
C
1845 Smoked Meat AI Gateway
by getbotlens

MCP gateway for 1845meat.com: products, prices, stock and cart links. Read-only, no auth.

11 tools answering

TOTVS Protheus — questions

Answers built from our own checks of this server.

What can TOTVS Protheus do?
It exposes 32 tools, read directly from the server on our last check. Among them: authenticate, connect, marketplace, protheus_api, protheus_catalogo, protheus_centros_custo and 26 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is TOTVS Protheus working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 716 ms. The bar chart above shows every period we have measured.
How do I connect TOTVS Protheus?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does TOTVS Protheus need an API key?
No. TOTVS Protheus completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 32 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is TOTVS Protheus?
It answers our handshake in 716 ms on average, which is faster than 20% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.
Is TOTVS Protheus open source?
Yes — it is published under the MIT licence and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.