Meu Ecommerce

io.github.meuecommercev1.0.1Updated Oct 7, 2026

Brazil's Correios for AI agents: shipping quotes (frete), tracking (rastreio) and labels (etiqueta).

VerifiedStreamable HTTPWeb executableBusiness & CommerceProductivity & Workflow

Overview

AI-generated overview

Connects an assistant to a Meu Ecommerce store for Correios shipping quotes, parcel tracking and shipping labels.

What it does
A hosted remote MCP server that links an AI assistant to a Meu Ecommerce store and Brazil's Correios. It exposes tools to quote shipping rates for an order to a destination postal code, return tracking events for parcels, create a Correios pre-posting and generate a label, and download the PDF of an already generated label. Which tools are available depends on the store's credentials and configuration.
When to use it
Useful for Brazilian merchants or support teams that already run a Meu Ecommerce store and want an assistant to answer shipping cost and delivery time questions, check parcel tracking, or produce and fetch Correios labels without leaving the chat client.
Requirements
A remote Streamable HTTP endpoint; nothing to install locally. Authentication is OAuth (Authorization Code with PKCE S256 and dynamic client registration) or a store secret key sent as an Authorization Bearer header. Quotes need the store's origin postal code, shipping services and plan configured; labels additionally need the merchant's own authenticated Correios contract and label integration enabled.
Before you install
The store secret key is a credential: keep it in a secrets manager and out of prompts, repositories and browser code. Generating a label creates a real Correios pre-posting and may incur shipping costs or contractual obligations with Correios. Connecting does not unlock every operation, so tool availability depends on store setup.

Installation

In SourceWeft

  1. Open Meu Ecommerce 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.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "meuecommerce-mcp": {
      "type": "http",
      "url": "https://app.meuecommerce.com.br/mcp"
    }
  }
}

README

[Meu Ecommerce]

Meu Ecommerce MCP

Hosted remote MCP server that connects AI agents to Brazil's Correios through a Meu Ecommerce store: shipping quotes (frete), tracking (rastreio) and shipping labels (etiqueta), in a single connection.

text
https://app.meuecommerce.com.br/mcp
  • Transport: Streamable HTTP
  • Auth: OAuth (Authorization Code + PKCE S256, dynamic client registration) or a store secret key
  • Docs (Portuguese): dev.meuecommerce.com.br/docs/mcp

This repository only holds the server's public description (server.json), its logo and this guide. The server is a hosted service: there is nothing to install.

Tools

ToolWhat it does
get_shipping_ratesQuotes Correios shipping for an order to a destination CEP (postal code)
track_shipmentReturns the tracking events of Correios parcels
generate_labelCreates the Correios pre-posting (pré-postagem) and generates the label
get_label_pdfDownloads the PDF of a label already generated

Available tools depend on the store's credentials and setup. Connecting does not unlock every operation: quotes need the store's origin CEP, shipping services and plan configured; labels also need the merchant's own authenticated Correios contract.

Connect

  • OAuth clients (recommended, e.g. Claude): add a remote MCP server with the URL above and complete the store login and authorization in the browser.
  • Clients that accept headers: use Streamable HTTP and send the store secret key as Authorization: Bearer mk_YOUR_KEY. Keep it in a secrets manager, never in prompts, repositories or browser code.

OAuth discovery starts at https://app.meuecommerce.com.br/.well-known/oauth-protected-resource/mcp. A 401 before authorization is part of discovery.

Português

Servidor MCP remoto que conecta agentes de IA à sua loja Meu Ecommerce: cotação de frete, rastreamento de objetos e etiquetas dos Correios, em uma única conexão.

Ferramentas

FerramentaO que fazCapacidade
get_shipping_ratesCota o frete de um pedido para um CEP de destinoFretes e cotações
track_shipmentConsulta os eventos de rastreamento de objetosRastreamento
generate_labelCria a pré-postagem e gera a etiquetaEtiquetas e postagens
get_label_pdfBaixa o PDF de uma etiqueta já geradaEtiquetas e postagens

As ferramentas disponíveis dependem da credencial e da configuração da loja. Conectar o MCP não libera todas as operações:

  • Cotação: CEP de origem, serviços de envio e acesso ao plano configurados no painel.
  • Etiquetas: além disso, contrato próprio dos Correios autenticado e integração de etiquetas habilitada.

Configure a loja em app.meuecommerce.com.br/start.

Conectar

Clientes com OAuth (recomendado)
  1. Abra a área de conectores ou servidores MCP do seu cliente (por exemplo, Claude).
  2. Adicione um servidor remoto chamado Meu Ecommerce com a URL https://app.meuecommerce.com.br/mcp.
  3. Conclua o login e a autorização da loja no navegador.
  4. Volte ao cliente e confira as ferramentas disponíveis.
Clientes que aceitam headers

Configure o transporte Streamable HTTP e envie a chave secreta da loja:

http
Authorization: Bearer mk_SUA_CHAVE

Guarde a chave no gerenciador de segredos do ambiente. Nunca a inclua em prompts, repositórios ou código executado no navegador.

Primeiro teste

Cote o envio para o CEP 20040-002 de uma camiseta de algodão, quantidade 1, preço unitário R$ 89,90 e peso unitário 0,3 kg. Mostre os serviços, preços e prazos retornados.

Guia completo: Conecte seu agente.

Descoberta OAuth

  • Recurso protegido: https://app.meuecommerce.com.br/.well-known/oauth-protected-resource/mcp
  • Servidor de autorização: https://app.meuecommerce.com.br/.well-known/oauth-authorization-server

Um 401 antes da autorização faz parte da descoberta.

License / Licença

The documentation and files in this repository are under the MIT License. The server's source code is not distributed here.

A documentação e os arquivos deste repositório estão sob a licença MIT. O código do servidor não é distribuído aqui.

Source: README.md at commit 337400f

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.1LatestOct 7, 2026