Mastra
From the team behind Gatsby, Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.
What is Mastra?
Mastra is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to from the team behind gatsby, mastra is a framework for building ai-powered applications and agents with a modern typescript stack.
From the team behind Gatsby, Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- From the team behind Gatsby, Mastra is a framework for build
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @mastra/mcp-docs-serverManual Installation
npx -y @mastra/mcp-docs-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mastra
Mastra is a TypeScript framework from the team behind Gatsby for building production-ready AI applications and agents, providing model routing across 40+ LLM providers, a graph-based workflow engine, human-in-the-loop support, RAG integration, and built-in evals and observability. The @mastra/mcp-docs-server package exposes Mastra's full documentation, API references, package exports, and an interactive course as MCP tools, turning any MCP-compatible AI coding assistant into a Mastra expert. Developers use the Mastra MCP docs server to get accurate, up-to-date guidance on building agents, workflows, and memory systems without having to browse documentation manually — particularly useful when working with the frequently-updated Mastra v1.x API.
Prerequisites
- Node.js 18 or later installed
- An MCP-compatible client such as Claude Desktop, Cursor, Windsurf, VS Code, or Claude Code
- A Mastra project (or intent to create one) — run 'npm create mastra@latest' to scaffold
- Optional: an email address for accessing the interactive Mastra course via the startMastraCourse tool
Scaffold a new Mastra project (if starting fresh)
Use the official Mastra CLI to generate a new project with agents, tools, and workflows pre-configured. This creates a TypeScript project with Mastra's recommended directory structure.
npm create mastra@latestAdd the Mastra MCP docs server to your client configuration
Add the @mastra/mcp-docs-server to your MCP client configuration. This server provides all Mastra documentation, API references, migration guides, and course content as queryable MCP tools. No additional API keys are required.
Restart your MCP client
After saving the configuration, fully quit and reopen your MCP client. The Mastra docs server tools should now appear in the available tools list.
Use getMastraHelp to discover available tools
Start by invoking the getMastraHelp tool to get an overview of all documentation tools and recommended workflows for using the Mastra docs server effectively.
Build your Mastra agent, workflow, or integration
With the docs server connected, your AI assistant can look up accurate API signatures, read migration guides, search docs for specific topics, and list all exports from any installed @mastra/* package in your project's node_modules.
Mastra Examples
Client configuration
Add this block to your claude_desktop_config.json under the mcpServers key. No environment variables or API keys are required for the docs server.
{
"mcpServers": {
"mastra": {
"command": "npx",
"args": ["-y", "@mastra/mcp-docs-server"]
}
}
}Prompts to try
Once the server is connected, use these prompts to get Mastra-specific guidance from your AI assistant.
- "Using the Mastra docs, show me how to create an agent with memory and tool access"
- "Look up the Mastra workflow API and help me build a multi-step data processing pipeline"
- "Search the Mastra docs for how to implement human-in-the-loop approval in a workflow"
- "What breaking changes do I need to address when migrating from Mastra v0.x to v1.0?"
- "List all exports from @mastra/core in my project and explain what the Agent class constructor accepts"Troubleshooting Mastra
getMastraExports or readMastraDocs returns no results for local packages
The tools that read from node_modules require a projectPath parameter pointing to a directory containing a node_modules/@mastra/* installation. Run 'npm install' in your Mastra project first, then pass the absolute project path when invoking the tool.
Documentation is outdated or references old API names
The @mastra/mcp-docs-server package embeds docs at its own release version. Update to the latest version by running 'npx -y @mastra/mcp-docs-server@latest' or pinning a specific version. Use the mastraMigration tool to navigate version-specific migration guides.
startMastraCourse tool asks for email but course does not load
The interactive course requires a valid email for registration. After providing your email, check your inbox for a verification link. If the course still does not load, use clearMastraCourseHistory to reset progress and try again.
Frequently Asked Questions about Mastra
What is Mastra?
Mastra is a Model Context Protocol (MCP) server that from the team behind gatsby, mastra is a framework for building ai-powered applications and agents with a modern typescript stack. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mastra?
Install via npm with the command: npx -y @mastra/mcp-docs-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Mastra?
Mastra works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mastra free to use?
Yes, Mastra is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Mastra Alternatives — Similar Business Applications Servers
Looking for alternatives to Mastra? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mastra in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mastra?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.