@mastra/mcp-docs-server 0.0.0-structured-output-issue-20260227214155 → 0.0.0-structured-output-errors-20260409185629

package/.docs/course/01-first-agent/07-creating-your-agent.md

@@ -42,7 +42,7 @@ SUCCESS CRITERIA
 - Deliver accurate and helpful analysis of transaction data.
 - Achieve high user satisfaction through clear and helpful responses.
 - Maintain user trust by ensuring data privacy and security.`,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: {}, // We'll add tools in a later step
 })
 ```

package/.docs/course/01-first-agent/12-connecting-tool-to-agent.md

@@ -19,7 +19,7 @@ export const financialAgent = new Agent({
   TOOLS
   - Use the getTransactions tool to fetch financial transaction data.
   - Analyze the transaction data to answer user questions about their spending.`,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { getTransactionsTool }, // Add our tool here
 })
 ```

package/.docs/course/01-first-agent/16-adding-memory-to-agent.md

@@ -19,7 +19,7 @@ export const financialAgent = new Agent({
   instructions: `ROLE DEFINITION
   // ... existing instructions ...
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { getTransactionsTool },
   memory: new Memory({
     storage: new LibSQLStore({

package/.docs/course/02-agent-tools-mcp/05-updating-your-agent.md

@@ -10,7 +10,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools }, // Add MCP tools to your agent
 })
 ```

package/.docs/course/02-agent-tools-mcp/07-what-is-zapier-mcp.md

@@ -1,6 +1,6 @@
 # Adding the Zapier MCP Server
 
-In this step, we'll add the Zapier MCP server to our agent, which will give it access to email, social media, and many other integrations available through Zapier.
+In this step, you'll add the Zapier MCP server to your agent, giving it access to email, social media, and many other integrations available through Zapier.
 
 ## What is Zapier MCP?
 
@@ -12,3 +12,12 @@ Zapier MCP is a server that provides access to thousands of apps and services th
 - And many more
 
 By integrating the Zapier MCP server with your Mastra agent, you can give it access to all these services without having to write custom tool functions for each one. This significantly expands your agent's capabilities and makes it more useful for a wide range of tasks.
+
+## Authentication
+
+Zapier MCP requires authentication to connect. You will need two things from Zapier:
+
+1. **MCP Server URL**: The endpoint your agent connects to
+2. **API Key**: A secret key sent with every request to prove your identity
+
+The next step walks through getting both of these from the Zapier dashboard.

package/.docs/course/02-agent-tools-mcp/08-getting-zapier-mcp-url.md

@@ -1,16 +1,21 @@
-# Getting a Zapier MCP URL
+# Getting a Zapier MCP URL and API key
 
-First, you'll need to get a Zapier MCP URL. This typically requires:
+First, you'll need to get a Zapier MCP URL and API key. This requires:
 
-1. Creating a Zapier account if you don't have one
-2. Setting up the Zapier MCP integration by adding some tools (we will use Gmail in this example)
-3. Getting your unique MCP URL
+1. Creating a Zapier account at [zapier.com](https://zapier.com) if you don't have one
+2. Going to [mcp.zapier.com](https://mcp.zapier.com) and selecting **+ New MCP Server**
+3. Choosing **OpenAI API** as the client type: This provides API Key authentication, which works well with custom MCP clients like Mastra
+4. Adding tools to your server (e.g., search for "Gmail" and add "Find Email" and "Send Email")
+5. Selecting the **Connect** tab to find your **MCP Server URL** and **API Key** (select **Rotate token** to generate one if needed)
 
-For this example, we'll use an environment variable to store the URL:
+**Important:** Copy your API key immediately when it is shown. Zapier only displays it once. If you lose it, generate a new one by selecting **Rotate token**.
+
+Add both values to your `.env` file:
 
 ```bash
-# Add this to your .env file
-ZAPIER_MCP_URL=https://your-zapier-mcp-url.zapier.app
+# Add these to your .env file
+ZAPIER_MCP_URL=https://mcp.zapier.com/api/v1/connect
+ZAPIER_MCP_API_KEY=your-api-key-here
 ```
 
-Using an environment variable is a good practice for storing sensitive information like API URLs. It keeps the URL out of your code, making it easier to manage and more secure. It also allows you to use different URLs for different environments (development, staging, production) without changing your code.
+Using environment variables keeps your credentials out of your source code. Ensure `.env` is listed in your `.gitignore` file.

package/.docs/course/02-agent-tools-mcp/09-updating-mcp-config-zapier.md

@@ -7,11 +7,23 @@ const mcp = new MCPClient({
   servers: {
     zapier: {
       url: new URL(process.env.ZAPIER_MCP_URL || ''),
+      requestInit: {
+        headers: {
+          Authorization: `Bearer ${process.env.ZAPIER_MCP_API_KEY}`,
+        },
+      },
     },
   },
 })
 ```
 
-This configuration tells your agent how to connect to the Zapier MCP server. The `zapier` key is a unique identifier for this server in your configuration, and the `url` property specifies the URL of the Zapier MCP server.
+This configuration tells your agent how to connect to the Zapier MCP server. Here is what each part does:
+
+- **`zapier`**: A unique identifier for this server in your configuration
+- **`url`**: The Zapier MCP server endpoint, read from your `.env` file
+- **`requestInit.headers`**: HTTP headers sent with every request to the server
+- **`Authorization: Bearer ...`**: Your API key, sent as a Bearer token to authenticate with Zapier
 
 The `new URL()` constructor creates a URL object from the string provided by the environment variable. The `|| ""` part provides a default empty string in case the environment variable is not set, which prevents your application from crashing if the environment variable is missing.
+
+The `requestInit` option lets you customize HTTP requests to the MCP server. Zapier requires an `Authorization` header with your API key in `Bearer {apiKey}` format to verify your identity on every request.

package/.docs/course/02-agent-tools-mcp/10-updating-agent-instructions-zapier.md

@@ -18,7 +18,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/12-troubleshooting-zapier.md

@@ -2,16 +2,18 @@
 
 If your agent can't access the Zapier tools, check:
 
-1. That your Zapier MCP URL is correct in your environment variables
-2. That you've properly set up the Zapier MCP integration
-3. That the tools are properly loaded by checking the Tools tab in the playground
+1. That your `.env` file has both `ZAPIER_MCP_URL` and `ZAPIER_MCP_API_KEY` set
+2. That your MCP config includes `requestInit.headers` with the `Authorization: Bearer` header
+3. That you've added actions to your Zapier MCP server at [mcp.zapier.com](https://mcp.zapier.com)
+4. That the tools are properly loaded by checking the Tools tab in the playground
 
 Common issues include:
 
-- Incorrect or missing environment variables
-- Network connectivity problems
-- Authentication issues with the Zapier MCP server
+- **401 "Missing OAuth authorization header"**: Your config is missing the `requestInit.headers` block. Zapier MCP requires an `Authorization` header on every request.
+- **401 "Invalid OAuth token"**: Your API key is incorrect or expired. Copy it again from the Zapier MCP dashboard (**Connect** tab), or select **Rotate token** to generate a new one.
+- **No tools besides `zapier_get_configuration_url`**: You haven't added actions (e.g., Gmail) to your MCP server on the Zapier dashboard, or you haven't connected your app accounts.
+- **Environment variables not loading**: Restart your development server after changing `.env` values. Environment variables are read at startup.
 
-If you're having trouble, try restarting your development server after making changes to your environment variables or configuration. This ensures that the changes are properly loaded.
+If you're having trouble, check the terminal output when running `npm run dev` for error messages. The MCPClient logs connection errors with details about what went wrong.
 
-In the next step, we'll add the GitHub MCP server to give your agent the ability to monitor and interact with GitHub repositories.
+In the next step, you'll add the GitHub MCP server to give your agent the ability to monitor and interact with GitHub repositories.

package/.docs/course/02-agent-tools-mcp/13-what-is-github-mcp.md

@@ -1,6 +1,6 @@
 # Adding the GitHub MCP Server
 
-In this step, we'll add the Composio GitHub MCP server to our agent, which will give it the ability to monitor and interact with GitHub repositories.
+In this step, we'll add the official GitHub MCP server to our agent, which will give it the ability to monitor and interact with GitHub repositories.
 
 ## What is the GitHub MCP Server?
 

package/.docs/course/02-agent-tools-mcp/14-getting-github-mcp-url.md

@@ -1,32 +1,40 @@
-# Getting a Smithery GitHub MCP URL
+# Setting Up the GitHub MCP Server
 
-First, you'll need to get a Smithery GitHub MCP URL. This typically requires:
+To connect your agent to GitHub, we'll use the [official GitHub MCP server](https://github.com/github/github-mcp-server). GitHub hosts this server remotely at `https://api.githubcopilot.com/mcp/`, and authentication is done with a GitHub Personal Access Token passed in the request headers.
 
-1. Setting up a Smithery account
-2. Creating a personal access token with your GitHub account
-3. Getting your unique MCP URL via the Smithery packages
+## Creating a GitHub Personal Access Token
 
-For this example, we'll use an environment variable to store the Smithery API key and profile name which can be found in the Smithery interface.
+You'll need a GitHub Personal Access Token (PAT) to authenticate with the server.
+
+1. Go to [GitHub Settings > Developer settings > Personal access tokens > Fine-grained tokens](https://github.com/settings/personal-access-tokens/new)
+2. Give it a descriptive name (e.g., "Mastra Agent")
+3. Select the repositories you want your agent to access
+4. Under **Repository permissions**, grant at minimum:
+   - **Issues**: Read
+   - **Pull requests**: Read
+   - **Contents**: Read
+   - **Metadata**: Read (selected by default)
+5. Click **Generate token** and copy it
+
+Add the token to your `.env` file:
 
 ```bash
 # Add this to your .env file
-SMITHERY_API_KEY=your_smithery_api_key
-SMITHERY_PROFILE=your_smithery_profile_name
+GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token
 ```
 
-Using an environment variable keeps your configuration secure and flexible. It also prevents sensitive information from being committed to your repository.
+Using an environment variable keeps your token secure and prevents it from being committed to your repository.
 
-We will use the Smithery packages to authenticate and create a streamable HTTP URL for the MCP server configuration
+:::note
+If you prefer to run the GitHub MCP server locally instead of using the hosted endpoint, you can use `npx` as a stdio transport:
 
-```bash
-pnpm install @smithery/sdk
+```typescript
+github: {
+  command: 'npx',
+  args: ['-y', '@modelcontextprotocol/server-github'],
+  env: { GITHUB_PERSONAL_ACCESS_TOKEN: process.env.GITHUB_PERSONAL_ACCESS_TOKEN },
+}
 ```
 
-```ts
-import { createSmitheryUrl } from '@smithery/sdk'
-
-const smitheryGithubMCPServerUrl = createSmitheryUrl('https://server.smithery.ai/@smithery-ai/github', {
-  apiKey: process.env.SMITHERY_API_KEY,
-  profile: process.env.SMITHERY_PROFILE,
-})
-```
+This does not require access to `api.githubcopilot.com` and works the same way as the hosted option.
+:::

package/.docs/course/02-agent-tools-mcp/15-updating-mcp-config-github.md

@@ -7,14 +7,30 @@ const mcp = new MCPClient({
   servers: {
     zapier: {
       url: new URL(process.env.ZAPIER_MCP_URL || ''),
+      requestInit: {
+        headers: {
+          Authorization: `Bearer ${process.env.ZAPIER_MCP_API_KEY}`,
+        },
+      },
     },
     github: {
-      url: smitheryGithubMCPServerUrl,
+      url: new URL('https://api.githubcopilot.com/mcp/'),
+      requestInit: {
+        headers: {
+          Authorization: `Bearer ${process.env.GITHUB_PERSONAL_ACCESS_TOKEN}`,
+        },
+      },
     },
   },
 })
 ```
 
-This configuration adds the GitHub MCP server alongside the Zapier server we added in the previous step. The `github` key is a unique identifier for this server in your configuration, and the `url` property specifies the URL of the GitHub MCP server.
+This configuration adds the GitHub MCP server alongside the Zapier server we added in the previous step. The `github` key is a unique identifier for this server in your configuration.
+
+**How it works:**
+
+- The `url` property points to GitHub's hosted remote MCP server
+- The `requestInit.headers` property passes your Personal Access Token for authentication
+- The server uses Streamable HTTP transport, the same protocol used by the Zapier server
 
 By adding multiple servers to your MCP configuration, you're building a more versatile agent that can access a wider range of tools and services. Each server adds its own set of capabilities to your agent.

package/.docs/course/02-agent-tools-mcp/16-updating-agent-instructions-github.md

@@ -22,7 +22,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/18-troubleshooting-github.md

@@ -2,15 +2,15 @@
 
 If your agent can't access the GitHub tools, check:
 
-1. That your GitHub MCP URL is correct in your environment variables
-2. That you've properly authenticated with GitHub
+1. That your `GITHUB_PERSONAL_ACCESS_TOKEN` is set correctly in your `.env` file
+2. That your token has the required repository permissions (Issues, Pull requests, Contents, Metadata)
 3. That the tools are properly loaded by checking the Tools tab in the playground
 
 Common issues include:
 
-- Incorrect or missing environment variables
-- Authentication issues with GitHub
-- Permission problems with the repositories you're trying to access
+- Missing or expired Personal Access Token — generate a new one at [GitHub Settings](https://github.com/settings/personal-access-tokens)
+- Insufficient token permissions — ensure your token has read access to the repositories you're targeting
+- Network issues preventing the connection to `api.githubcopilot.com`
 
 If you're having trouble, try checking the console logs for any error messages related to the GitHub MCP server. These can provide valuable clues about what might be going wrong.
 

package/.docs/course/02-agent-tools-mcp/20-updating-mcp-config-hackernews.md

@@ -9,9 +9,19 @@ const mcp = new MCPClient({
   servers: {
     zapier: {
       url: new URL(process.env.ZAPIER_MCP_URL || ''),
+      requestInit: {
+        headers: {
+          Authorization: `Bearer ${process.env.ZAPIER_MCP_API_KEY}`,
+        },
+      },
     },
     github: {
-      url: new URL(process.env.COMPOSIO_MCP_GITHUB || ''),
+      url: new URL('https://api.githubcopilot.com/mcp/'),
+      requestInit: {
+        headers: {
+          Authorization: `Bearer ${process.env.GITHUB_PERSONAL_ACCESS_TOKEN}`,
+        },
+      },
     },
     hackernews: {
       command: 'npx',

package/.docs/course/02-agent-tools-mcp/21-updating-agent-instructions-hackernews.md

@@ -27,7 +27,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/26-updating-mcp-config-filesystem.md

@@ -9,9 +9,19 @@ const mcp = new MCPClient({
   servers: {
     zapier: {
       url: new URL(process.env.ZAPIER_MCP_URL || ''),
+      requestInit: {
+        headers: {
+          Authorization: `Bearer ${process.env.ZAPIER_MCP_API_KEY}`,
+        },
+      },
     },
     github: {
-      url: new URL(process.env.COMPOSIO_MCP_GITHUB || ''),
+      url: new URL('https://api.githubcopilot.com/mcp/'),
+      requestInit: {
+        headers: {
+          Authorization: `Bearer ${process.env.GITHUB_PERSONAL_ACCESS_TOKEN}`,
+        },
+      },
     },
     hackernews: {
       command: 'npx',

package/.docs/course/02-agent-tools-mcp/27-updating-agent-instructions-filesystem.md

@@ -34,7 +34,7 @@ export const personalAssistantAgent = new Agent({
     
     Keep your responses concise and friendly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/31-enhancing-memory-configuration.md

@@ -61,7 +61,7 @@ export const personalAssistantAgent = new Agent({
     Always maintain a helpful and professional tone.
     Use the stored information to provide more personalized responses.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   tools: { ...mcpTools },
   memory,
 })

package/.docs/course/02-agent-tools-mcp/32-conclusion.md

@@ -3,7 +3,7 @@
 Congratulations! You've successfully enhanced your Mastra agent with MCP servers, giving it powerful capabilities including:
 
 1. Email and social media integration through Zapier
-2. GitHub monitoring through the Composio GitHub MCP server
+2. GitHub monitoring through the official GitHub MCP server
 3. Tech news access through the Hacker News MCP server
 4. Local file management through the Filesystem MCP server
 5. Enhanced memory for personalized interactions

package/.docs/course/03-agent-memory/04-creating-basic-memory-agent.md

@@ -26,7 +26,7 @@ export const memoryAgent = new Agent({
     When a user shares information about themselves, acknowledge it and remember it for future reference.
     If asked about something mentioned earlier in the conversation, recall it accurately.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/08-configuring-conversation-history.md

@@ -26,7 +26,7 @@ export const memoryAgent = new Agent({
     When a user shares information about themselves, acknowledge it and remember it for future reference.
     If asked about something mentioned earlier in the conversation, recall it accurately.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/16-configuring-semantic-recall.md

@@ -34,7 +34,7 @@ export const memoryAgent = new Agent({
     If asked about something mentioned earlier in the conversation, recall it accurately.
     You can also recall relevant information from older conversations when appropriate.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/21-configuring-working-memory.md

@@ -51,7 +51,7 @@ export const memoryAgent = new Agent({
     Always refer to your working memory before asking for information the user has already provided.
     Use the information in your working memory to provide personalized responses.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/22-custom-working-memory-templates.md

@@ -73,7 +73,7 @@ export const memoryAgent = new Agent({
     When the user shares personal information such as their name, location, or preferences,
     acknowledge it and update your working memory accordingly.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: memory,
 })
 ```

package/.docs/course/03-agent-memory/27-creating-learning-assistant.md

@@ -87,7 +87,7 @@ export const learningAssistantAgent = new Agent({
     Always be encouraging and supportive. Focus on building the user's confidence
     and celebrating their progress.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
   memory: learningMemory,
 })
 

package/.docs/course/04-workflows/11-creating-an-ai-agent.md

@@ -22,7 +22,7 @@ export const contentAgent = new Agent({
     
     Always provide constructive, actionable feedback.
   `,
-  model: 'openai/gpt-4.1-mini',
+  model: 'openai/gpt-5.4',
 })
 ```
 
@@ -31,7 +31,7 @@ export const contentAgent = new Agent({
 - **Name**: Unique identifier for the agent
 - **Description**: What the agent does
 - **Instructions**: Detailed prompts that guide the AI's behavior
-- **Model**: Which AI model to use (GPT-4.1-mini is fast and cost-effective)
+- **Model**: Which AI model to use
 
 ## Registering and Testing Your Agent
 

package/.docs/docs/agents/adding-voice.md

@@ -20,7 +20,7 @@ export const agent = new Agent({
   id: 'voice-agent',
   name: 'Voice Agent',
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   voice,
 })
 
@@ -39,7 +39,7 @@ try {
 }
 ```
 
-## Working with Audio Streams
+## Working with audio streams
 
 The `speak()` and `listen()` methods work with Node.js streams. Here's how to save and load audio files:
 
@@ -87,7 +87,7 @@ try {
 }
 ```
 
-## Speech-to-Speech Voice Interactions
+## Speech-to-speech voice interactions
 
 For more dynamic and interactive voice experiences, you can use real-time voice providers that support speech-to-speech capabilities:
 
@@ -109,7 +109,7 @@ export const agent = new Agent({
   id: 'speech-to-speech-agent',
   name: 'Speech-to-Speech Agent',
   instructions: `You are a helpful assistant with speech-to-speech capabilities.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   tools: {
     // Tools configured on Agent are passed to voice provider
     search,
@@ -209,7 +209,7 @@ export const convertToText = async (input: string | NodeJS.ReadableStream): Prom
 export const hybridVoiceAgent = new Agent({
   id: 'hybrid-voice-agent',
   name: 'Hybrid Voice Agent',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   instructions: 'You can speak and listen using different providers.',
   voice: new CompositeVoice({
     input: new OpenAIVoice(),
@@ -221,7 +221,7 @@ export const unifiedVoiceAgent = new Agent({
   id: 'unified-voice-agent',
   name: 'Unified Voice Agent',
   instructions: 'You are an agent with both STT and TTS capabilities.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   voice: new OpenAIVoice(),
 })
 
@@ -263,7 +263,7 @@ export const agent = new Agent({
   id: 'voice-agent',
   name: 'Voice Agent',
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
 
   // Create a composite voice using OpenAI for listening and PlayAI for speaking
   voice: new CompositeVoice({
@@ -288,7 +288,7 @@ export const agent = new Agent({
   id: 'aisdk-voice-agent',
   name: 'AI SDK Voice Agent',
   instructions: `You are a helpful assistant with voice capabilities.`,
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
 
   // Pass AI SDK models directly to CompositeVoice
   voice: new CompositeVoice({
@@ -323,7 +323,7 @@ For the complete list of supported AI SDK providers and their capabilities:
 - [Transcription](https://ai-sdk.dev/docs/providers/openai/transcription)
 - [Speech](https://ai-sdk.dev/docs/providers/elevenlabs/speech)
 
-## Supported Voice Providers
+## Supported voice providers
 
 Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-text (STT) capabilities:
 
@@ -341,7 +341,7 @@ Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-
 | Azure           | `@mastra/voice-azure`           | TTS, STT                  | [Documentation](https://mastra.ai/reference/voice/mastra-voice)    |
 | Cloudflare      | `@mastra/voice-cloudflare`      | TTS                       | [Documentation](https://mastra.ai/reference/voice/mastra-voice)    |
 
-## Next Steps
+## Next steps
 
 - [Voice API Reference](https://mastra.ai/reference/voice/mastra-voice) - Detailed API documentation for voice capabilities
 - [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech) - Interactive story generator and other TTS implementations