O que é Mastra?
O Mastra é um framework de agentes para TypeScript da equipe por trás do Gatsby. Ele cobre agentes, workflows tipados com novas tentativas e ramificações, memória, recuperação, evals e tracing em um único pacote.
O Mastra Studio é uma interface web local para testar agentes, acompanhar chamadas de ferramentas e mudar configurações de modelo. Os workflows podem pausar à espera de uma pessoa e retomar depois. O suporte a MCP vem embutido.
O núcleo passou da Elastic License para Apache 2.0 em julho de 2025. Os recursos enterprise nas pastas ee/, como RBAC e SSO, ficam sob uma licença comercial separada.
Quanto custa Mastra?
| Plano | Preço | O que inclui |
|---|---|---|
| Core | Free | Apache 2.0 |
| Starter | $0 | Plataforma hospedada |
| Teams | $250/month | Plataforma hospedada |
| Enterprise | Custom |
O núcleo é gratuito sob Apache 2.0; o código nas pastas ee/ exige uma licença Mastra Enterprise em produção. Plataforma hospedada do Mastra: Starter US$ 0, Teams US$ 250/mês, Enterprise sob medida; o Enterprise auto-hospedado é uma taxa anual fixa.
Mastra vale a pena?
O Mastra reúne agentes, workflows tipados, memória, recuperação, evals e tracing em um único pacote TypeScript, e para uma equipe de Node ou Next.js essa integração é o motivo para escolhê-lo. O motor de workflows, com novas tentativas, ramificações e pausas à espera de uma pessoa, preenche a lacuna que o LangGraph preenche em Python, e o Studio mostra chamadas de ferramentas e traces localmente em vez de em logs.
O ritmo é ao mesmo tempo a força e o risco. O @mastra/core foi da 1.72.0, em 30 de setembro, à 1.79.0, em 21 de outubro de 2026, sete versões menores em três semanas. Avaliadores no MakerStack e na DEV Community relatam que mudanças incompatíveis não são raras e que tutoriais de terceiros ficam atrás da API, e há cerca de 600 issues abertas.
Vale conhecer dois padrões. O Studio carrega análises do PostHog, a menos que MASTRA_TELEMETRY_DISABLED esteja definido. E, em outubro de 2026, um alerta de alta gravidade mostrou que o @mastra/server até a 1.75.0 permitia que uma única query string sem autenticação contaminasse todo o processo Node, vazando dados entre usuários; foi corrigido na 1.76.0, então quem serve o Mastra por HTTP deve estar em uma versão atual.
A licença é open core. O framework é Apache 2.0, mas autenticação, o construtor de agentes e os recursos de editor nas pastas ee/ têm código disponível e exigem licença paga em produção. A plataforma hospedada do Mastra cobra US$ 250 por mês pelo Teams, com 1M de eventos de observabilidade e 250 horas de CPU, e acrescenta 5,5% ao preço dos tokens de modelo, uma margem que pesa mais que a taxa da plataforma em volume.
Onde ele se destaca
Uma equipe SaaS de Next.js com quatro engenheiros
Adicionar um agente de suporte que lê a central de ajuda e abre tickets
Defina o agente e suas ferramentas em TypeScript, use o RAG do Mastra para a central de ajuda e um workflow com uma etapa de aprovação humana antes de criar o ticket. O framework é gratuito; fixe a versão do @mastra/core, porque versões menores saem toda semana.
Um engenheiro de plataforma em uma fintech
Rodar workflows de documentos em várias etapas que precisam sobreviver a falhas e esperar revisores
Use workflows tipados com novas tentativas, ramificações e suspend/resume, guardando o estado no Postgres em vez do padrão em memória. SSO e RBAC em volta disso entram na licença Enterprise, cobrada como taxa anual fixa.
Um gerente de engenharia orçando um backend de agentes hospedado
Decidir entre a plataforma do Mastra e a auto-hospedagem
O Teams custa US$ 250 por mês por 1M de eventos de observabilidade, 250 horas de CPU e 100 GB de saída de dados, depois US$ 8 por 100K eventos e US$ 0,25 por hora de CPU; um servidor sempre ligado custa US$ 100 por projeto. Os tokens são cobrados a preço de mercado mais 5,5%, então, com gasto alto em modelos, auto-hospedar o núcleo de código aberto costuma sair mais barato.
Antes de decidir
- Configuração
- npm create mastra@latest cria a estrutura de um projeto e abre o Studio localmente; o @mastra/core declara Node 22.13 ou posterior, e o Node 22.18 ou posterior executa os arquivos TypeScript diretamente. O primeiro agente sai em minutos, embora a documentação não dê estimativa de tempo.
- Integrações
- Provedores de modelos, cliente e servidor MCP, Vercel AI SDK UI e CopilotKit para front-ends, Postgres, LibSQL e bancos vetoriais para memória, e exportadores de traces como o PostHog.
- Dados e privacidade
- Auto-hospedado, os dados ficam nos seus bancos, mas o Studio envia análises de uso ao PostHog por padrão (defina MASTRA_TELEMETRY_DISABLED=1). A retenção na plataforma hospedada é de 15 dias no Starter e 6 meses no Teams; o Teams fornece documentos SOC 2 e SSO. Atualize o @mastra/server para a 1.76.0 ou posterior por causa do GHSA-8982-g8xm-3x5h.
- Custo em escala
- O núcleo de código aberto é gratuito; você paga provedores de modelos e hospedagem. O Teams hospedado custa US$ 250 por mês mais excedentes e um acréscimo de 5,5% nos tokens; RBAC, logs de auditoria e SLAs são do Enterprise, com preço sob consulta.
- Limites
- Cerca de 600 issues abertas, mudanças incompatíveis frequentes, um armazenamento em memória inadequado para produção, e o uso em produção dos recursos de ee/ exige licença. Equipes de Python não têm equivalente; LangGraph ou Pydantic AI cobrem esse lado.
O que é bom
- Agentes, workflows, memória, RAG, evals e tracing em um único pacote tipado
- Studio local para chamadas de ferramentas e traces
- Workflows que pausam à espera de uma pessoa e retomam
- Suporte embutido a cliente e servidor MCP
O que não é
- Sete versões menores do núcleo em três semanas; mudanças incompatíveis relatadas
- O Studio envia análises ao PostHog, a menos que seja desativado
- RBAC, SSO e recursos de autenticação em ee/ exigem licença comercial
- A plataforma hospedada cobra 5,5% a mais sobre os tokens de modelo
Ideal para
Equipes de TypeScript e Next.js que constroem agentes e workflows de IA.
Alternativas ao Mastra
Mastra: perguntas frequentes
- Mastra vale a pena?
- O kit de agentes mais completo do TypeScript, lançado em um ritmo que favorece equipes que fixam versões e leem changelogs. Damos nota 4.4 de 5.
- Quanto custa Mastra?
- O núcleo é gratuito sob Apache 2.0; o código nas pastas ee/ exige uma licença Mastra Enterprise em produção. Plataforma hospedada do Mastra: Starter US$ 0, Teams US$ 250/mês, Enterprise sob medida; o Enterprise auto-hospedado é uma taxa anual fixa.
- Quais são as desvantagens de Mastra?
- Sete versões menores do núcleo em três semanas; mudanças incompatíveis relatadas; o Studio envia análises ao PostHog, a menos que seja desativado; rBAC, SSO e recursos de autenticação em ee/ exigem licença comercial; a plataforma hospedada cobra 5,5% a mais sobre os tokens de modelo.
- Para quem Mastra é indicado?
- Equipes de TypeScript e Next.js que constroem agentes e workflows de IA.
- Quanto custa Mastra para uma equipe ou em produção?
- O núcleo de código aberto é gratuito; você paga provedores de modelos e hospedagem. O Teams hospedado custa US$ 250 por mês mais excedentes e um acréscimo de 5,5% nos tokens; RBAC, logs de auditoria e SLAs são do Enterprise, com preço sob consulta.
- Mastra é seguro para dados da empresa?
- Auto-hospedado, os dados ficam nos seus bancos, mas o Studio envia análises de uso ao PostHog por padrão (defina MASTRA_TELEMETRY_DISABLED=1). A retenção na plataforma hospedada é de 15 dias no Starter e 6 meses no Teams; o Teams fornece documentos SOC 2 e SSO. Atualize o @mastra/server para a 1.76.0 ou posterior por causa do GHSA-8982-g8xm-3x5h.
- Quais são as melhores alternativas ao Mastra?
- As alternativas mais próximas que analisamos são LangGraph, OpenAI Agents SDK e Google Agent Development Kit (ADK).
Respostas verificadas em 26 de out. de 2026.