Olist Tiny ERP — REST API skill

Você tem acesso à Olist Tiny ERP REST API na MCP.AI.

ERP de e-commerce Olist Tiny (ex-Tiny ERP) com a API REST oficial v3 completa, produtos, estoque, pedidos, notas fiscais (NF-e/NFC-e), contas a pagar e receber, contatos, expedição, ordens de compra e serviço, CRM e listas de preços. Consulta e operação. Pareia com o Banco MCP para conciliar banco e ERP. Você cria o aplicativo na sua conta Olist e autoriza com OAuth.

Base URL

https://api.mcp.ai/api/olist

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/olist/categorias/create \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/olist/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (179)

#### olist_categorias_create

Criar categoria de produto (POST /categorias). _(POST /api/olist/categorias/create)_

#### olist_categorias_delete

Excluir categoria de produto (DELETE /categorias/{idCategoria}). _(POST /api/olist/categorias/delete)_

#### olist_categorias_get

Obter categoria por identificador (GET /categorias/{idCategoria}). _(POST /api/olist/categorias/get)_

#### olist_categorias_receita_despesa_list

Listar categorias de receita e despesa (GET /categorias-receita-despesa). _(POST /api/olist/categorias/receita/despesa/list)_

#### olist_categorias_todas_list

Listar árvore de categorias (GET /categorias/todas). _(POST /api/olist/categorias/todas/list)_

#### olist_categorias_update

Editar categoria de produto (PUT /categorias/{idCategoria}). _(POST /api/olist/categorias/update)_

#### olist_contas_pagar_create

Criar conta a pagar (POST /contas-pagar). _(POST /api/olist/contas/pagar/create)_

#### olist_contas_pagar_get

Obter conta a pagar (GET /contas-pagar/{idContaPagar}). _(POST /api/olist/contas/pagar/get)_

#### olist_contas_pagar_list

Listar contas a pagar (GET /contas-pagar). _(POST /api/olist/contas/pagar/list)_

#### olist_contas_pagar_marcadores_create

Criar marcadores da conta a pagar (POST /contas-pagar/{idContaPagar}/marcadores). _(POST /api/olist/contas/pagar/marcadores/create)_

#### olist_contas_pagar_marcadores_delete

Excluir marcadores da conta a pagar (DELETE /contas-pagar/{idContaPagar}/marcadores). _(POST /api/olist/contas/pagar/marcadores/delete)_

#### olist_contas_pagar_marcadores_list

Obter marcadores da conta a pagar (GET /contas-pagar/{idContaPagar}/marcadores). _(POST /api/olist/contas/pagar/marcadores/list)_

#### olist_contas_pagar_marcadores_update

Atualizar marcadores da conta a pagar (PUT /contas-pagar/{idContaPagar}/marcadores). _(POST /api/olist/contas/pagar/marcadores/update)_

#### olist_contas_pagar_recebimentos_list

Obter recebimentos da conta a pagar (GET /contas-pagar/{idContaPagar}/recebimentos). _(POST /api/olist/contas/pagar/recebimentos/list)_

#### olist_contas_receber_baixar_create

Baixar uma conta a receber (POST /contas-receber/{idContaReceber}/baixar). _(POST /api/olist/contas/receber/baixar/create)_

#### olist_contas_receber_create

Criar conta a receber (POST /contas-receber). _(POST /api/olist/contas/receber/create)_

#### olist_contas_receber_get

Obter conta a receber (GET /contas-receber/{idContaReceber}). _(POST /api/olist/contas/receber/get)_

#### olist_contas_receber_list

Listar contas a receber (GET /contas-receber). _(POST /api/olist/contas/receber/list)_

#### olist_contas_receber_marcadores_create

Criar marcadores da conta a receber (POST /contas-receber/{idContaReceber}/marcadores). _(POST /api/olist/contas/receber/marcadores/create)_

#### olist_contas_receber_marcadores_delete

Excluir marcadores da conta a receber (DELETE /contas-receber/{idContaReceber}/marcadores). _(POST /api/olist/contas/receber/marcadores/delete)_

#### olist_contas_receber_marcadores_list

Obter marcadores da conta a receber (GET /contas-receber/{idContaReceber}/marcadores). _(POST /api/olist/contas/receber/marcadores/list)_

#### olist_contas_receber_marcadores_update

Atualizar marcadores da conta a receber (PUT /contas-receber/{idContaReceber}/marcadores). _(POST /api/olist/contas/receber/marcadores/update)_

#### olist_contas_receber_recebimentos_list

Obter recebimentos da conta a receber (GET /contas-receber/{idContaReceber}/recebimentos). _(POST /api/olist/contas/receber/recebimentos/list)_

#### olist_contas_receber_update

Atualizar conta a receber (PUT /contas-receber/{idContaReceber}). _(POST /api/olist/contas/receber/update)_

#### olist_contatos_create

Criar contato (POST /contatos). _(POST /api/olist/contatos/create)_

#### olist_contatos_get

Obter contato (GET /contatos/{idContato}). _(POST /api/olist/contatos/get)_

#### olist_contatos_list

Listar contatos (GET /contatos). _(POST /api/olist/contatos/list)_

#### olist_contatos_pessoas_create

Criar pessoa de contato (POST /contatos/{idContato}/pessoas). _(POST /api/olist/contatos/pessoas/create)_

#### olist_contatos_pessoas_delete

Excluir pessoa de contato (DELETE /contatos/{idContato}/pessoas/{idPessoa}). _(POST /api/olist/contatos/pessoas/delete)_

#### olist_contatos_pessoas_get

Obter pessoa de contato (GET /contatos/{idContato}/pessoas/{idPessoa}). _(POST /api/olist/contatos/pessoas/get)_

#### olist_contatos_pessoas_list

Listar pessoas de contato (GET /contatos/{idContato}/pessoas). _(POST /api/olist/contatos/pessoas/list)_

#### olist_contatos_pessoas_update

Atualizar pessoa de contato (PUT /contatos/{idContato}/pessoas/{idPessoa}). _(POST /api/olist/contatos/pessoas/update)_

#### olist_contatos_status_crm_update

Atualizar status CRM do contato (PUT /contatos/{idContato}/status-crm). _(POST /api/olist/contatos/status/crm/update)_

#### olist_contatos_tipos_list

Listar tipos de contatos (GET /contatos/tipos). _(POST /api/olist/contatos/tipos/list)_

#### olist_contatos_update

Atualizar contato (PUT /contatos/{idContato}). _(POST /api/olist/contatos/update)_

#### olist_crm_assuntos_acoes_create

Criar ação de assunto (POST /crm/assuntos/{idAssunto}/acoes). _(POST /api/olist/crm/assuntos/acoes/create)_

#### olist_crm_assuntos_acoes_delete

Deletar ação de um assunto (DELETE /crm/assuntos/{idAssunto}/acoes/{idAcao}). _(POST /api/olist/crm/assuntos/acoes/delete)_

#### olist_crm_assuntos_acoes_get

Obter ação de um assunto (GET /crm/assuntos/{idAssunto}/acoes/{idAcao}). _(POST /api/olist/crm/assuntos/acoes/get)_

#### olist_crm_assuntos_acoes_list

Listar ações de um assunto (GET /crm/assuntos/{idAssunto}/acoes). _(POST /api/olist/crm/assuntos/acoes/list)_

#### olist_crm_assuntos_acoes_update

Atualizar ação de assunto (PUT /crm/assuntos/{idAssunto}/acoes/{idAcao}). _(POST /api/olist/crm/assuntos/acoes/update)_

#### olist_crm_assuntos_anotacoes_create

Criar anotação de assunto (POST /crm/assuntos/{idAssunto}/anotacoes). _(POST /api/olist/crm/assuntos/anotacoes/create)_

#### olist_crm_assuntos_anotacoes_delete

Deletar anotação de assunto (DELETE /crm/assuntos/{idAssunto}/anotacoes/{idAnotacao}). _(POST /api/olist/crm/assuntos/anotacoes/delete)_

#### olist_crm_assuntos_anotacoes_list

Listar anotações de um assunto (GET /crm/assuntos/{idAssunto}/anotacoes). _(POST /api/olist/crm/assuntos/anotacoes/list)_

#### olist_crm_assuntos_anotacoes_update

Atualizar anotação de assunto (PUT /crm/assuntos/{idAssunto}/anotacoes/{idAnotacao}). _(POST /api/olist/crm/assuntos/anotacoes/update)_

#### olist_crm_assuntos_arquivar_update

Arquivar ou desarquivar assunto (PUT /crm/assuntos/{idAssunto}/arquivar). _(POST /api/olist/crm/assuntos/arquivar/update)_

#### olist_crm_assuntos_create

Criar assunto (POST /crm/assuntos). _(POST /api/olist/crm/assuntos/create)_

#### olist_crm_assuntos_delete

Deletar assunto (DELETE /crm/assuntos/{idAssunto}). _(POST /api/olist/crm/assuntos/delete)_

#### olist_crm_assuntos_estrela_update

Atualizar estrela do assunto (PUT /crm/assuntos/{idAssunto}/estrela). _(POST /api/olist/crm/assuntos/estrela/update)_

#### olist_crm_assuntos_get

Obter assunto (GET /crm/assuntos/{idAssunto}). _(POST /api/olist/crm/assuntos/get)_

#### olist_crm_assuntos_list

Listar assuntos (GET /crm/assuntos). _(POST /api/olist/crm/assuntos/list)_

#### olist_crm_assuntos_marcadores_create

Criar marcadores do assunto (POST /crm/assuntos/{idAssunto}/marcadores). _(POST /api/olist/crm/assuntos/marcadores/create)_

#### olist_crm_assuntos_marcadores_delete

Remover marcadores de um assunto (DELETE /crm/assuntos/{idAssunto}/marcadores). _(POST /api/olist/crm/assuntos/marcadores/delete)_

#### olist_crm_assuntos_marcadores_list

Listar marcadores de um assunto (GET /crm/assuntos/{idAssunto}/marcadores). _(POST /api/olist/crm/assuntos/marcadores/list)_

#### olist_crm_assuntos_marcadores_update

Atualizar marcadores do assunto (PUT /crm/assuntos/{idAssunto}/marcadores). _(POST /api/olist/crm/assuntos/marcadores/update)_

#### olist_crm_assuntos_update

Atualizar assunto (PUT /crm/assuntos/{idAssunto}). _(POST /api/olist/crm/assuntos/update)_

#### olist_crm_estagios_create

Criar estágio (POST /crm/estagios). _(POST /api/olist/crm/estagios/create)_

#### olist_crm_estagios_delete

Deletar estágio (DELETE /crm/estagios/{idEstagio}). _(POST /api/olist/crm/estagios/delete)_

#### olist_crm_estagios_get

Obter estágio (GET /crm/estagios/{idEstagio}). _(POST /api/olist/crm/estagios/get)_

#### olist_crm_estagios_list

Listar estágios (GET /crm/estagios). _(POST /api/olist/crm/estagios/list)_

#### olist_crm_estagios_update

Atualizar estágio (PUT /crm/estagios/{idEstagio}). _(POST /api/olist/crm/estagios/update)_

#### olist_depositos_get

Obter depósito de estoque por ID (GET /depositos/{idDeposito}). _(POST /api/olist/depositos/get)_

#### olist_depositos_list

Listar depósitos de estoque (GET /depositos). _(POST /api/olist/depositos/list)_

#### olist_estoque_create

Atualizar o estoque de um produto (POST /estoque/{idProduto}). _(POST /api/olist/estoque/create)_

#### olist_estoque_get

Obter o estoque de um produto (GET /estoque/{idProduto}). _(POST /api/olist/estoque/get)_

#### olist_expedicao_concluir_create

Concluir um agrupamento de expedição (POST /expedicao/{idAgrupamento}/concluir). _(POST /api/olist/expedicao/concluir/create)_

#### olist_expedicao_create

Criar agrupamento de expedição (POST /expedicao). _(POST /api/olist/expedicao/create)_

#### olist_expedicao_etiquetas_list

Obter etiquetas de um agrupamento de expedição (GET /expedicao/{idAgrupamento}/etiquetas). _(POST /api/olist/expedicao/etiquetas/list)_

#### olist_expedicao_expedicao_etiquetas_list

Obter etiquetas de uma expedição dentro de um agrupamento (GET /expedicao/{idAgrupamento}/expedicao/{idExpedicao}/etiquetas). _(POST /api/olist/expedicao/expedicao/etiquetas/list)_

#### olist_expedicao_expedicao_update

Alterar uma expedição dentro de um agrupamento (PUT /expedicao/{idAgrupamento}/expedicao/{idExpedicao}). _(POST /api/olist/expedicao/expedicao/update)_

#### olist_expedicao_get

Obter agrupamento de expedição (GET /expedicao/{idAgrupamento}). _(POST /api/olist/expedicao/get)_

#### olist_expedicao_list

Listar agrupamentos de expedição (GET /expedicao). _(POST /api/olist/expedicao/list)_

#### olist_expedicao_origens_create

Adicionar origens a um agrupamento de expedição (POST /expedicao/{idAgrupamento}/origens). _(POST /api/olist/expedicao/origens/create)_

#### olist_formas_envio_get

Obter forma de envio (GET /formas-envio/{idFormaEnvio}). _(POST /api/olist/formas/envio/get)_

#### olist_formas_envio_list

Listar formas de envio (GET /formas-envio). _(POST /api/olist/formas/envio/list)_

#### olist_formas_pagamento_get

Obter forma de pagamento (GET /formas-pagamento/{idFormaPagamento}). _(POST /api/olist/formas/pagamento/get)_

#### olist_formas_pagamento_list

Listar formas de pagamento (GET /formas-pagamento). _(POST /api/olist/formas/pagamento/list)_

#### olist_formas_recebimento_get

Obter forma de recebimento (GET /formas-recebimento/{idFormaRecebimento}). _(POST /api/olist/formas/recebimento/get)_

#### olist_formas_recebimento_list

Listar formas de recebimento (GET /formas-recebimento). _(POST /api/olist/formas/recebimento/list)_

#### olist_grupos_tags_list

Listar grupos de tags (GET /grupos-tags). _(POST /api/olist/grupos/tags/list)_

#### olist_info_list

Obter informações da conta da empresa (GET /info). _(POST /api/olist/info/list)_

#### olist_intermediadores_get

Obter intermediador (GET /intermediadores/{idIntermediador}). _(POST /api/olist/intermediadores/get)_

#### olist_intermediadores_list

Listar intermediadores (GET /intermediadores). _(POST /api/olist/intermediadores/list)_

#### olist_list_accounts

Lista as conexões (empresas) Olist vinculadas a este install — company_id, label. _(POST /api/olist/list/accounts)_

#### olist_listas_precos_create

Criar lista de preços (POST /listas-precos). _(POST /api/olist/listas/precos/create)_

#### olist_listas_precos_get

Obter lista de preços (GET /listas-precos/{idListaDePreco}). _(POST /api/olist/listas/precos/get)_

#### olist_listas_precos_list

Listar listas de preços (GET /listas-precos). _(POST /api/olist/listas/precos/list)_

#### olist_listas_precos_produtos_delete

Excluir produto de lista de preços (DELETE /listas-precos/{idListaDePreco}/produtos/{idProduto}). _(POST /api/olist/listas/precos/produtos/delete)_

#### olist_listas_precos_update

Atualizar lista de preços (PUT /listas-precos/{idListaDePreco}). _(POST /api/olist/listas/precos/update)_

#### olist_marcas_create

Criar marca (POST /marcas). [write, altera dados no ERP] _(POST /api/olist/marcas/create)_

#### olist_marcas_list

Listar marcas (GET /marcas). _(POST /api/olist/marcas/list)_

#### olist_marcas_update

Atualizar marca (PUT /marcas/{idMarca}). _(POST /api/olist/marcas/update)_

#### olist_notas_despacho_update

Atualizar informações de rastreamento da nota fiscal (PUT /notas/{idNota}/despacho). _(POST /api/olist/notas/despacho/update)_

#### olist_notas_emitir_create

Autorizar nota fiscal (POST /notas/{idNota}/emitir). _(POST /api/olist/notas/emitir/create)_

#### olist_notas_get

Obter nota fiscal (GET /notas/{idNota}). _(POST /api/olist/notas/get)_

#### olist_notas_itens_get

Obter item da nota fiscal (GET /notas/{idNota}/itens/{idItem}). _(POST /api/olist/notas/itens/get)_

#### olist_notas_lancar_contas_create

Lançar contas da nota fiscal (POST /notas/{idNota}/lancar-contas). _(POST /api/olist/notas/lancar/contas/create)_

#### olist_notas_lancar_estoque_create

Lançar estoque da nota fiscal (POST /notas/{idNota}/lancar-estoque). _(POST /api/olist/notas/lancar/estoque/create)_

#### olist_notas_link_list

Obter link da nota fiscal (GET /notas/{idNota}/link). _(POST /api/olist/notas/link/list)_

#### olist_notas_list

Listar notas fiscais (GET /notas). _(POST /api/olist/notas/list)_

#### olist_notas_marcadores_create

Criar marcadores da nota fiscal (POST /notas/{idNota}/marcadores). _(POST /api/olist/notas/marcadores/create)_

#### olist_notas_marcadores_delete

Excluir marcadores da nota fiscal (DELETE /notas/{idNota}/marcadores). _(POST /api/olist/notas/marcadores/delete)_

#### olist_notas_marcadores_list

Obter marcadores da nota fiscal (GET /notas/{idNota}/marcadores). _(POST /api/olist/notas/marcadores/list)_

#### olist_notas_marcadores_update

Atualizar marcadores da nota fiscal (PUT /notas/{idNota}/marcadores). _(POST /api/olist/notas/marcadores/update)_

#### olist_notas_nota_fiscal_consumidor_xml_create

Incluir nota fiscal de consumidor por XML (POST /notas/nota-fiscal-consumidor/xml). _(POST /api/olist/notas/nota/fiscal/consumidor/xml/create)_

#### olist_notas_xml_cancelar_create

Cancelar nota fiscal (POST /notas/xml/cancelar). _(POST /api/olist/notas/xml/cancelar/create)_

#### olist_notas_xml_create

Incluir nota fiscal por XML (POST /notas/xml). _(POST /api/olist/notas/xml/create)_

#### olist_notas_xml_fornecedor_create

Incluir nota fiscal de fornecedor por XML (POST /notas/xml/fornecedor). _(POST /api/olist/notas/xml/fornecedor/create)_

#### olist_notas_xml_list

Obter XML da nota fiscal (GET /notas/{idNota}/xml). _(POST /api/olist/notas/xml/list)_

#### olist_ordem_compra_create

Criar ordem de compra (POST /ordem-compra). _(POST /api/olist/ordem/compra/create)_

#### olist_ordem_compra_get

Obter ordem de compra (GET /ordem-compra/{idOrdemCompra}). _(POST /api/olist/ordem/compra/get)_

#### olist_ordem_compra_lancar_contas_create

Lançar contas da ordem de compra (POST /ordem-compra/{idOrdemCompra}/lancar-contas). _(POST /api/olist/ordem/compra/lancar/contas/create)_

#### olist_ordem_compra_lancar_estoque_create

Lançar estoque da ordem de compra (POST /ordem-compra/{idOrdemCompra}/lancar-estoque). _(POST /api/olist/ordem/compra/lancar/estoque/create)_

#### olist_ordem_compra_list

Listar ordens de compra (GET /ordem-compra). _(POST /api/olist/ordem/compra/list)_

#### olist_ordem_compra_marcadores_create

Criar marcadores da ordem de compra (POST /ordem-compra/{idOrdemCompra}/marcadores). _(POST /api/olist/ordem/compra/marcadores/create)_

#### olist_ordem_compra_marcadores_delete

Excluir marcadores da ordem de compra (DELETE /ordem-compra/{idOrdemCompra}/marcadores). _(POST /api/olist/ordem/compra/marcadores/delete)_