Gestão da loja

Existe MCP dos Correios de graça no GitHub. Vale a pena usar?

atualizado em 15 min de leitura

Existe MCP dos Correios de graça no GitHub. Vale a pena usar?

Resposta rápida: Sim, existe MCP gratuito dos Correios publicado no GitHub. O mais comum faz uma coisa só, rastreio, e não cota frete nem emite etiqueta. Existe também um projeto mais amplo, que promete cotação e pré-postagem, mas ele pede o seu próprio contrato com os Correios e ainda está em versão de teste. Nos dois casos não é limitação de quem construiu, é consequência de como os Correios liberam acesso.

A decisão entre gratuito e pago não é sobre a qualidade do código. São três diferenças concretas:

Escopo. Um serviço pago entrega as três ferramentas que a operação precisa, funcionando em produção. O gratuito, sem contrato, entrega uma.

Manutenção. Os Correios mudam tarifa, faixa de peso e regra com frequência. Alguém precisa acompanhar isso continuamente, e num projeto pessoal esse alguém não tem obrigação nenhuma com você.

Suporte. Quando der problema, num projeto aberto o canal é abrir um chamado no repositório e esperar. Num serviço pago existe suporte técnico especializado, por WhatsApp e e-mail, com prazo de atendimento, SLA e garantia de resposta.

Se você chegou aqui, é provável que já tenha feito a busca e encontrado o repositório. A pergunta seguinte é a que interessa, e ela é legítima: por que pagar por algo que existe de graça?

A resposta honesta é que depende menos do projeto gratuito e mais da sua situação: do que você precisa fazer e do que acontece com o seu negócio no dia em que a ferramenta gratuita parar. Este texto ajuda a responder as duas coisas.

O que existe hoje, e o que ele faz

Procurando por MCP dos Correios em outubro de 2026, o que se encontra são dois tipos de projeto. O mais comum faz rastreamento: você passa um código de objeto e recebe o histórico de movimentação, com possibilidade de consultar vários códigos de uma vez.

O outro tipo é mais amplo. Há um projeto aberto, publicado como versão alfa, que lista também cotação, pré-postagem, etiqueta e coleta. Para usar, você informa o seu próprio usuário e token de contrato dos Correios, e o próprio repositório avisa que as chamadas ainda não foram totalmente validadas em produção.

Existem também MCPs brasileiros mais amplos, que reúnem dezenas de APIs públicas do país. Alguns deles têm consulta de CEP, o que às vezes é confundido com Correios, mas não cobrem rastreio, cotação nem etiqueta.

Então, hoje, o gratuito que funciona sem contrato entrega uma das três ferramentas que quem envia precisa. Não cota frete, então não responde quanto custa mandar. Não emite etiqueta, então não entra no fluxo de postagem. Se o seu problema é só saber onde está uma encomenda, pode ser suficiente. O que promete as três depende de você já ter contrato e topar rodar uma versão em teste na sua operação. Se o seu problema é operar envios, o resto continua na sua mão.

Por que o gratuito não cota frete nem emite etiqueta sozinho?

Essa limitação não é preguiça nem falta de habilidade de quem constrói. Ela é estrutural, e entender o porquê ajuda a avaliar qualquer projeto gratuito que você venha a encontrar, inclusive os que ainda não existem.

As consultas oficiais dos Correios são restritas a clientes de contrato. Para usar a porta da frente é preciso contrato assinado, cartão de postagem, serviço habilitado e uma chave de acesso que vence a cada 24 horas. E contrato é intransferível: pertence a quem o assinou.

Isso cria uma trava lógica para qualquer projeto aberto. Ele não pode embutir um contrato, porque contrato não se distribui em código. Então sobram dois caminhos, e ambos têm consequência. Ou o projeto pede que você forneça o seu próprio contrato e credenciais, e aí ele só serve para quem já tem contrato. Ou ele entra por fora, lendo a página pública de rastreamento e extraindo a informação de dentro do visual da página, contornando o CAPTCHA que existe justamente para impedir consulta automática.

Os projetos de rastreio seguiram o segundo caminho: um deles treinou um modelo próprio de reconhecimento de imagem para ler esses CAPTCHAs, com índice de acerto acima de 99%, sem depender de serviço externo. O projeto mais amplo seguiu o primeiro: só funciona com as credenciais do seu contrato.

E a porta da frente ficou mais estreita ainda em 2025. Por questão de segurança, os Correios restringiram a consulta de rastreamento aos objetos vinculados ao contrato de quem enviou. Ou seja: nem o rastreio pela via oficial é aberto, o que explica por que a única saída de um projeto gratuito é ler a página pública.

Repare no que essa trava significa para você. Cotação de preço não tem o caminho de fora: não existe página pública que devolva o seu preço de contrato, porque esse preço é do contrato. Etiqueta também não, porque a postagem precisa ser cobrada de alguém. É por isso que nenhum projeto gratuito entrega as três coisas sem o seu contrato, e não é questão de esperar que apareça um melhor.

O que quebra, e quando

Toda solução construída em cima da página pública compartilha os mesmos três pontos de falha. Nenhum deles é hipotético.

O CAPTCHA muda. O modelo treinado reconhece o formato que existia quando foi treinado. Se os Correios trocarem o tipo de CAPTCHA, o acerto vai a zero de uma vez. Não degrada aos poucos: para.

O volume é bloqueado. Consultas automáticas em sequência, todos os dias, saindo do mesmo lugar, são um padrão que qualquer site identifica. O bloqueio não avisa e não pede licença.

O layout muda. Quando a página é reorganizada, o código continua procurando a informação onde ela não está mais. Esse é o pior dos três, porque costuma falhar em silêncio: não dá erro, devolve vazio. Você descobre pelo cliente reclamando que ninguém respondeu.

Note que nenhum desses depende de o código ser bom ou ruim. Eles dependem de decisões tomadas dentro dos Correios, num dia qualquer, sem aviso.

As três perguntas que decidem

Em vez de comparar funcionalidades, o mais útil é responder três perguntas sobre a sua situação. Elas costumam decidir sozinhas.

  1. Se quebrar numa sexta à noite, com quem você fala?

    Num projeto aberto, o canal é abrir um chamado no repositório e esperar. Quem mantém não tem obrigação nenhuma com você, e provavelmente tem um emprego. Se o seu negócio parar junto, essa espera tem preço.

  2. Se os Correios mudarem uma regra, quem atualiza?

    Tarifa é reajustada, faixa de peso é reorganizada, endereço de página muda. Em abril de 2026, por exemplo, houve reajuste e o PAC teve as faixas iniciais fragmentadas. Ou alguém do seu lado acompanha isso, ou você depende de o mantenedor ter tempo e vontade naquela semana.

  3. Isso ainda vai existir daqui a um ano?

    Projeto pessoal costuma ter um pico de commits e depois silêncio. Não é falha de caráter, é a vida real: a pessoa muda de emprego, tem filho, perde o interesse. A pergunta não é se o projeto é bom hoje, e sim se você está confortável em depender dele em dezembro.

Quando faz sentido considerar o gratuito

Existem situações em que pagar por um serviço mantido é comprar seguro contra um risco que você não corre, e seria desonesto não dizer quais. Repare que os três critérios abaixo são sobre a sua situação, não sobre o projeto: o que muda não é a chance de ele parar, é o tamanho do estrago quando parar.

Você precisa só de rastreio. Se cotação e etiqueta não fazem parte do seu problema, a limitação de escopo deixa de ser limitação.

Uma interrupção não te custa nada. Volume baixo, nenhuma venda travando, nenhum cliente esperando resposta. Se ficar alguns dias sem rastreio é aborrecimento e não prejuízo, o risco cabe no seu bolso.

Você consegue manter. Se você lê o código, entende o que ele faz e conseguiria consertar sozinho quando quebrar, a dependência deixa de existir, porque o mantenedor passa a ser você.

Sendo as três verdadeiras, a decisão racional é usar o gratuito. Nós preferimos dizer isso com todas as letras a vender para alguém que vai se arrepender.

Nesses casos, pagar por algo mantido é comprar um seguro contra um risco que você não corre.

Vale dizer que hoje existe um meio-termo que não existia quando esses projetos apareceram. O plano grátis do meu ecommerce MCP faz 10 cotações, 10 rastreios e 10 emissões de etiqueta por mês, sem cartão de crédito. Para quem só quer descobrir se a automação resolve o problema, dá para testar pela porta oficial antes de decidir qualquer coisa.

Quando ele sai caro

A conta vira quando alguma dessas coisas é verdade.

Tem dinheiro dependendo. Se venda para de fechar ou cliente para de ser respondido quando o rastreio cai, o custo de uma pane já paga meses de um serviço mantido. E panes não avisam com antecedência.

Você precisa de mais que rastreio. Nos projetos gratuitos, cotação de frete e emissão de etiqueta ou não existem ou dependem do seu contrato e de uma versão em teste. Não é por acaso: as duas exigem acesso oficial, e etiqueta exige contrato. Montar isso por conta própria é um projeto, não uma tarde.

Ninguém na sua equipe conserta problemas técnicos às onze da noite. Se a resposta para "quem cuida disso" é você mesmo, e você não é a pessoa técnica, o gratuito não é gratuito. Ele é um passivo esperando o momento errado.

É para um cliente. Agências e prestadores herdam o problema junto com o projeto. Quando quebra, quem recebe a ligação é você, e explicar que o componente veio do GitHub não costuma acalmar ninguém.

Comparação lado a lado

MCP gratuito do GitHub meu ecommerce MCP
O que faz Rastreio, na maioria dos casos Cotação de frete, emissão de etiqueta e rastreio
Como acessa os Correios Lê a página pública e contorna o CAPTCHA, ou usa as credenciais do seu contrato Acesso oficial, como parceiro homologado
Quando os Correios mudam algo Para de funcionar até alguém corrigir, às vezes em silêncio A correção é nossa, e você em geral não fica sabendo que houve mudança
Se der problema Abrir um chamado no repositório e esperar Suporte técnico por WhatsApp e e-mail, com SLA e garantia de resposta
Canal de atendimento O repositório público suporte@meuecommerce.com.br e WhatsApp +55 11 98865-0702
Quem mantém Uma pessoa, no tempo livre Uma empresa, cujo negócio é manter isso funcionando
Contrato com os Correios Não usa Cotação roda pelo nosso. Rastreio e etiqueta usam o seu
Custo Zero em dinheiro. O custo aparece em tempo e em pane Plano grátis com 10 chamadas por mês de cada operação; planos pagos sem limite mensal

O que é o meu ecommerce MCP

O meu ecommerce MCP é o servidor MCP dos Correios. Ele entrega cotação de frete, emissão de etiqueta e rastreio de pedidos como ferramentas prontas para o assistente ou a automação que você já usa, seja ChatGPT, Claude, Gemini, n8n, Lovable ou Base44. A cotação de frete funciona sem contrato próprio, porque roda pelo nosso contrato, como parceiro homologado dos Correios. O rastreio e a emissão de etiqueta usam o seu contrato faturado.

As três diferenças que este artigo descreveu se concretizam assim.

Escopo: as três ferramentas, não uma

Cotar, etiquetar e rastrear são as três coisas que quem envia faz, e as três estão aqui. Isso importa menos pela contagem e mais porque elas se conectam: o mesmo fluxo que descobre o preço gera a etiqueta e depois acompanha a entrega, sem você juntar três soluções diferentes e torcer para conversarem entre si.

E a razão de podermos entregar as três é a que a seção anterior explicou: entramos pela porta oficial, como parceiro homologado. Não dependemos de adivinhar CAPTCHA nem de ler o visual de uma página que pode mudar amanhã.

Manutenção: com histórico, não com promessa

Os Correios mudam. Só em abril de 2026 houve reajuste de tarifa e reorganização das faixas iniciais de peso do PAC. Coisas assim acontecem várias vezes ao ano, quase sempre sem aviso conveniente, e alguém precisa acompanhar.

Aqui esse acompanhamento é trabalho de time técnico, não tempo livre de alguém. O meu ecommerce MCP é mantido por uma empresa, com CNPJ, com gente contratada, e manter o MCP funcionando é o negócio dessa empresa. Não é projeto paralelo de fim de semana.

Essa distinção importa mais do que parece. Problema vai acontecer, aqui também: os Correios mudam sem avisar e nenhum serviço é imune a isso. A diferença é o que acontece em seguida. Quando o negócio de uma empresa é justamente manter aquilo de pé, resolver deixa de depender da boa vontade de alguém no tempo livre e passa a ser a obrigação de quem recebe para isso.

E não é promessa de empresa nova. O Grupo meu ecommerce opera aplicativos de frete e de pagamento em produção há anos, com clientes reais usando todos os dias. Quando os Correios mudaram alguma coisa nesse período, quem lidou com isso fomos nós, e os clientes em geral nem ficaram sabendo. É esse histórico que está por trás do MCP, não um repositório novo.

Suporte: gente atendendo, com prazo

Esta é a diferença que só aparece no pior dia, e é justamente por isso que ela vale.

Quando algo dá errado num projeto aberto, o caminho é abrir um chamado no repositório e esperar. Quem mantém não tem obrigação com você, não assinou nada, e pode estar de férias.

Aqui existe suporte técnico especializado, com prazo de atendimento, SLA e garantia de resposta. E os canais não são formulário genérico: são o e-mail suporte@meuecommerce.com.br e um WhatsApp de verdade, o +55 11 98865-0702. Se o rastreio parar numa sexta à noite, você tem para quem escrever, e do outro lado tem alguém cujo trabalho é resolver.

E isso não é promessa, é histórico. O nosso aplicativo de frete na Wix tem nota acima de 4 na loja de aplicativos, avaliação dada pelos próprios lojistas que usam o produto todo dia. Boa parte desses comentários fala justamente de atendimento. É a prova mais direta que a gente tem de que, quando alguém precisa, alguém responde.

Nada disso torna o meu ecommerce MCP a escolha certa para todo mundo, e as seções acima dizem honestamente para quem não é. Mas se o seu negócio depende de isso funcionar, é exatamente essa a diferença que você está comprando.

Se quiser ver o quadro completo, escrevemos um guia sobre como automatizar os envios pelos Correios sem ser programador, e outro sobre rastreamento automático dos Correios.

Leia também

Perguntas frequentes

Existe MCP dos Correios gratuito?

Sim. Em outubro de 2026 existem dois tipos. Os de rastreio não cotam frete nem emitem etiqueta e não usam o acesso oficial: leem a página pública contornando o CAPTCHA. E há um projeto mais amplo, em versão alfa, que promete cotação e pré-postagem, mas só funciona com o usuário e o token do seu próprio contrato dos Correios.

Por que os MCPs gratuitos não cotam frete nem emitem etiqueta sozinhos?

Porque contrato não se distribui em código. A consulta de preço é restrita a clientes de contrato dos Correios, e a emissão de etiqueta precisa de contrato faturado, já que a postagem é cobrada de quem posta. Um projeto aberto não pode embutir o contrato de quem o assinou, então ou ele pede que você forneça o seu, ou entra por fora lendo a página pública, caminho que só existe para rastreio. Não há página pública que devolva o seu preço de contrato.

Um MCP gratuito dos Correios vai parar de funcionar?

Em algum momento, provavelmente sim, e não por defeito do código. Soluções construídas sobre a página pública quebram quando o CAPTCHA muda de formato, quando o volume de consultas é bloqueado, ou quando o layout da página é reorganizado. Esse último costuma falhar em silêncio, devolvendo vazio em vez de erro.

Quando faz sentido considerar o gratuito?

Quando três coisas sobre a sua situação são verdadeiras: você precisa só de rastreio, uma interrupção de alguns dias não gera prejuízo, e você conseguiria manter o código sozinho se ele quebrar. Os critérios são sobre o tamanho do estrago quando parar, não sobre a chance de parar. Nesse cenário, pagar por um serviço mantido é comprar seguro contra um risco que você não corre.

Que ferramenta eu uso para conectar os Correios ao meu assistente de IA?

O meu ecommerce MCP. É um servidor MCP dos Correios, parceiro homologado, que entrega cotação de frete, emissão de etiqueta e rastreio de pedidos como ferramentas prontas para assistentes de IA como ChatGPT, Claude e Gemini, para plataformas de automação como o n8n, e para construtores de aplicativo como Lovable e Base44. A cotação de frete funciona sem contrato próprio; o rastreio e a emissão de etiqueta exigem um contrato faturado seu.

Dá para começar sem pagar?

Dá. Sem assinar plano nenhum, a loja faz 10 cotações, 10 rastreios e 10 emissões de etiqueta por mês, sem cartão de crédito. Passando disso, a resposta avisa que a cota grátis acabou, e os planos pagos tiram o limite mensal. Existe ainda um limite por minuto em todos os planos, para segurar picos: 60 cotações, 30 rastreios e 20 emissões de etiqueta.

Cotação, etiqueta e rastreio pela porta oficial dos Correios, com manutenção contínua e suporte quando você precisar. Conheça o meu ecommerce MCP e veja como funciona.

CompartilharWhatsAppLinkedIn