Microvix

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Nov 18, 2026

Microvix retail ERP (Linx, part of the Stone group) for store chains and franchises, via the officia

VerifiedStreamable HTTPWeb executableDatabasesData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Read-only access to Microvix (Linx) retail ERP data — products, stock, customers, sales movement, orders, sellers and stores — for chains and franchises.

What you can do
  • List connected Microvix portals and the stores (CNPJs) of a group, with store/company details such as address and tax regime
  • Look up product registrations and per-store product details: barcode, quantity, cost and sale price, average cost
  • Check stock inventory balances by barcode for a given inventory date and store
  • Query customer and supplier records, filtered by date, document or store
  • Retrieve sales and fiscal movement item by item, including invoice key, taxes and payment methods, plus sales orders and seller records
  • Report bugs or feedback and inspect platform versions, connection status and the mcp.ai marketplace
When to use it
Useful when an assistant needs to answer questions about a Microvix-based retail operation: revenue and sales movement in a date range, current stock or inventory, recently updated products, customer/supplier lists, or sales orders and sellers — without touching the ERP directly.
Requirements
A remote MCP over HTTP endpoint; no local package. Requires Microvix portal credentials issued by Linx (user, password, key and IdPortal), connected through the server's connection flow; login is via magic-link. A paid plan may apply, starting from a free tier.
Before you install
Credentials for the Microvix portal are required and are handled by the hosted service. Data returned by the tools is sent to whichever LLM host you use, a sub-processor outside the provider's control; plans with training opt-out are recommended. The server is proprietary and hosted, and pricing applies beyond the free tier. Tools are described as read-only, but the marketplace, bug-report and authenticate tools are separate from the ERP data tools.

Installation

In SourceWeft

  1. Open Microvix in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fmicrovix-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "microvix": {
      "type": "http",
      "url": "https://api.mcp.ai/p_microvix"
    }
  }
}

README

Microvix

Microvix para Claude, ChatGPT e agentes de IA

ERP de varejo Microvix (Linx, do grupo Stone) para redes de lojas e franquias, via WebService de Saída oficial. Somente leitura: produtos, estoque e inventário, clientes e fornecedores, movimento de vendas e faturamento, pedidos, vendedores e lojas do grupo. Sem paginação, filtre por janela de data e por loja (CNPJ). Autenticação pelas credenciais do portal (usuário, senha, chave e IdPortal) fornecidas pela Linx.

  • 📊 10 ferramentas
  • 🔒 Somente leitura
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes


Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Microvix e URL https://api.mcp.ai/p_microvix.

Cursor

➕ Instalar Microvix no Cursor

VS Code (Copilot Chat)

➕ Instalar Microvix no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_microvix

Detalhes por cliente: INSTALL.md.


Exemplos de uso

Liste o movimento de vendas da loja entre as datas X e YMostre o inventário de estoque mais recenteListe os produtos atualizados na última semana

10 ferramentas disponíveis

ToolDescrição
microvix_list_accountsLista os portais Microvix conectados a este install — id, label.
microvix_grupo_lojasLista os CNPJs das lojas de um grupo (LinxGrupoLojas).
microvix_lojasDados das lojas/empresas do portal (LinxLojas): CNPJ, endereço, regime tributário.
microvix_produtosCadastro de produtos (LinxProdutos): nome, NCM, CEST, referência, cor/tamanho, marca/linha/setor.
microvix_produtos_detalhesDetalhe de produto por loja (LinxProdutosDetalhes): código de barras, quantidade, preco_custo, preco_venda, custo_medio.
microvix_produtos_inventarioInventário/saldo de estoque por código de barras (LinxProdutosInventario).
microvix_clientes_fornecCadastro de clientes e fornecedores (LinxClientesFornec).
microvix_movimentoMovimento de vendas/fiscal (LinxMovimento): transações, chave da NF, impostos (ICMS/PIS/COFINS/IPI), formas de pagamento.
microvix_pedidos_vendaPedidos de venda (LinxPedidosVenda).
microvix_vendedoresCadastro de vendedores (LinxVendedores).

Detalhe de cada tool: docs/ferramentas.md


Preços

Planos a partir do tier grátis. Veja docs/precos.md.


Privacidade & LGPD

  • Somente leitura, nenhuma ferramenta altera dados na origem.
  • Sub-processadores: Linx (Microvix), o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_microvix.


Suporte


Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_microvix é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

Source: README.md at commit bd37a7f

Tools

16

microvix_list_accounts

Lista os portais Microvix conectados a este install — id, label.

Parametersaccount

microvix_grupo_lojas

Lista os CNPJs das lojas de um grupo (LinxGrupoLojas). Use pra descobrir os cnpj_emp antes de iterar.

Parametersgrupolimitoffsetaccount

microvix_lojas

Dados das lojas/empresas do portal (LinxLojas): CNPJ, endereço, regime tributário.

Parameterslimitoffsetaccountcnpj_emp

microvix_produtos

Cadastro de produtos (LinxProdutos): nome, NCM, CEST, referência, cor/tamanho, marca/linha/setor. Filtre por janela de atualização (dt_update_inicio/fim) e cnpj_emp.

Parameterslimitoffsetaccountcnpj_empreferenciacod_produtodt_update_fimdt_update_inicio

microvix_produtos_detalhes

Detalhe de produto por loja (LinxProdutosDetalhes): código de barras, quantidade, preco_custo, preco_venda, custo_medio. Filtre por data_mov_ini/fim e cnpj_emp.

Parameterslimitoffsetaccountcnpj_empreferenciacod_produtodata_mov_fimdata_mov_ini

microvix_produtos_inventario

Inventário/saldo de estoque por código de barras (LinxProdutosInventario). Informe data_inventario e cnpj_emp.

Parameterslimitoffsetaccountcnpj_empdata_inventario

microvix_clientes_fornec

Cadastro de clientes e fornecedores (LinxClientesFornec). Filtre por data_inicial/fim, doc_cliente e cnpj_emp.

Parameterslimitoffsetaccountcnpj_empdata_fimdoc_clientedata_inicial

microvix_movimento

Movimento de vendas/fiscal (LinxMovimento): transações, chave da NF, impostos (ICMS/PIS/COFINS/IPI), formas de pagamento. Filtre por data_inicial/fim e cnpj_emp — a janela filtra por data_lancamento, não por data_documento. É a base do faturamento. É item a item (uma linha por produto de cada transação, 116 colunas), e o Microvix devolve no máximo 5.000 linhas por chamada: um mês de uma loja passa de 15 MB E não cabe numa chamada só. Por isso o DEFAULT é formato:"resumo" — ele VARRE a janela inteira (várias chamadas ao Microvix, deduplicadas) e devolve totais determinísticos por operação/tipo/cancelado/excluído e por dia, cada número sendo a soma da coluna crua de mesmo nome. Confira sempre `truncado_pelo_provedor` e `cobertura_data_lancamento`: se vier truncado, os números são PARCIAIS e você deve refazer em pedaços menores. Para fechamento mensal, faça uma chamada por (cnpj_emp, período) em "resumo" — pode levar ~20s por loja. Use formato:"linhas" só quando precisar do item a item; aí é UMA chamada, paginada por limit/offset e sujeita ao teto de 5.000.

Parameterslimitoffsetaccountformatocnpj_empdata_fimdata_inicial

microvix_pedidos_venda

Pedidos de venda (LinxPedidosVenda). Filtre por data_inicial/fim, doc_cliente e cnpj_emp.

Parameterslimitoffsetaccountcnpj_empdata_fimdoc_clientedata_inicial

microvix_vendedores

Cadastro de vendedores (LinxVendedores). Filtre por data_upd_inicial/fim, cod_vendedor e cnpj_emp.

Parameterslimitoffsetaccountcnpj_empcod_vendedordata_upd_fimdata_upd_inicial

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

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

Parameterscontextmessagerequiredconversation

connect

Connection Status

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.

Takes no parameters.

toolkit_info

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.

Takes no parameters.

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.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

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.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts