1. Conduid
  2. AI
  3. tiendanube-server
MCP server · AI

tiendanube-server

by · github.com/PedroHSGuimaraes/--Tiendanube-mcp-server

Model Context Protocol server for Tienda Nube API integration

Unclaimed last commit a year ago mcptiendanubenuvemshopecommerceapiintegrationmodel-context-protocol
InstallView source
39Low

Scored yesterday · breakdown

About tiendanube-server

tiendanube-server is an MCP server published by git+PedroHSGuimaraes in the AI category: model Context Protocol server for Tienda Nube API integration.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

Install
npx tiendanube-mcp-server
Claude Code
claude mcp add tiendanube-mcp-server -- npx -y tiendanube-mcp-server
npx
npx -y tiendanube-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about tiendanube-server

Powered by Claude · Grounded in docs

I know everything about tiendanube-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

4 checks have not been run yet.

README

Tienda Nube MCP Server

Servidor MCP (Model Context Protocol) para integrar com a API da Tienda Nube/Nuvemshop.

Este servidor expõe ferramentas MCP abrangendo os principais recursos da API v1:

  • Autenticação e informações da loja: tiendanube_get_store_info
  • Produtos: listar, buscar, obter, criar, atualizar, excluir
  • Pedidos: listar, obter, criar, atualizar, cancelar, fulfillment
  • Clientes: listar, buscar, obter, criar, atualizar, excluir
  • Categorias: listar, obter, criar, atualizar, excluir
  • Cupons: listar, obter, criar, atualizar, excluir
  • Webhooks: listar, obter, criar, atualizar, excluir

Requisitos

  • Node.js 18+
  • Variáveis de ambiente:
    • TIENDANUBE_ACCESS_TOKEN (obrigatório)
    • TIENDANUBE_STORE_ID (obrigatório)

Instalação

  • Instale as dependências: npm install
  • Compile o projeto: npm run build

Execução

  • Stdio (MCP padrão): npm start
  • HTTP utilitário: npm run start:http (endpoint de saúde em /health)

Configuração do Cliente MCP Adicione no seu cliente MCP (por exemplo, Claude Desktop) apontando para o binário ou para node dist/index.js.

Ferramentas Disponíveis Liste as ferramentas via MCP (ListTools). O servidor registra mais de 35 ferramentas cobrindo:

  • tiendanube_*product*
  • tiendanube_*order*
  • tiendanube_*customer*
  • tiendanube_*category*
  • tiendanube_*coupon*
  • tiendanube_*webhook*

Exemplos de Uso (MCP CallTool)

  • Obter info da loja: tiendanube_get_store_info
  • Listar produtos: tiendanube_list_products (args opcionais: page, per_page, language, q, etc.)
  • Criar produto: tiendanube_create_product (campos multilíngues e variantes suportados)
  • Listar pedidos: tiendanube_list_orders (filtros por status, pagamento, datas)
  • Criar pedido: tiendanube_create_order (cliente, itens, endereços)
  • Gerenciar webhooks: tiendanube_list_webhooks | tiendanube_create_webhook | tiendanube_update_webhook | tiendanube_delete_webhook

Notas Importantes

  • Rate limit e backoff: o cliente implementa retry para 429/5xx.
  • Serialização segura: respostas são sanitizadas para JSON.
  • Multi‑idioma: diversos campos aceitam es, pt, en.

Problemas e Próximos Passos Se você precisar de recursos extras da documentação oficial (por exemplo, operações dedicadas para variantes ou imagens fora do payload do produto), abra uma issue ou peça aqui que eu adiciono as ferramentas MCP correspondentes.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About tiendanube-server

How do I install tiendanube-server?

Run npx tiendanube-mcp-server, then add the server to your MCP client's configuration.

Is tiendanube-server safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 1 of the 2 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is tiendanube-server still maintained?

The last commit was a year ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.