---
title: "Mastra: funciones, versión e inicio rápido · DotsAgent"
description: "Mastra, de Mastra: licencia, última versión, compatibilidad con MCP, ejecuciones duraderas, aprobación humana, trazabilidad y evaluaciones, además de una guía de inicio rápido lista para copiar."
url: https://dotsagent.io/es/frameworks/mastra
---

Framework · Mastra

# Mastra de un vistazo

Un framework para TypeScript que reúne agentes, workflows con suspensión y reanudación, memoria, evaluaciones y la interfaz de Studio en un solo paquete. Se integra en aplicaciones Next.js, Express o Hono; el núcleo usa la licencia Apache-2.0, mientras que los directorios ee/ usan una licencia empresarial.

**Ideal para:**  Equipos de TypeScript que quieren una sola stack para agentes, workflows, memoria y evaluaciones.

## Datos clave

- **Mantenedor**: Mastra
- **Lenguajes**: TypeScript
- **Licencia**: Apache-2.0 (core)
- **Última versión**: `@mastra/core 1.73.0` · 1 de octubre de 2026
- **Repositorio**: [mastra-ai/mastra](https://github.com/mastra-ai/mastra) · 28.467 estrellas
- **Opción alojada**: [Mastra Cloud / Mastra Platform](https://mastra.ai/docs)mastra deploy compila y despliega una imagen de Docker.

## Inicio rápido

Instala el paquete, configura las credenciales y ejecuta el agente más sencillo de la documentación oficial. Los ID de modelo son los que usa la documentación y puede que no estén habilitados en tu cuenta.

`Instalar`

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

Requiere 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)
```

[Fuente de la guía de inicio rápido](https://mastra.ai/docs)

## Funciones

| Cualquier modelo | — | Cadenas del enrutador de modelos con el formato proveedor/modelo |
| --- | --- | --- |
| Cliente MCP | — | — |
| Servidor MCP | — | MCPServer expone agentes, herramientas, workflows, prompts y recursos |
| Multiagente | — | Los agentes pueden actuar como herramientas para otros agentes |
| Ejecuciones duraderas | — | Suspensión y reanudación con snapshots en libSQL, Postgres y otros |
| Aprobación humana | — | suspend() y resume() recopilan la intervención humana |
| Trazas | — | Exportadores OTel para Langfuse, Braintrust, Datadog y LangSmith |
| Evaluaciones | — | Los evaluadores se ejecutan en vivo con muestreo o sin conexión en CI |

## Cambios recientes

- npm create mastra ahora crea un harness de uso general con workspace, herramientas de shell, memoria y programaciones.
- Mastra Factory está orientado a fábricas de software creadas con agentes de programación.

## Alternativas en el mismo lenguaje

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

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

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

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

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

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

## Fuentes

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

Referencia independiente para quienes crean agentes de IA. No estamos afiliados a ninguno de los proveedores mencionados aquí.

© 2026 DotsAgent · Datos verificados el 1 de octubre de 2026