---
title: "Mastra: recursos, versão e início rápido · DotsAgent"
description: "Mastra, de Mastra: licença, versão mais recente, suporte a MCP, execuções duráveis, aprovação humana, tracing e avaliações, além de um início rápido para copiar."
url: https://dotsagent.io/pt/frameworks/mastra
---

Framework · Mastra

# Mastra em resumo

Um framework para TypeScript que reúne agentes, workflows com suspensão e retomada, memória, avaliações e a interface Studio em um único pacote. Pode ser integrado a aplicações Next.js, Express ou Hono; o núcleo usa a licença Apache-2.0, enquanto os diretórios ee/ usam uma licença empresarial.

**Ideal para:**  Equipes TypeScript que querem uma stack única para agentes, workflows, memória e avaliações.

## Principais informações

- **Responsável pela manutenção**: Mastra
- **Linguagens**: TypeScript
- **Licença**: Apache-2.0 (core)
- **Versão mais recente**: `@mastra/core 1.73.0` · 1 de outubro de 2026
- **Repositório**: [mastra-ai/mastra](https://github.com/mastra-ai/mastra) · 28.467 estrelas
- **Opção hospedada**: [Mastra Cloud / Mastra Platform](https://mastra.ai/docs)mastra deploy cria e implanta uma imagem Docker.

## Início rápido

Instale o pacote, configure as credenciais e execute o agente mais simples da documentação oficial. Os IDs dos modelos são os usados na documentação e talvez não estejam habilitados na sua conta.

`Instalar`

```
npm install @mastra/core@latest zod@latest typescript@latest @types/node@latest mastra@latest  (or scaffold: npm create mastra@latest)
```

Requer OPENAI_API_KEY

`TypeScript`

```
// src/mastra/agents/weather-agent.ts
import { Agent } from '@mastra/core/agent'
import { weatherTool } from '../tools/weather-tool.ts'

export const weatherAgent = new Agent({
  id: 'weather-agent',
  name: 'Weather Agent',
  instructions: `
      You are a helpful weather assistant that provides accurate weather information.

      Your primary function is to help users get weather details for specific locations. When responding:
      - Include relevant details like humidity, wind conditions, and precipitation
      - Keep responses concise but informative

      Use the weatherTool to fetch current weather data.
`,
  // Use a string in provider/model format, not provider:model or a provider object.
  model: 'openai/gpt-5.6-sol',
  tools: { weatherTool },
})

// run.mjs (after registering the agent in src/mastra/index.ts)
import { mastra } from './src/mastra/index.ts'

const agent = mastra.getAgentById('weather-agent')
const response = await agent.generate('Weather in SF')
console.log(response.text)
```

[Fonte do início rápido](https://mastra.ai/docs)

## Recursos

| Qualquer modelo | — | Strings de roteamento de modelos no formato provedor/modelo |
| --- | --- | --- |
| Cliente MCP | — | — |
| Servidor MCP | — | MCPServer disponibiliza agentes, ferramentas, workflows, prompts e recursos |
| Multiagente | — | Agentes podem atuar como ferramentas para outros agentes |
| Execuções duráveis | — | Suspensão e retomada com snapshots em libSQL, Postgres e outros |
| Aprovação humana | — | suspend() e resume() coletam a entrada humana |
| Rastreamento | — | Exportadores OTel para Langfuse, Braintrust, Datadog e LangSmith |
| Avaliações | — | Os avaliadores são executados em produção com amostragem ou offline no CI |

## Mudanças recentes

- npm create mastra agora cria a estrutura de um harness de uso geral com workspace, ferramentas de shell, memória e agendamentos.
- Mastra Factory é voltado a fábricas de software criadas com agentes de programação.

## Alternativas na mesma linguagem

- [OpenAI Agents SDK (JS)](https://dotsagent.io/pt/frameworks/openai-agents-js)

- [Claude Agent SDK](https://dotsagent.io/pt/frameworks/claude-agent-sdk)

- [Google ADK](https://dotsagent.io/pt/frameworks/google-adk)

- [LangGraph](https://dotsagent.io/pt/frameworks/langgraph)

- [LlamaIndex](https://dotsagent.io/pt/frameworks/llamaindex)

- [Vercel AI SDK](https://dotsagent.io/pt/frameworks/vercel-ai-sdk)

## Fontes

1. [mastra.ai](https://mastra.ai/docs)/docs
2. [mastra.ai](https://mastra.ai/docs/connections/mcp)/docs/connections/mcp
3. [mastra.ai](https://mastra.ai/reference/tools/mcp-server)/reference/tools/mcp-server
4. [mastra.ai](https://mastra.ai/docs/workflows/suspend-and-resume)/docs/workflows/suspend-and-resume
5. [mastra.ai](https://mastra.ai/docs/workflows/snapshots)/docs/workflows/snapshots
6. [mastra.ai](https://mastra.ai/ai-agent-observability)/ai-agent-observability
7. [github.com](https://github.com/mastra-ai/mastra/blob/main/LICENSE.md)/mastra-ai/mastra/blob/main/LICENSE.md
8. [registry.npmjs.org](https://registry.npmjs.org/@mastra%2fcore)/@mastra%2fcore

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026