@mastra/mcp-docs-server 1.0.0-beta.2 → 1.0.0-beta.4

package/.docs/raw/memory/storage/memory-with-libsql.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Memory with LibSQL | Memory | Mastra Docs"
+title: "Memory with LibSQL | Memory"
 description: Example for how to use Mastra's memory system with LibSQL storage and vector database backend.
 ---
 
@@ -140,6 +140,3 @@ for await (const chunk of stream.textStream) {
 }
 ```
 
-## Related
-
-- [Calling Agents](/examples/v1/agents/calling-agents)

package/.docs/raw/memory/storage/memory-with-mongodb.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Example: Memory with MongoDB | Memory | Mastra Docs"
+title: "Example: Memory with MongoDB | Memory"
 description: Example for how to use Mastra's memory system with MongoDB storage and vector capabilities.
 ---
 

package/.docs/raw/memory/storage/memory-with-pg.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Memory with Postgres | Memory | Mastra Docs"
+title: "Memory with Postgres | Memory"
 description: Example for how to use Mastra's memory system with PostgreSQL storage and vector capabilities.
 ---
 
@@ -138,6 +138,3 @@ for await (const chunk of stream.textStream) {
 }
 ```
 
-## Related
-
-- [Calling Agents](/examples/v1/agents/calling-agents)

package/.docs/raw/memory/storage/memory-with-upstash.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Memory with Upstash | Memory | Mastra Docs"
+title: "Memory with Upstash | Memory"
 description: Example for how to use Mastra's memory system with Upstash Redis storage and vector capabilities.
 ---
 
@@ -146,6 +146,3 @@ for await (const chunk of stream.textStream) {
 }
 ```
 
-## Related
-
-- [Calling Agents](/examples/v1/agents/calling-agents)

package/.docs/raw/memory/threads-and-resources.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Memory threads and resources | Memory | Mastra Docs"
+title: "Memory threads and resources | Memory"
 description: "Learn how Mastra's memory system works with working memory, conversation history, and semantic recall."
 ---
 

package/.docs/raw/memory/working-memory.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Working Memory | Memory | Mastra Docs"
+title: "Working Memory | Memory"
 description: "Learn how to configure working memory in Mastra to store persistent user data, preferences."
 ---
 

package/.docs/raw/observability/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Observability Overview | Observability | Mastra Docs"
+title: "Observability Overview | Observability"
 description: Monitor and debug applications with Mastra's Observability features.
 ---
 
@@ -49,5 +49,5 @@ We also support various external tracing providers like Langfuse, Braintrust, an
 
 - **[Set up Tracing](/docs/v1/observability/tracing/overview)**: Configure tracing for your application
 - **[Configure Logging](/docs/v1/logging)**: Add structured logging
-- **[View Examples](/examples/v1/observability/basic-tracing)**: See observability in action
+- **[View Examples](/examples/v1/observability/basic-ai-tracing)**: See observability in action
 - **[API Reference](/reference/v1/observability/tracing/instances)**: Detailed configuration options

package/.docs/raw/observability/tracing/exporters/arize.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Arize Exporter | Tracing | Observability | Mastra Docs"
+title: "Arize Exporter | Tracing | Observability"
 description: "Send traces to Arize Phoenix or Arize AX using OpenTelemetry and OpenInference"
 ---
 

package/.docs/raw/observability/tracing/exporters/braintrust.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Braintrust Exporter | Tracing | Observability | Mastra Docs"
+title: "Braintrust Exporter | Tracing | Observability"
 description: "Send traces to Braintrust for evaluation and monitoring"
 ---
 

package/.docs/raw/observability/tracing/exporters/cloud.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Cloud Exporter | Tracing | Observability | Mastra Docs"
+title: "Cloud Exporter | Tracing | Observability"
 description: "Send traces to Mastra Cloud for production monitoring"
 ---
 
@@ -112,4 +112,4 @@ CloudExporter uses intelligent batching to optimize network usage. Traces are bu
 
 - [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [DefaultExporter](/docs/v1/observability/tracing/exporters/default)
-- [Mastra Cloud Documentation](https://cloud.mastra.ai/docs)
+- [Mastra Cloud Documentation](/docs/v1/deployment/mastra-cloud/overview)

package/.docs/raw/observability/tracing/exporters/default.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Default Exporter | Tracing | Observability | Mastra Docs"
+title: "Default Exporter | Tracing | Observability"
 description: "Store traces locally for development and debugging"
 ---
 

package/.docs/raw/observability/tracing/exporters/langfuse.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Langfuse Exporter | Tracing | Observability | Mastra Docs"
+title: "Langfuse Exporter | Tracing | Observability"
 description: "Send traces to Langfuse for LLM observability and analytics"
 ---
 

package/.docs/raw/observability/tracing/exporters/langsmith.mdx

@@ -1,5 +1,5 @@
 ---
-title: "LangSmith Exporter | Tracing | Observability | Mastra Docs"
+title: "LangSmith Exporter | Tracing | Observability"
 description: "Send traces to LangSmith for LLM observability and evaluation"
 ---
 

package/.docs/raw/observability/tracing/exporters/otel.mdx

@@ -1,5 +1,5 @@
 ---
-title: "OpenTelemetry Exporter | Tracing | Observability | Mastra Docs"
+title: "OpenTelemetry Exporter | Tracing | Observability"
 description: "Send traces to any OpenTelemetry-compatible observability platform"
 ---
 

package/.docs/raw/observability/tracing/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Tracing | Observability | Mastra Docs"
+title: "Tracing | Observability"
 description: "Set up Tracing for Mastra applications"
 ---
 
@@ -753,7 +753,7 @@ Mastra automatically creates spans for:
 
 ### Examples
 
-- [Basic Tracing Example](/examples/v1/observability/basic-tracing) - Working implementation
+- [Basic Tracing Example](/examples/v1/observability/basic-ai-tracing) - Working implementation
 
 ### Reference Documentation
 

package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Sensitive Data Filter | Processors | Observability | Mastra Docs"
+title: "Sensitive Data Filter | Processors | Observability"
 description: "Protect sensitive information in your traces with automatic data redaction"
 ---
 
@@ -293,4 +293,4 @@ This ensures that processing errors don't prevent traces from being exported or
 ## Related
 
 - [SensitiveDataFilter API](/reference/v1/observability/tracing/processors/sensitive-data-filter)
-- [Basic Tracing Example](/examples/v1/observability/basic-tracing)
+- [Basic Tracing Example](/examples/v1/observability/basic-ai-tracing)

package/.docs/raw/rag/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: "RAG (Retrieval-Augmented Generation) in Mastra | RAG | Mastra Docs"
+title: "RAG (Retrieval-Augmented Generation) in Mastra | RAG"
 description: Overview of Retrieval-Augmented Generation (RAG) in Mastra, detailing its capabilities for enhancing LLM outputs with relevant context.
 ---
 

package/.docs/raw/rag/retrieval.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Retrieval, Semantic Search, Reranking | RAG | Mastra Docs"
+title: "Retrieval, Semantic Search, Reranking | RAG"
 description: Guide on retrieval processes in Mastra's RAG systems, including semantic search, filtering, and re-ranking.
 ---
 

package/.docs/raw/rag/vector-databases.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Storing Embeddings in A Vector Database | RAG | Mastra Docs"
+title: "Storing Embeddings in A Vector Database | RAG"
 description: Guide on vector storage options in Mastra, including embedded and dedicated vector databases for similarity search.
 ---
 

package/.docs/raw/reference/agents/agent.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent Class | Agents | Mastra Docs"
+title: "Reference: Agent Class | Agents"
 description: "Documentation for the `Agent` class in Mastra, which provides the foundation for creating AI agents with various capabilities."
 ---
 
@@ -245,4 +245,3 @@ export const agent = new Agent({
 ## Related
 
 - [Agents overview](/docs/v1/agents/overview)
-- [Calling Agents](/examples/v1/agents/calling-agents)

package/.docs/raw/reference/agents/generate.mdx

@@ -1,8 +1,10 @@
 ---
-title: "Reference: Agent.generate() | Agents | Mastra Docs"
+title: "Reference: Agent.generate() | Agents"
 description: "Documentation for the `Agent.generate()` method in Mastra agents, which enables non-streaming generation of responses with enhanced capabilities."
 ---
 
+import { MODEL_SETTINGS_OBJECT } from "@site/src/components/ModelSettingsProperties";
+
 # Agent.generate()
 
 The `.generate()` method enables non-streaming response generation from an agent, with enhanced capabilities and flexible output formats. It accepts messages and optional generation options, supporting both Mastra’s native format and AI SDK v5 compatibility.
@@ -17,6 +19,14 @@ const mastraResult = await agent.generate("message for agent");
 const aiSdkResult = await agent.generate("message for agent", {
   format: "aisdk",
 });
+
+// With model settings (e.g., limiting output tokens)
+const limitedResult = await agent.generate("Write a short poem about coding", {
+  modelSettings: {
+    maxOutputTokens: 50,
+    temperature: 0.7,
+  },
+});
 ```
 
 :::info
@@ -392,91 +402,7 @@ const aiSdkResult = await agent.generate("message for agent", {
         },
       ],
     },
-    {
-      name: "modelSettings",
-      type: "CallSettings",
-      isOptional: true,
-      description: "Model-specific settings like temperature, topP, etc.",
-      properties: [
-        {
-          parameters: [
-            {
-              name: "temperature",
-              type: "number",
-              isOptional: true,
-              description:
-                "Controls randomness in generation (0-2). Higher values make output more random.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "maxRetries",
-              type: "number",
-              isOptional: true,
-              description:
-                "Maximum number of retry attempts for failed requests.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "topP",
-              type: "number",
-              isOptional: true,
-              description:
-                "Nucleus sampling parameter (0-1). Controls diversity of generated text.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "topK",
-              type: "number",
-              isOptional: true,
-              description:
-                "Top-k sampling parameter. Limits vocabulary to k most likely tokens.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "presencePenalty",
-              type: "number",
-              isOptional: true,
-              description:
-                "Penalty for token presence (-2 to 2). Reduces repetition.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "frequencyPenalty",
-              type: "number",
-              isOptional: true,
-              description:
-                "Penalty for token frequency (-2 to 2). Reduces repetition of frequent tokens.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "stopSequences",
-              type: "string[]",
-              isOptional: true,
-              description:
-                "Array of strings that will stop generation when encountered.",
-            },
-          ],
-        },
-      ],
-    },
+    MODEL_SETTINGS_OBJECT,
     {
       name: "threadId",
       type: "string",
@@ -652,13 +578,6 @@ const aiSdkResult = await agent.generate("message for agent", {
         },
       ],
     },
-    {
-      name: "maxTokens",
-      type: "number",
-      isOptional: true,
-      description:
-        "Conditions for stopping execution (e.g., step count, token limit).",
-    },
   ]}
 />
 

package/.docs/raw/reference/agents/generateLegacy.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.generateLegacy() (Legacy) | Agents | Mastra Docs"
+title: "Reference: Agent.generateLegacy() (Legacy) | Agents"
 description: "Documentation for the legacy `Agent.generateLegacy()` method in Mastra agents. This method is deprecated and will be removed in a future version."
 ---
 

package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getDefaultGenerateOptionsLegacy() | Agents | Mastra Docs"
+title: "Reference: Agent.getDefaultGenerateOptionsLegacy() | Agents"
 description: "Documentation for the `Agent.getDefaultGenerateOptionsLegacy()` method in Mastra agents, which retrieves the default options used for generateLegacy calls."
 ---
 

package/.docs/raw/reference/agents/getDefaultOptions.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getDefaultOptions() | Agents | Mastra Docs"
+title: "Reference: Agent.getDefaultOptions() | Agents"
 description: "Documentation for the `Agent.getDefaultOptions()` method in Mastra agents, which retrieves the default options used for stream and generate calls."
 ---
 

package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getDefaultStreamOptionsLegacy() | Agents | Mastra Docs"
+title: "Reference: Agent.getDefaultStreamOptionsLegacy() | Agents"
 description: "Documentation for the `Agent.getDefaultStreamOptionsLegacy()` method in Mastra agents, which retrieves the default options used for streamLegacy calls."
 ---
 

package/.docs/raw/reference/agents/getDescription.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getDescription() | Agents | Mastra Docs"
+title: "Reference: Agent.getDescription() | Agents"
 description: "Documentation for the `Agent.getDescription()` method in Mastra agents, which retrieves the agent's description."
 ---
 

package/.docs/raw/reference/agents/getInstructions.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getInstructions() | Agents | Mastra Docs"
+title: "Reference: Agent.getInstructions() | Agents"
 description: "Documentation for the `Agent.getInstructions()` method in Mastra agents, which retrieves the instructions that guide the agent's behavior."
 ---
 

package/.docs/raw/reference/agents/getLLM.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getLLM() | Agents | Mastra Docs"
+title: "Reference: Agent.getLLM() | Agents"
 description: "Documentation for the `Agent.getLLM()` method in Mastra agents, which retrieves the language model instance."
 ---
 

package/.docs/raw/reference/agents/getMemory.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getMemory() | Agents | Mastra Docs"
+title: "Reference: Agent.getMemory() | Agents"
 description: "Documentation for the `Agent.getMemory()` method in Mastra agents, which retrieves the memory system associated with the agent."
 ---
 

package/.docs/raw/reference/agents/getModel.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getModel() | Agents | Mastra Docs"
+title: "Reference: Agent.getModel() | Agents"
 description: "Documentation for the `Agent.getModel()` method in Mastra agents, which retrieves the language model that powers the agent."
 ---
 

package/.docs/raw/reference/agents/getTools.mdx

@@ -0,0 +1,69 @@
+---
+title: "Reference: Agent.getTools() | Agents"
+description: "Documentation for the `Agent.getTools()` method in Mastra agents, which retrieves the tools that the agent can use."
+---
+
+# Agent.getTools()
+
+The `.getTools()` method retrieves the tools configured for an agent, resolving them if they're a function. These tools extend the agent's capabilities, allowing it to perform specific actions or access external systems.
+
+## Usage example
+
+```typescript copy
+await agent.getTools();
+```
+
+## Parameters
+
+<PropertiesTable
+  content={[
+    {
+      name: "options",
+      type: "{ requestContext?: RequestContext }",
+      isOptional: true,
+      defaultValue: "{}",
+      description: "Optional configuration object containing runtime context.",
+    },
+  ]}
+/>
+
+## Returns
+
+<PropertiesTable
+  content={[
+    {
+      name: "tools",
+      type: "TTools | Promise<TTools>",
+      description:
+        "The tools configured for the agent, either as a direct object or a promise that resolves to the tools.",
+    },
+  ]}
+/>
+
+## Extended usage example
+
+```typescript copy
+await agent.getTools({
+  requestContext: new RequestContext(),
+});
+```
+
+### Options parameters
+
+<PropertiesTable
+  content={[
+    {
+      name: "requestContext",
+      type: "RequestContext",
+      isOptional: true,
+      defaultValue: "new RequestContext()",
+      description:
+        "Runtime context for dependency injection and contextual information.",
+    },
+  ]}
+/>
+
+## Related
+
+- [Using tools with agents](/docs/v1/agents/using-tools)
+- [MCP Overview](/docs/v1/mcp/overview)

package/.docs/raw/reference/agents/getVoice.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.getVoice() | Agents | Mastra Docs"
+title: "Reference: Agent.getVoice() | Agents"
 description: "Documentation for the `Agent.getVoice()` method in Mastra agents, which retrieves the voice provider for speech capabilities."
 ---
 

package/.docs/raw/reference/agents/listAgents.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.listAgents() | Agents | Mastra Docs"
+title: "Reference: Agent.listAgents() | Agents"
 description: "Documentation for the `Agent.listAgents()` method in Mastra agents, which retrieves the sub-agents that the agent can access."
 ---
 

package/.docs/raw/reference/agents/listScorers.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.listScorers() | Agents | Mastra Docs"
+title: "Reference: Agent.listScorers() | Agents"
 description: "Documentation for the `Agent.listScorers()` method in Mastra agents, which retrieves the scoring configuration."
 ---
 

package/.docs/raw/reference/agents/listTools.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.listTools() | Agents | Mastra Docs"
+title: "Reference: Agent.listTools() | Agents"
 description: "Documentation for the `Agent.listTools()` method in Mastra agents, which retrieves the tools that the agent can use."
 ---
 
@@ -66,4 +66,4 @@ await agent.listTools({
 ## Related
 
 - [Using tools with agents](/docs/v1/agents/using-tools)
-- [Creating tools](/docs/v1/tools-mcp/overview)
+- [Creating tools](/docs/v1/mcp/overview)

package/.docs/raw/reference/agents/listWorkflows.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: Agent.listWorkflows() | Agents | Mastra Docs"
+title: "Reference: Agent.listWorkflows() | Agents"
 description: "Documentation for the `Agent.listWorkflows()` method in Mastra agents, which retrieves the workflows that the agent can execute."
 ---
 

package/.docs/raw/reference/agents/network.mdx

@@ -1,8 +1,10 @@
 ---
-title: "Reference: Agent.network() | Agents | Mastra Docs"
+title: "Reference: Agent.network() | Agents"
 description: "Documentation for the `Agent.network()` method in Mastra agents, which enables multi-agent collaboration and routing."
 ---
 
+import { MODEL_SETTINGS_OBJECT } from "@site/src/components/ModelSettingsProperties";
+
 # Agent.network()
 
 :::caution Experimental Feature
@@ -208,91 +210,7 @@ await agent.network(`
         },
       ],
     },
-    {
-      name: "modelSettings",
-      type: "CallSettings",
-      isOptional: true,
-      description:
-        "Model-specific settings like temperature, maxTokens, topP, etc. These are passed to the underlying language model.",
-      properties: [
-        {
-          parameters: [
-            {
-              name: "temperature",
-              type: "number",
-              isOptional: true,
-              description:
-                "Controls randomness in the model's output. Higher values (e.g., 0.8) make the output more random, lower values (e.g., 0.2) make it more focused and deterministic.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "maxRetries",
-              type: "number",
-              isOptional: true,
-              description: "Maximum number of retries for failed requests.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "topP",
-              type: "number",
-              isOptional: true,
-              description:
-                "Nucleus sampling. This is a number between 0 and 1. It is recommended to set either temperature or topP, but not both.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "topK",
-              type: "number",
-              isOptional: true,
-              description:
-                "Only sample from the top K options for each subsequent token. Used to remove 'long tail' low probability responses.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "presencePenalty",
-              type: "number",
-              isOptional: true,
-              description:
-                "Presence penalty setting. It affects the likelihood of the model to repeat information that is already in the prompt. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition).",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "frequencyPenalty",
-              type: "number",
-              isOptional: true,
-              description:
-                "Frequency penalty setting. It affects the likelihood of the model to repeatedly use the same words or phrases. A number between -1 (increase repetition) and 1 (maximum penalty, decrease repetition).",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "stopSequences",
-              type: "string[]",
-              isOptional: true,
-              description:
-                "Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated.",
-            },
-          ],
-        },
-      ],
-    },
+    MODEL_SETTINGS_OBJECT,
     {
       name: "runId",
       type: "string",

package/.docs/raw/reference/auth/auth0.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: MastraAuthAuth0 Class | Auth | Mastra Docs"
+title: "Reference: MastraAuthAuth0 Class | Auth"
 description: "API reference for the MastraAuthAuth0 class, which authenticates Mastra applications using Auth0 authentication."
 ---
 

package/.docs/raw/reference/auth/clerk.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Reference: MastraAuthClerk Class | Auth | Mastra Docs"
+title: "Reference: MastraAuthClerk Class | Auth"
 description: "API reference for the MastraAuthClerk class, which authenticates Mastra applications using Clerk authentication."
 ---