Gestão da loja

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

14 min de leitura

Resposta rápida: Sim, existe MCP gratuito dos Correios publicado no GitHub. Ele se propõe a uma coisa, rastreio, e não vai além disso: não cota frete e não emite etiqueta. E 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. O gratuito 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 setembro de 2026, o que se encontra é essencialmente um projeto dedicado ao assunto, e ele 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.

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 que o gratuito 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. Se o seu problema é operar envios, o resto continua na sua mão.

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

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.

O projeto disponível hoje seguiu o segundo caminho: 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.

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

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. Cotação de frete e emissão de etiqueta não estão nos projetos gratuitos, e 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 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@meufrete.io 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 Mensalidade previsível

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@meufrete.io 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 setembro de 2026, o que existe é essencialmente um projeto dedicado aos Correios, e ele cobre apenas rastreamento: não cota frete e não emite etiqueta. Ele não usa o acesso oficial, que exige contrato, e sim lê a página pública contornando o CAPTCHA.

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

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.

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