Skip to main content
Glama

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_pesquisa e olist_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 start

O 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" }

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 build

O 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 build

Para 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 tools
olist_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_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

    C2.4/5.0

    Scored across 92 tools

    Disambiguation3/5

    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.

    Naming Consistency2/5

    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'.

    Tool Count1/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      An 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A generic MCP server that builds its tools at runtime from any OpenAPI specification, enabling interaction with any REST API through natural language.
      MIT