Mastra Docs

Mastra Documentation

Mastra is a TypeScript AI framework for building agents, workflows, and RAG pipelines with batteries-included integrations.

• GitHub | Docs

CRITICAL: grep references/ for detailed docs before answering.

Quick Start

npx create-mastra@latest
# or
npm install @mastra/core

import { Mastra, createAgent } from "@mastra/core";
import { openai } from "@ai-sdk/openai";

const agent = createAgent({
  name: "my-agent",
  instructions: "You are a helpful assistant.",
  model: openai("gpt-4o"),
});

const mastra = new Mastra({ agents: { myAgent: agent } });
const response = await mastra.getAgent("myAgent").generate("Hello!");

Key Concepts

Key Topics

Docs (Guides)

• references/docs/getting-started/ — Installation, first agent, first workflow
• references/docs/agents/ — Agent creation, tools, memory, voice
• references/docs/workflows/ — Workflow steps, branching, suspension
• references/docs/memory/ — Thread memory, semantic recall, storage
• references/docs/rag/ — Chunking, embedding, vector search
• references/docs/evals/ — Evaluation metrics, custom evals
• references/docs/mcp/ — MCP server integration
• references/docs/observability/ — Tracing, logging, datasets
• references/docs/deployment/ — Deployment options
• references/docs/mastra-cloud/ — Mastra Cloud
• references/docs/server/ — Server setup, auth

API Reference

• references/reference/agents/ — Agent API
• references/reference/workflows/ — Workflow API
• references/reference/memory/ — Memory API
• references/reference/rag/ — RAG (chunking, embedding, vector)
• references/reference/evals/ — Eval metrics
• references/reference/tools/ — Tool definitions
• references/reference/voice/ — Voice API
• references/reference/core/ — Core Mastra class
• references/reference/client-js/ — Client SDK
• references/reference/storage/ — Storage backends
• references/reference/vectors/ — Vector store integrations
• references/reference/processors/ — Document processors

Models & Providers

• references/models/ — Supported models index
• references/models/providers/ — 94 provider integrations

Guides

• references/guides/guide/ — End-to-end tutorials
• references/guides/getting-started/ — Getting started guides
• references/guides/deployment/ — Cloudflare, Vercel, etc.
• references/guides/migrations/upgrade-to-v1/ — v1 migration

References

• references/ — 561 MDX files covering full API and guides
• references/docs/ — Concept guides and tutorials
• references/reference/ — API reference (agents, workflows, memory, RAG, evals, voice, MCP)
• references/models/providers/ — 94 model provider integrations
• references/guides/ — End-to-end tutorials and deployment guides