Olist MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Olist MCP pesquisar produtos com nome 'mouse'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Olist MCP
Servidor Model Context Protocol (MCP) open source e auto-hospedável para a API V2 do Olist ERP (Tiny). Funciona por stdio, portanto pode ser usado pelo Codex, Claude Desktop e qualquer cliente/harness compatível com MCP.
A API V2 permanece funcional, mas a Olist informa que ela não receberá novos recursos. Este projeto usa a documentação pública V2, pois não há especificação OpenAPI publicada.
Recursos
Uma ferramenta MCP individual para cada um dos 92 endpoints REST V2 que a documentação pública apresenta com URL REST, como
olist_produto_obter,olist_nota_fiscal_pesquisaeolist_conta_receber_baixar;Schemas de entrada e descrições dos parâmetros extraídos da página oficial de cada serviço;
Proteção contra escrita: ferramentas que incluem, alteram, atualizam, baixam, lançam, estornam, emitem, excluem, cancelam, geram, enviam ou concluem exigem
confirmar: true.
As chamadas são feitas por POST com application/x-www-form-urlencoded, incluindo token e formato=JSON, exatamente no formato apresentado pela documentação V2.
Related MCP server: OpenAPI MCP Server
Pré-requisitos
Node.js 20 ou superior;
um token da API Olist/Tiny, gerado no ERP. Não envie esse token em conversas nem o versiona em arquivos.
Instalação e execução local
git clone <URL_DESTE_REPOSITORIO> olist-mcp
cd olist-mcp
npm install
npm run build
export OLIST_API_TOKEN='seu-token'
npm startO processo não abre porta HTTP: o cliente MCP inicia o executável e conversa por entrada/saída padrão. Para desenvolvimento, use npm run dev.
Para instalar globalmente após publicar o pacote no npm, o comando será npm install -g olist-mcp; até lá, prefira apontar o harness para o dist/index.js deste clone.
Configuração no Codex
Depois do npm run build, adicione uma entrada ao arquivo de configuração MCP do Codex (substitua o caminho absoluto e o token):
[mcp_servers.olist]
command = "node"
args = ["/caminho/absoluto/olist-mcp/dist/index.js"]
[mcp_servers.olist.env]
OLIST_API_TOKEN = "seu-token"Reinicie a sessão do Codex. Nunca use npm start como command: MCP precisa iniciar o processo diretamente, sem um shell intermediário.
Configuração no Claude Desktop
No arquivo de configuração do Claude Desktop, inclua (ou mescle) o bloco abaixo:
{
"mcpServers": {
"olist": {
"command": "node",
"args": ["/caminho/absoluto/olist-mcp/dist/index.js"],
"env": {
"OLIST_API_TOKEN": "seu-token"
}
}
}
}Reinicie o Claude Desktop após salvar. Em Windows, use barras duplas no caminho JSON, por exemplo C:\\Projetos\\olist-mcp\\dist\\index.js.
Qualquer outro harness MCP
Configure um transporte stdio com:
command: node
args: ["/caminho/absoluto/olist-mcp/dist/index.js"]
env: { OLIST_API_TOKEN: "seu-token" }Ferramentas, schemas e atualização do catálogo
Não há uma ferramenta genérica: cada endpoint REST documentado vira uma ferramenta MCP própria. Os campos obrigatórios, tipos (string, int, decimal e objeto JSON) e descrições vêm da tabela “Parâmetros do serviço” de sua página oficial. token e formato não aparecem no schema porque o servidor os inclui automaticamente.
Para atualizar o catálogo quando a Olist modificar a documentação:
npm run generate:catalog
npm run check && npm test && npm run buildO gerador salva o resultado versionado em src/generated/catalog.ts; portanto a instalação normal não precisa acessar a internet. Das 127 páginas api2-* referenciadas no índice atual, 92 expõem uma URL REST e geram ferramentas. As demais são páginas explicativas (limites, token, webhooks, fluxos ou tabelas auxiliares), não endpoints invocáveis.
Operações de escrita requerem confirmar: true, mesmo que o agente já tenha recebido instrução em linguagem natural. Esse é um último guard rail; ele não substitui a revisão dos parâmetros pelo usuário.
Endpoints e documentação
A Olist publica a lista de serviços e páginas individuais em HTML, no padrão https://tiny.com.br/api-docs/api2-*. Como não existe um OpenAPI oficial, este servidor não tenta inventar schemas para todos os endpoints: a ferramenta genérica encaminha os parâmetros documentados e os atalhos cobrem as consultas mais frequentes.
Referências oficiais:
Desenvolvimento
npm test
npm run check
npm run buildPara testes automatizados, defina OLIST_API_BASE_URL para um mock/proxy local, se necessário. Não há telemetria e o token só é usado na chamada à API Olist.
Licença
MIT.
Available Tools
92 toolsolist_cadastrar_codigo_rastreamento_pedidoC
Atualizar informações de despacho API 2.0. Endpoint API V2: cadastrar.codigo.rastreamento.pedido. Documentação: https://tiny.com.br/api-docs/api2-pedidos-cadastrar-codigo-rastreamento
Inputs: id (required), volumes, pesoBruto, formaEnvio, +8 more.
olist_conta_pagar_baixarA
Baixar Conta a PagarAPI 2.0. Endpoint API V2: conta.pagar.baixar. Documentação: https://tiny.com.br/api-docs/api2-contas-pagar-baixar Esta operação altera dados e exige confirmar=true.
Inputs: conta (required), confirmar (required).
olist_conta_pagar_incluirB
Incluir Conta a Pagar API 2.0. Endpoint API V2: conta.pagar.incluir. Documentação: https://tiny.com.br/api-docs/api2-contas-pagar-incluir Esta operação altera dados e exige confirmar=true.
Inputs: conta (required), confirmar (required).
olist_conta_pagar_obterC
Obter Conta a Pagar API 2.0. Endpoint API V2: conta.pagar.obter. Documentação: https://tiny.com.br/api-docs/api2-contas-pagar-obter
Inputs: id (required).
olist_conta_receber_alterarC
Alterar Conta a Receber API 2.0. Endpoint API V2: conta.receber.alterar. Documentação: https://tiny.com.br/api-docs/api2-contas-receber-alterar Esta operação altera dados e exige confirmar=true.
Inputs: confirmar (required).
olist_conta_receber_baixarB
Baixar Conta a ReceberAPI 2.0. Endpoint API V2: conta.receber.baixar. Documentação: https://tiny.com.br/api-docs/api2-contas-receber-baixar Esta operação altera dados e exige confirmar=true.
Inputs: conta (required), confirmar (required).
olist_conta_receber_incluirB
Incluir Conta a Receber API 2.0. Endpoint API V2: conta.receber.incluir. Documentação: https://tiny.com.br/api-docs/api2-contas-receber-incluir Esta operação altera dados e exige confirmar=true.
Inputs: conta (required), confirmar (required).
olist_conta_receber_obterC
Obter Conta a Receber API 2.0. Endpoint API V2: conta.receber.obter. Documentação: https://tiny.com.br/api-docs/api2-contas-receber-obter
Inputs: id (required), obter_link_boleto.
olist_contas_pagar_pesquisaC
Pesquisar Contas a Pagar API 2.0. Endpoint API V2: contas.pagar.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-contas-pagar-pesquisar
Inputs: pagina, situacao, numero_doc, nome_cliente, +4 more.
olist_contas_receber_pesquisaC
Pesquisar Contas a Receber API 2.0. Endpoint API V2: contas.receber.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-contas-receber-pesquisar
Inputs: pagina, situacao, id_origem, numero_doc, +6 more.
olist_contato_alterarC
Alterar Contato API 2.0. Endpoint API V2: contato.alterar. Documentação: https://tiny.com.br/api-docs/api2-contatos-alterar Esta operação altera dados e exige confirmar=true.
Inputs: contato (required), confirmar (required).
olist_contato_incluirB
Incluir Contato API 2.0. Endpoint API V2: contato.incluir. Documentação: https://tiny.com.br/api-docs/api2-contatos-incluir Esta operação altera dados e exige confirmar=true.
Inputs: contato (required), confirmar (required).
olist_contato_obterC
Obter Contato API 2.0. Endpoint API V2: contato.obter. Documentação: https://tiny.com.br/api-docs/api2-contatos-obter
Inputs: id (required).
olist_contatos_pesquisaC
Pesquisar Cadastros API 2.0. Endpoint API V2: contatos.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-contatos-pesquisar
Inputs: pesquisa (required), pagina, cpf_cnpj, situacao, +4 more.
olist_contrato_adicional_excluirA
Excluir Adicional de Contrato API 2.0. Endpoint API V2: contrato.adicional.excluir. Documentação: https://tiny.com.br/api-docs/api2-contratos-adicional-excluir Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required).
olist_contrato_adicional_incluirA
Incluir Adicional de Contrato API 2.0. Endpoint API V2: contrato.adicional.incluir. Documentação: https://tiny.com.br/api-docs/api2-contratos-adicional-incluir Esta operação altera dados e exige confirmar=true.
Inputs: adicional (required), confirmar (required).
olist_contrato_adicional_pesquisaB
Pesquisar Adicionais de Contrato API 2.0. Endpoint API V2: contrato.adicional.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-contratos-adicional-pesquisar
Inputs: idContrato (required).
olist_contrato_alterarC
Alterar Contrato API 2.0. Endpoint API V2: contrato.alterar. Documentação: https://tiny.com.br/api-docs/api2-contratos-alterar Esta operação altera dados e exige confirmar=true.
Inputs: contrato (required), confirmar (required).
olist_contrato_incluirB
Incluir Contrato API 2.0. Endpoint API V2: contrato.incluir. Documentação: https://tiny.com.br/api-docs/api2-contratos-incluir Esta operação altera dados e exige confirmar=true.
Inputs: contrato (required), confirmar (required).
olist_contrato_obterC
Obter Contrato API 2.0. Endpoint API V2: contrato.obter. Documentação: https://tiny.com.br/api-docs/api2-contratos-obter
Inputs: id (required).
olist_contratos_pesquisaC
Pesquisar Contratos API 2.0. Endpoint API V2: contratos.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-contratos-pesquisar
Inputs: pagina, cliente, cpf_cnpj, situacao, +4 more.
olist_crm_alterar_estagio_assuntoA
Alterar estágio do assunto do CRM API 2.0. Endpoint API V2: crm.alterar.estagio.assunto. Documentação: https://tiny.com.br/api-docs/api2-crm-alterar-estagio-assunto Esta operação altera dados e exige confirmar=true.
Inputs: confirmar (required), idAssunto (required), estagioAssunto (required).
olist_crm_alterar_situacao_acaoC
Alterar situação da ação do assunto do CRM API 2.0. Endpoint API V2: crm.alterar.situacao.acao. Documentação: https://tiny.com.br/api-docs/api2-crm-alterar-situacao-acao Esta operação altera dados e exige confirmar=true.
Inputs: idAcao (required), confirmar (required), situacaoAcao (required).
olist_crm_incluir_acao_assuntoB
Incluir Ação no Assunto do CRM API 2.0. Endpoint API V2: crm.incluir.acao.assunto. Documentação: https://tiny.com.br/api-docs/api2-crm-incluir-acao-assunto Esta operação altera dados e exige confirmar=true.
Inputs: acao (required), confirmar (required).
olist_crm_incluir_assuntoC
Incluir Assunto do CRM API 2.0. Endpoint API V2: crm.incluir.assunto. Documentação: https://tiny.com.br/api-docs/api2-crm-incluir-assunto Esta operação altera dados e exige confirmar=true.
Inputs: assunto (required), confirmar (required).
olist_crm_lista_estagios_assuntoB
Lista de Estágios do CRM API 2.0. Endpoint API V2: crm.lista.estagios.assunto. Documentação: https://tiny.com.br/api-docs/api2-crm-lista-estagios
Inputs: no named parameters.
olist_crm_obter_assuntoB
Obter Assunto do CRM API 2.0. Endpoint API V2: crm.obter.assunto. Documentação: https://tiny.com.br/api-docs/api2-crm-obter-assunto
Inputs: id (required).
olist_crm_pesquisaB
Pesquisar Assuntos do CRM API 2.0. Endpoint API V2: crm.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-crm-pesquisar
Inputs: pagina, pesquisa, dataFinal, filtroPor, +6 more.
olist_expedicao_alterarB
Alterar Expedição API 2.0. Endpoint API V2: expedicao.alterar. Documentação: https://tiny.com.br/api-docs/api2-expedicao-alterar Esta operação altera dados e exige confirmar=true.
Inputs: confirmar (required), expedicao (required).
olist_expedicao_concluir_agrupamentoA
Concluir agrupamento de expedições API 2.0. Endpoint API V2: expedicao.concluir.agrupamento. Documentação: https://tiny.com.br/api-docs/api2-expedicao-concluir-agrupamento Esta operação altera dados e exige confirmar=true.
Inputs: confirmar (required), idAgrupamento (required).
olist_expedicao_incluir_agrupamentoB
Incluir agrupamento de expedições API 2.0. Endpoint API V2: expedicao.incluir.agrupamento. Documentação: https://tiny.com.br/api-docs/api2-expedicao-incluir-agrupamento Esta operação altera dados e exige confirmar=true.
Inputs: confirmar (required), idsExpedicao (required).
olist_expedicao_liberar_objetosC
Enviar objetos para a expedição API 2.0. Endpoint API V2: expedicao.liberar.objetos. Documentação: https://tiny.com.br/api-docs/api2-enviar-objetos-para-expedicao
Inputs: idObjetos (required), tipoObjetos (required).
olist_expedicao_obterC
Obter expedições API 2.0. Endpoint API V2: expedicao.obter. Documentação: https://tiny.com.br/api-docs/api2-expedicao-obter
Inputs: idObjeto, tipoObjeto, idExpedicao.
olist_expedicao_obter_agrupamento_impressaoC
Obter agrupamento para impressão API 2.0. Endpoint API V2: expedicao.obter.agrupamento.impressao. Documentação: https://tiny.com.br/api-docs/api2-expedicao-obter-agrupamento-impressao
Inputs: idAgrupamento (required).
olist_expedicao_obter_etiquetas_impressaoC
Obter etiquetas para impressão API 2.0. Endpoint API V2: expedicao.obter.etiquetas.impressao. Documentação: https://tiny.com.br/api-docs/api2-expedicao-obter-etiquetas-impressao
Inputs: idExpedicao, idAgrupamento.
olist_expedicao_pesquisaD
Pesquisar expedições API 2.0. Endpoint API V2: expedicao.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-expedicao-pesquisar
Inputs: formaEnvio (required), pagina, dataFinal, dataInicial, +2 more.
olist_expedicao_pesquisar_agrupamentosC
Pesquisar agrupamentos API 2.0. Endpoint API V2: expedicao.pesquisar.agrupamentos. Documentação: https://tiny.com.br/api-docs/api2-expedicao-pesquisar-agrupamentos
Inputs: pagina, dataFinal, formaEnvio, dataInicial, +1 more.
olist_formas_recebimento_pesquisaB
Pesquisar Formas de Recebimento API 2.0. Endpoint API V2: formas.recebimento.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-formas-recebimento-pesquisar
Inputs: situacao.
olist_gerar_nota_fiscal_pedidoB
Gerar Nota Fiscal do Pedido API 2.0. Endpoint API V2: gerar.nota.fiscal.pedido. Documentação: https://tiny.com.br/api-docs/api2-pedidos-gerar-nota-fiscal Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required), modelo.
olist_gerar_ordem_producao_pedidoA
Gerar Ordem de Produção do Pedido API 2.0. Endpoint API V2: gerar.ordem.producao.pedido. Documentação: https://tiny.com.br/api-docs/api2-pedidos-gerar-ordem-producao Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required), lancarEstoque (required).
olist_grupo_tag_alterarA
Alterar Grupo de Tags API 2.0. Endpoint API V2: grupo.tag.alterar. Documentação: https://tiny.com.br/api-docs/api2-grupos-tag-alterar Esta operação altera dados e exige confirmar=true.
Inputs: grupo (required), confirmar (required).
olist_grupo_tag_incluirC
Incluir Grupo de Tags API 2.0. Endpoint API V2: grupo.tag.incluir. Documentação: https://tiny.com.br/api-docs/api2-grupos-tag-incluir Esta operação altera dados e exige confirmar=true.
Inputs: grupo (required), confirmar (required).
olist_grupo_tag_pesquisaC
Pesquisar Grupo de Tags API 2.0. Endpoint API V2: grupo.tag.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-grupos-tag-pesquisar
Inputs: pesquisa (required), pagina.
olist_incluir_nota_xmlA
Incluir Nota via XML API 2.0. Endpoint API V2: incluir.nota.xml. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-incluir-xml Esta operação altera dados e exige confirmar=true.
Inputs: xml (required), confirmar (required), lancarContas, lancarEstoque, +2 more.
olist_infoA
Obter informações da conta API 2.0. Endpoint API V2: info. Documentação: https://tiny.com.br/api-docs/api2-info
Inputs: no named parameters.
olist_inscricao_incluirC
Inscrição API 2.0. Endpoint API V2: inscricao.incluir. Documentação: https://tiny.com.br/api-docs/api2-inscricao-incluir Esta operação altera dados e exige confirmar=true.
Inputs: confirmar (required).
olist_listas_precos_excecoesD
Exceções das Listas de Preços API 2.0. Endpoint API V2: listas.precos.excecoes. Documentação: https://tiny.com.br/api-docs/api2-listas-precos-excecoes
Inputs: idListaPreco (required), pagina, idProduto.
olist_listas_precos_pesquisaC
Pesquisar Listas de Preços API 2.0. Endpoint API V2: listas.precos.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-listas-precos-pesquisar
Inputs: pagina, pesquisa.
olist_nota_fiscal_cadastrar_codigo_rastreamentoC
Atualizar informações de despacho API 2.0. Endpoint API V2: nota.fiscal.cadastrar.codigo.rastreamento. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-cadastrar-codigo-rastreamento
Inputs: notafiscal (required).
olist_nota_fiscal_consumidor_incluirB
Incluir Nota Fiscal ConsumidorAPI 2.0. Endpoint API V2: nota.fiscal.consumidor.incluir. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-consumidor-incluir Esta operação altera dados e exige confirmar=true.
Inputs: nota (required), confirmar (required).
olist_nota_fiscal_emitirB
Emitir Nota Fiscal API 2.0. Endpoint API V2: nota.fiscal.emitir. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-emitir Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required), serie, numero, +1 more.
olist_nota_fiscal_incluirB
Incluir Nota Fiscal API 2.0. Endpoint API V2: nota.fiscal.incluir. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-incluir Esta operação altera dados e exige confirmar=true.
Inputs: nota (required), confirmar (required), preValidarNota.
olist_nota_fiscal_lancar_contasC
Lançar Contas da Nota Fiscal API 2.0. Endpoint API V2: nota.fiscal.lancar.contas. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-lancar-contas Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required).
olist_nota_fiscal_lancar_estoqueB
Lançar Estoque da Nota Fiscal API 2.0. Endpoint API V2: nota.fiscal.lancar.estoque. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-lancar-estoque Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required).
olist_nota_fiscal_obterC
Obter Nota Fiscal API 2.0. Endpoint API V2: nota.fiscal.obter. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-obter
Inputs: id (required).
olist_nota_fiscal_obter_linkC
Obter Link da Nota Fiscal API 2.0. Endpoint API V2: nota.fiscal.obter.link. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-obter-link
Inputs: id (required).
olist_nota_fiscal_obter_xmlC
Obter XML da Nota Fiscal API 2.0. Endpoint API V2: nota.fiscal.obter.xml. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-obter-xml
Inputs: id (required).
olist_nota_servico_consultarC
Consultar uma NFS-e API 2.0. Endpoint API V2: nota.servico.consultar. Documentação: https://tiny.com.br/api-docs/api2-notas-servico-consultar
Inputs: id (required), enviarEmail (required).
olist_nota_servico_enviarA
Enviar uma NFS-e API 2.0. Endpoint API V2: nota.servico.enviar. Documentação: https://tiny.com.br/api-docs/api2-notas-servico-enviar Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required), enviarEmail (required).
olist_nota_servico_incluirA
Incluir Nota de Serviço API 2.0. Endpoint API V2: nota.servico.incluir. Documentação: https://tiny.com.br/api-docs/api2-notas-servico-incluir Esta operação altera dados e exige confirmar=true.
Inputs: nota (required), confirmar (required).
olist_nota_servico_obterC
Obter Nota de Serviço API 2.0. Endpoint API V2: nota.servico.obter. Documentação: https://tiny.com.br/api-docs/api2-notas-servico-obter
Inputs: id (required).
olist_notas_fiscais_pesquisaC
Pesquisar Notas Fiscais API 2.0. Endpoint API V2: notas.fiscais.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-notas-fiscais-pesquisar
Inputs: numero, pagina, cliente, cpf_cnpj, +8 more.
olist_notas_servico_pesquisaC
Pesquisar Notas de Serviço API 2.0. Endpoint API V2: notas.servico.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-notas-servico-pesquisar
Inputs: numero, pagina, cliente, cpf_cnpj, +6 more.
olist_pdv_cancelar_nota_xmlA
PDV - Cancelar Nota via XML API 2.0. Endpoint API V2: pdv.cancelar.nota.xml. Documentação: https://tiny.com.br/api-docs/api2-pdv-notas-cancelar-xml Esta operação altera dados e exige confirmar=true.
Inputs: xml (required), confirmar (required), serieNota (required), modeloNota (required), +3 more.
olist_pdv_incluir_nota_xmlB
PDV - Incluir Nota via XML API 2.0. Endpoint API V2: pdv.incluir.nota.xml. Documentação: https://tiny.com.br/api-docs/api2-pdv-notas-incluir-xml Esta operação altera dados e exige confirmar=true.
Inputs: xml (required), confirmar (required), lancarContas, lancarEstoque, +2 more.
olist_pdv_pedido_obterB
PDV - Obter Pedido API 2.0. Endpoint API V2: pdv.pedido.obter. Documentação: https://tiny.com.br/api-docs/api2-pdv-pedidos-obter
Inputs: id (required).
olist_pdv_pedidosC
PDV - Pesquisar Pedidos API 2.0. Endpoint API V2: pdv.pedidos. Documentação: https://tiny.com.br/api-docs/api2-pdv-pedidos-pesquisar
Inputs: pagina.
olist_pdv_produtosC
PDV - Pesquisar Produtos API 2.0. Endpoint API V2: pdv.produtos. Documentação: https://tiny.com.br/api-docs/api2-pdv-produtos-pesquisar
Inputs: pagina, pesquisa, situacao, dataUltimaSincronizacao.
olist_pedido_alterarC
Alterar Pedido API 2.0. Endpoint API V2: pedido.alterar. Documentação: https://tiny.com.br/api-docs/api2-pedidos-alterar Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required).
olist_pedido_estornar_contasC
Estornar Contas do Pedido API 2.0. Endpoint API V2: pedido.estornar.contas. Documentação: https://tiny.com.br/api-docs/api2-pedidos-estornar-contas Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required).
olist_pedido_estornar_estoqueA
Estornar Estoque do Pedido API 2.0. Endpoint API V2: pedido.estornar.estoque. Documentação: https://tiny.com.br/api-docs/api2-pedidos-estornar-estoque Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required).
olist_pedido_incluirA
Incluir Pedido API 2.0. Endpoint API V2: pedido.incluir. Documentação: https://tiny.com.br/api-docs/api2-pedidos-incluir Esta operação altera dados e exige confirmar=true.
Inputs: pedido (required), confirmar (required).
olist_pedido_lancar_contasC
Lançar Contas do Pedido API 2.0. Endpoint API V2: pedido.lancar.contas. Documentação: https://tiny.com.br/api-docs/api2-pedidos-lancar-contas Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required).
olist_pedido_lancar_estoqueC
Lançar Estoque do Pedido API 2.0. Endpoint API V2: pedido.lancar.estoque. Documentação: https://tiny.com.br/api-docs/api2-pedidos-lancar-estoque Esta operação altera dados e exige confirmar=true.
Inputs: id (required), confirmar (required).
olist_pedido_obterD
Obter Pedido API 2.0. Endpoint API V2: pedido.obter. Documentação: https://tiny.com.br/api-docs/api2-pedidos-obter
Inputs: id (required).
olist_pedidos_pesquisaC
Pesquisar Pedidos API 2.0. Endpoint API V2: pedidos.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-pedidos-pesquisar
Inputs: sort, numero, pagina, cliente, +12 more.
olist_produto_alterarB
Alterar Produto API 2.0. Endpoint API V2: produto.alterar. Documentação: https://tiny.com.br/api-docs/api2-produtos-alterar Esta operação altera dados e exige confirmar=true.
Inputs: produto (required), confirmar (required).
olist_produto_atualizar_estoqueB
Atualizar estoque do produto API 2.0. Endpoint API V2: produto.atualizar.estoque. Documentação: https://tiny.com.br/api-docs/api2-produtos-atualizar-estoque Esta operação altera dados e exige confirmar=true.
Inputs: estoque (required), confirmar (required).
olist_produto_atualizar_precosA
Atualizar preços do produto API 2.0. Endpoint API V2: produto.atualizar.precos. Documentação: https://tiny.com.br/api-docs/api2-produtos-atualizar-precos Esta operação altera dados e exige confirmar=true.
Inputs: confirmar (required).
olist_produto_incluirB
Incluir Produto API 2.0. Endpoint API V2: produto.incluir. Documentação: https://tiny.com.br/api-docs/api2-produtos-incluir Esta operação altera dados e exige confirmar=true.
Inputs: produto (required), confirmar (required).
olist_produto_obterC
Obter Produto API 2.0. Endpoint API V2: produto.obter. Documentação: https://tiny.com.br/api-docs/api2-produtos-obter
Inputs: id (required).
olist_produto_obter_estoqueC
Obter Estoque Produto API 2.0. Endpoint API V2: produto.obter.estoque. Documentação: https://tiny.com.br/api-docs/api2-produtos-estoque
Inputs: id (required).
olist_produto_obter_estruturaC
Obter Estrutura do Produto API 2.0. Endpoint API V2: produto.obter.estrutura. Documentação: https://tiny.com.br/api-docs/api2-produtos-estrutura
Inputs: id (required).
olist_produtos_categorias_arvoreA
Obter Árvore de Categorias dos Produtos API 2.0. Endpoint API V2: produtos.categorias.arvore. Documentação: https://tiny.com.br/api-docs/api2-produtos-categorias-arvore
Inputs: no named parameters.
olist_produtos_pesquisaC
Pesquisar Produtos API 2.0. Endpoint API V2: produtos.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-produtos-pesquisar
Inputs: pesquisa (required), gtin, idTag, pagina, +3 more.
olist_separacao_alterar_situacaoA
Alterar Situação de uma Separação API 2.0. Endpoint API V2: separacao.alterar.situacao. Documentação: https://tiny.com.br/api-docs/api2-separacao-alterar-situacao Esta operação altera dados e exige confirmar=true.
Inputs: situacao (required), confirmar (required), idSeparacao (required).
olist_separacao_obterC
Obter Separação API 2.0. Endpoint API V2: separacao.obter. Documentação: https://tiny.com.br/api-docs/api2-separacao-obter
Inputs: idSeparacao (required).
olist_separacao_pesquisaC
Pesquisar Separações API 2.0. Endpoint API V2: separacao.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-separacao-pesquisar
Inputs: pagina, situacao, dataFinal, formaEnvio, +1 more.
olist_tag_alterarB
Alterar Tag API 2.0. Endpoint API V2: tag.alterar. Documentação: https://tiny.com.br/api-docs/api2-tags-alterar Esta operação altera dados e exige confirmar=true.
Inputs: tag (required), confirmar (required).
olist_tag_incluirB
Incluir Tag API 2.0. Endpoint API V2: tag.incluir. Documentação: https://tiny.com.br/api-docs/api2-tags-incluir Esta operação altera dados e exige confirmar=true.
Inputs: tag (required), confirmar (required).
olist_tag_pesquisaC
Pesquisar Tag API 2.0. Endpoint API V2: tag.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-tags-pesquisar
Inputs: pagina, idGrupo, pesquisa.
olist_vendedores_pesquisaC
Pesquisar Vendedores API 2.0. Endpoint API V2: vendedores.pesquisa. Documentação: https://tiny.com.br/api-docs/api2-vendedores-pesquisar
Inputs: pesquisa (required), pagina.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 92 tools
Most tools target distinct resource-action pairs (e.g., contato vs produto vs pedido), but there are overlapping invoice operations (nota_fiscal_incluir, nota_fiscal_consumidor_incluir, incluir_nota_xml, pdv_incluir_nota_xml) and inconsistent search variants (expedicao_pesquisa vs expedicao_pesquisar_agrupamentos) that could mislead an agent. The 92-tool scale also makes it hard to select the right tool without deep inspection.
The 'olist_' prefix is consistent, but the pattern mixes noun forms (pesquisa, lista, excecoes, info) with infinitive verbs (pesquisar, incluir, obter, alterar) and sometimes places verbs before the object (incluir_nota_xml vs nota_fiscal_incluir). Some tools are pure nouns (pdv_pedidos, pdv_produtos), and 'pesquisar' appears only once while all other searches use 'pesquisa'.
92 tools is far beyond the practical range for a coherent MCP server, making discovery and selection extremely difficult. Even for a broad ERP API, the tool set should be consolidated (e.g., grouping operations by resource or using parameters) to remain navigable.
The server covers many domains (contracts, products, CRM, orders, invoices, expedition), but lifecycle coverage is inconsistent: many resources have create/get/update/search but no delete (products, contacts, orders, invoices), while others (vendedores, formas_recebimento) are read-only. This leaves dead ends and prevents full workflows without external workarounds.
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn extensible MCP server that integrates Odoo with LLMs to enable querying and managing business data like partners, quotations, and sales orders. It supports custom tool registration and multiple transport protocols for both local and remote communication.2MIT
- AlicenseNot gradedqualityDmaintenanceA generic MCP server that dynamically converts OpenAPI-defined REST APIs into tools for LLMs like Claude. It supports multiple authentication methods and transport protocols, enabling seamless interaction with any OpenAPI-compliant API.18 npmMIT
- FlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that enables LLM agents to interact with PyerP ERP systems via a REST API. It allows users to search, read, create, and update ERP records such as inventory, clients, and users using natural language.-
- AlicenseNot gradedqualityDmaintenanceA generic MCP server that builds its tools at runtime from any OpenAPI specification, enabling interaction with any REST API through natural language.MIT