@mastra/mcp-docs-server 1.0.0-beta.9 → 1.0.0

package/.docs/raw/reference/core/mastra-class.mdx

@@ -1,16 +1,17 @@
 ---
 title: "Reference: Mastra Class | Core"
 description: "Documentation for the `Mastra` class in Mastra, the core entry point for managing agents, workflows, MCP servers, and server endpoints."
+packages:
+  - "@mastra/core"
+  - "@mastra/libsql"
+  - "@mastra/loggers"
 ---
 
 # Mastra Class
 
-The `Mastra` class is the central orchestrator in any Mastra application, managing agents, workflows, storage, logging, telemetry, and more. Typically, you create a single instance of `Mastra` to coordinate your application.
+The `Mastra` class is the central orchestrator in any Mastra application, managing agents, workflows, storage, logging, observability, and more. Typically, you create a single instance of `Mastra` to coordinate your application.
 
-Think of `Mastra` as a top-level registry:
-
-- Registering **integrations** makes them accessible to **agents**, **workflows**, and **tools** alike.
-- **tools** aren’t registered on `Mastra` directly but are associated with agents and discovered automatically.
+Think of `Mastra` as a top-level registry where you register agents, workflows, tools, and other components that need to be accessible throughout your application.
 
 ## Usage example
 
@@ -37,14 +38,16 @@ export const mastra = new Mastra({
 
 ## Constructor parameters
 
+Visit the [Configuration reference](/reference/v1/configuration) for detailed documentation on all available configuration options.
+
 <PropertiesTable
   content={[
     {
       name: "agents",
-      type: "Agent[]",
-      description: "Array of Agent instances to register",
+      type: "Record<string, Agent>",
+      description: "Agent instances to register, keyed by name",
       isOptional: true,
-      defaultValue: "[]",
+      defaultValue: "{}",
     },
     {
       name: "tools",
@@ -56,7 +59,7 @@ export const mastra = new Mastra({
     },
     {
       name: "storage",
-      type: "MastraStorage",
+      type: "MastraCompositeStore",
       description: "Storage engine instance for persisting data",
       isOptional: true,
     },
@@ -91,15 +94,15 @@ export const mastra = new Mastra({
     },
     {
       name: "tts",
-      type: "Record<string, MastraTTS>",
+      type: "Record<string, MastraVoice>",
       isOptional: true,
-      description: "An object for registering Text-To-Speech services.",
+      description: "Text-to-speech providers for voice synthesis",
     },
     {
-      name: "telemetry",
-      type: "OtelConfig",
+      name: "observability",
+      type: "ObservabilityEntrypoint",
       isOptional: true,
-      description: "Configuration for OpenTelemetry integration.",
+      description: "Observability configuration for tracing and monitoring",
     },
     {
       name: "deployer",
@@ -113,8 +116,6 @@ export const mastra = new Mastra({
       description:
         "Server configuration including port, host, timeout, API routes, middleware, CORS settings, and build options for Swagger UI, API request logging, and OpenAPI docs.",
       isOptional: true,
-      defaultValue:
-        "{ port: 4111, host: localhost,  cors: { origin: '*', allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'], allowHeaders: ['Content-Type', 'Authorization', 'x-mastra-client-type'], exposeHeaders: ['Content-Length', 'X-Requested-With'], credentials: false } }",
     },
     {
       name: "mcpServers",
@@ -129,14 +130,20 @@ export const mastra = new Mastra({
       description:
         "Configuration for the asset bundler with options for externals, sourcemap, and transpilePackages.",
       isOptional: true,
-      defaultValue:
-        "{ externals: [], sourcemap: false, transpilePackages: [] }",
     },
     {
       name: "scorers",
-      type: "Record<string, MastraScorer>",
+      type: "Record<string, Scorer>",
+      description:
+        "Scorers for evaluating agent responses and workflow outputs",
+      isOptional: true,
+      defaultValue: "{}",
+    },
+    {
+      name: "processors",
+      type: "Record<string, Processor>",
       description:
-        "Scorers to register for scoring traces and overriding default scorers used during agent generation or workflow execution. Structured as a key-value pair, with keys being the scorer name and values being the scorer instance.",
+        "Input/output processors for transforming agent inputs and outputs",
       isOptional: true,
       defaultValue: "{}",
     },

package/.docs/raw/reference/core/mastra-model-gateway.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: MastraModelGateway | Core"
 description: "Base class for creating custom model gateways"
+packages:
+  - "@mastra/core"
 ---
 
 # MastraModelGateway

package/.docs/raw/reference/core/setLogger.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Mastra.setLogger() | Core"
 description: "Documentation for the `Mastra.setLogger()` method in Mastra, which sets the logger for all components (agents, workflows, etc.)."
+packages:
+  - "@mastra/core"
 ---
 
 # Mastra.setLogger()
@@ -9,7 +11,7 @@ The `.setLogger()` method is used to set the logger for all components (agents,
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.setLogger({ logger: new PinoLogger({ name: "testLogger" }) });
 ```
 

package/.docs/raw/reference/core/setStorage.mdx

@@ -1,15 +1,17 @@
 ---
 title: "Reference: Mastra.setStorage() | Core"
 description: "Documentation for the `Mastra.setStorage()` method in Mastra, which sets the storage instance for the Mastra instance."
+packages:
+  - "@mastra/core"
 ---
 
 # Mastra.setStorage()
 
-The `.setStorage()` method is used to set the storage instance for the Mastra instance. This method accepts a single `MastraStorage` parameter.
+The `.setStorage()` method is used to set the storage instance for the Mastra instance. This method accepts a single `MastraCompositeStore` parameter.
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.setStorage(
   new LibSQLStore({
     id: 'mastra-storage',
@@ -24,7 +26,7 @@ mastra.setStorage(
   content={[
     {
       name: "storage",
-      type: "MastraStorage",
+      type: "MastraCompositeStore",
       description: "The storage instance to set for the Mastra instance.",
     },
   ]}
@@ -36,5 +38,5 @@ This method does not return a value.
 
 ## Related
 
-- [Storage overview](/docs/v1/server-db/storage)
+- [Storage overview](/reference/v1/storage/overview)
 - [Storage reference](/reference/v1/storage/libsql)

package/.docs/raw/reference/deployer/cloudflare.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: CloudflareDeployer | Deployer"
 description: "Documentation for the CloudflareDeployer class, which deploys Mastra applications to Cloudflare Workers."
+packages:
+  - "@mastra/core"
+  - "@mastra/deployer-cloudflare"
 ---
 
 # CloudflareDeployer
@@ -9,14 +12,13 @@ The `CloudflareDeployer` class handles deployment of standalone Mastra applicati
 
 ## Usage example
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { CloudflareDeployer } from "@mastra/deployer-cloudflare";
 
 export const mastra = new Mastra({
-  // ...
   deployer: new CloudflareDeployer({
-    projectName: "hello-mastra",
+    name: "hello-mastra",
     routes: [
       {
         pattern: "example.com/*",
@@ -24,12 +26,11 @@ export const mastra = new Mastra({
         custom_domain: true
       }
     ],
-    workerNamespace: "my-namespace",
-    env: {
+    vars: {
       NODE_ENV: "production",
       API_KEY: "<api-key>"
     },
-    d1Databases: [
+    d1_databases: [
       {
         binding: "DB",
         database_name: "my-database",
@@ -37,59 +38,27 @@ export const mastra = new Mastra({
         preview_database_id: "your-preview-database-id"
       }
     ],
-    kvNamespaces: [
+    kv_namespaces: [
       {
         binding: "CACHE",
         id: "kv-namespace-id"
       }
     ]
+  })
 });
 ```
 
-## Parameters
+## Constructor options
 
-<PropertiesTable
-  content={[
-    {
-      name: "projectName",
-      type: "string",
-      description: "Name of your worker project.",
-      isOptional: true,
-      defaultValue: "'mastra'",
-    },
-    {
-      name: "routes",
-      type: "CFRoute[]",
-      description:
-        "Array of route configurations for your worker. Each route requires: pattern (string), zone_name (string), custom_domain (boolean, optional).",
-      isOptional: true,
-    },
-    {
-      name: "workerNamespace",
-      type: "string",
-      description: "Namespace for your worker.",
-      isOptional: true,
-    },
-    {
-      name: "env",
-      type: "Record<string, any>",
-      description:
-        "Environment variables to be included in the worker configuration.",
-      isOptional: true,
-    },
-    {
-      name: "d1Databases",
-      type: "D1DatabaseBinding[]",
-      description:
-        "Array of D1 database bindings. Each binding requires: binding (string), database_name (string), database_id (string), preview_database_id (string, optional).",
-      isOptional: true,
-    },
-    {
-      name: "kvNamespaces",
-      type: "KVNamespaceBinding[]",
-      description:
-        "Array of KV namespace bindings. Each binding requires: binding (string), id (string).",
-      isOptional: true,
-    },
-  ]}
-/>
+The `CloudflareDeployer` constructor accepts the same configuration options as `wrangler.json`. See the [Wrangler configuration documentation](https://developers.cloudflare.com/workers/wrangler/configuration/) for all available options.
+
+### Migrating from earlier versions
+
+The following fields are deprecated and should be replaced with their standard `wrangler.json` equivalents:
+
+| Deprecated | Use instead |
+|------------|-------------|
+| `projectName` | `name` |
+| `d1Databases` | `d1_databases` |
+| `kvNamespaces` | `kv_namespaces` |
+| `workerNamespace` | *(removed, no longer used)* |

package/.docs/raw/reference/deployer/deployer.mdx

@@ -2,6 +2,8 @@
 title: "Reference: Deployer | Deployer"
 description: Documentation for the Deployer abstract class, which handles packaging and deployment of Mastra applications.
 asIndexPage: true
+packages:
+  - "@mastra/deployer"
 ---
 
 # Deployer
@@ -28,7 +30,6 @@ class CustomDeployer extends Deployer {
     await this._bundle("server.ts", "mastra.ts", outputDirectory);
 
     // Custom deployment logic
-    // ...
   }
 }
 ```

package/.docs/raw/reference/deployer/netlify.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: NetlifyDeployer | Deployer"
 description: "Documentation for the NetlifyDeployer class, which deploys Mastra applications to Netlify Functions."
+packages:
+  - "@mastra/core"
+  - "@mastra/deployer-netlify"
 ---
 
 # NetlifyDeployer
@@ -9,7 +12,7 @@ The `NetlifyDeployer` class handles deployment of standalone Mastra applications
 
 ## Usage example
 
-```typescript title="src/mastra/index.ts" copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { NetlifyDeployer } from "@mastra/deployer-netlify";
 

package/.docs/raw/reference/deployer/vercel.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: VercelDeployer | Deployer"
 description: "Documentation for the VercelDeployer class, which deploys Mastra applications to Vercel."
+packages:
+  - "@mastra/core"
+  - "@mastra/deployer-vercel"
 ---
 
 # VercelDeployer
@@ -9,12 +12,11 @@ The `VercelDeployer` class handles deployment of standalone Mastra applications
 
 ## Usage example
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { VercelDeployer } from "@mastra/deployer-vercel";
 
 export const mastra = new Mastra({
-  // ...
   deployer: new VercelDeployer(),
 });
 ```
@@ -31,12 +33,11 @@ These options are merged into `.vercel/output/functions/index.func/.vc-config.js
 
 ### Example with overrides
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { VercelDeployer } from "@mastra/deployer-vercel";
 
 export const mastra = new Mastra({
-  // ...
   deployer: new VercelDeployer({
     maxDuration: 600,
     memory: 1536,

package/.docs/raw/reference/evals/answer-relevancy.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Answer Relevancy Scorer | Evals"
 description: Documentation for the Answer Relevancy Scorer in Mastra, which evaluates how well LLM outputs address the input query.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 # Answer Relevancy Scorer
@@ -116,7 +119,7 @@ A relevancy score between 0 and 1:
 
 Evaluate agent responses for relevancy across different scenarios:
 
-```typescript title="src/example-answer-relevancy.ts" showLineNumbers copy
+```typescript title="src/example-answer-relevancy.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createAnswerRelevancyScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/answer-similarity.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Answer Similarity Scorer | Evals"
 description: Documentation for the Answer Similarity Scorer in Mastra, which compares agent outputs against ground truth answers for CI/CD testing.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 # Answer Similarity Scorer
@@ -153,7 +156,7 @@ Score calculation: `max(0, base_score - contradiction_penalty - missing_penalty
 
 Evaluate agent responses for similarity to ground truth across different scenarios:
 
-```typescript title="src/example-answer-similarity.ts" showLineNumbers copy
+```typescript title="src/example-answer-similarity.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/bias.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Bias Scorer | Evals"
 description: Documentation for the Bias Scorer in Mastra, which evaluates LLM outputs for various forms of bias, including gender, political, racial/ethnic, or geographical bias.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 # Bias Scorer
@@ -127,7 +130,7 @@ A bias score between 0 and 1:
 
 Evaluate agent responses for bias across different types of questions:
 
-```typescript title="src/example-bias.ts" showLineNumbers copy
+```typescript title="src/example-bias.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createBiasScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/completeness.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Completeness Scorer | Evals"
 description: Documentation for the Completeness Scorer in Mastra, which evaluates how thoroughly LLM outputs cover key elements present in the input.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 # Completeness Scorer
@@ -109,7 +112,7 @@ A completeness score between 0 and 1:
 
 Evaluate agent responses for completeness across different query complexities:
 
-```typescript title="src/example-completeness.ts" showLineNumbers copy
+```typescript title="src/example-completeness.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createCompletenessScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/content-similarity.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Content Similarity Scorer | Evals"
 description: Documentation for the Content Similarity Scorer in Mastra, which measures textual similarity between strings and provides a matching score.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 # Content Similarity Scorer
@@ -82,7 +85,7 @@ Final score: `similarity_value * scale`
 
 Evaluate textual similarity between expected and actual agent outputs:
 
-```typescript title="src/example-content-similarity.ts" showLineNumbers copy
+```typescript title="src/example-content-similarity.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createContentSimilarityScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/context-precision.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Context Precision Scorer | Evals"
 description: Documentation for the Context Precision Scorer in Mastra. Evaluates the relevance and precision of retrieved context for generating expected outputs using Mean Average Precision.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";
@@ -190,7 +193,7 @@ const scorer = createContextPrecisionScorer({
 
 Evaluate RAG system context retrieval precision for different queries:
 
-```typescript title="src/example-context-precision.ts" showLineNumbers copy
+```typescript title="src/example-context-precision.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createContextPrecisionScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/context-relevance.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Context Relevance Scorer | Evals"
 description: Documentation for the Context Relevance Scorer in Mastra. Evaluates the relevance and utility of provided context for generating agent responses using weighted relevance scoring.
+packages:
+  - "@mastra/evals"
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";

package/.docs/raw/reference/evals/create-scorer.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: createScorer | Evals"
 description: Documentation for creating custom scorers in Mastra, allowing users to define their own evaluation logic using either JavaScript functions or LLM-based prompts.
+packages:
+  - "@mastra/core"
 ---
 
 # createScorer
@@ -11,6 +13,8 @@ Mastra provides a unified `createScorer` factory that allows you to define custo
 
 Use the `createScorer` factory to define your scorer with a name, description, and optional judge configuration. Then chain step methods to build your evaluation pipeline. You must provide at least a `generateScore` step.
 
+**Prompt object steps** are step configurations expressed as objects with `description` + `createPrompt` (and `outputSchema` for `preprocess`/`analyze`). These steps invoke the judge LLM. **Function steps** are plain functions and never call the judge.
+
 ```typescript
 import { createScorer } from "@mastra/core/evals";
 
@@ -98,6 +102,10 @@ This function returns a scorer builder that you can chain step methods onto. See
   ]}
 />
 
+The judge only runs for steps defined as **prompt objects** (`preprocess`, `analyze`, `generateScore`, `generateReason` in prompt mode). If you use function steps only, the judge is never called and there is no LLM output to inspect. In that case, any score/reason must be produced by your functions.
+
+When a prompt-object step runs, its structured LLM output is stored in the corresponding result field (`preprocessStepResult`, `analyzeStepResult`, or the value consumed by `calculateScore` in `generateScore`).
+
 ## Type Safety
 
 You can specify input/output types when creating scorers for better type inference and IntelliSense support:
@@ -111,7 +119,7 @@ import { createScorer } from "@mastra/core/evals";
 
 // Agent scorer with automatic typing
 const agentScorer = createScorer({
-  name: "Agent Response Quality",
+  id: "agent-response-quality",
   description: "Evaluates agent responses",
   type: "agent", // Automatically provides ScorerRunInputForAgent/ScorerRunOutputForAgent
 })
@@ -138,7 +146,7 @@ type CustomInput = { query: string; context: string[] };
 type CustomOutput = { answer: string; confidence: number };
 
 const customScorer = createScorer<CustomInput, CustomOutput>({
-  name: "Custom Scorer",
+  id: "custom-scorer",
   description: "Evaluates custom data",
 }).generateScore(({ run }) => {
   // run.input is typed as CustomInput
@@ -160,7 +168,7 @@ When you use `type: 'agent'`, your scorer is compatible for both adding directly
 
 ```typescript
 const agentTraceScorer = createScorer({
-  name: "Agent Trace Length",
+  id: "agent-trace-length",
   description: "Evaluates agent response length",
   type: "agent",
 }).generateScore(({ run }) => {

package/.docs/raw/reference/evals/faithfulness.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Faithfulness Scorer | Evals"
 description: Documentation for the Faithfulness Scorer in Mastra, which evaluates the factual accuracy of LLM outputs compared to the provided context.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 # Faithfulness Scorer
@@ -126,7 +129,7 @@ A faithfulness score between 0 and 1:
 
 Evaluate agent responses for faithfulness to provided context:
 
-```typescript title="src/example-faithfulness.ts" showLineNumbers copy
+```typescript title="src/example-faithfulness.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createFaithfulnessScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/hallucination.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Hallucination Scorer | Evals"
 description: Documentation for the Hallucination Scorer in Mastra, which evaluates the factual correctness of LLM outputs by identifying contradictions with provided context.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 # Hallucination Scorer
@@ -135,7 +138,7 @@ A hallucination score between 0 and 1:
 
 Evaluate agent responses for hallucinations against provided context:
 
-```typescript title="src/example-hallucination.ts" showLineNumbers copy
+```typescript title="src/example-hallucination.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createHallucinationScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/keyword-coverage.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Keyword Coverage Scorer | Evals"
 description: Documentation for the Keyword Coverage Scorer in Mastra, which evaluates how well LLM outputs cover important keywords from the input.
+packages:
+  - "@mastra/core"
+  - "@mastra/evals"
 ---
 
 # Keyword Coverage Scorer
@@ -106,7 +109,7 @@ The scorer handles several special cases:
 
 Evaluate keyword coverage between input queries and agent responses:
 
-```typescript title="src/example-keyword-coverage.ts" showLineNumbers copy
+```typescript title="src/example-keyword-coverage.ts"
 import { runEvals } from "@mastra/core/evals";
 import { createKeywordCoverageScorer } from "@mastra/evals/scorers/prebuilt";
 import { myAgent } from "./agent";

package/.docs/raw/reference/evals/mastra-scorer.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: MastraScorer | Evals"
 description: Documentation for the MastraScorer base class in Mastra, which provides the foundation for all custom and built-in scorers.
+packages:
+  - "@mastra/core"
 ---
 
 # MastraScorer

package/.docs/raw/reference/evals/noise-sensitivity.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Noise Sensitivity Scorer | Evals"
 description: Documentation for the Noise Sensitivity Scorer in Mastra. A CI/testing scorer that evaluates agent robustness by comparing responses between clean and noisy inputs in controlled test environments.
+packages:
+  - "@mastra/evals"
 ---
 
 import PropertiesTable from "@site/src/components/PropertiesTable";