@mastra/mcp-docs-server 1.2.26-alpha.8 → 1.2.26

package/.docs/reference/processors/language-detector.md

@@ -26,6 +26,8 @@ const processor = new LanguageDetector({
 
 **options.model** (`MastraModelConfig`): Model configuration for the detection/translation agent
 
+**options.errorStrategy** (`'warn' | 'strict'`): How to handle failures from the internal model call. 'warn' is fail-open: it logs the failure and assumes the content uses a target language. 'strict' is fail-closed: it stops processing with a tripwire.
+
 **options.targetLanguages** (`string[]`): Target language(s) for the project. If content is detected in a different language, it may be translated. Can be language name ('English') or ISO code ('en')
 
 **options.threshold** (`number`): Confidence threshold for language detection (0-1). Only process when detection confidence exceeds this threshold

package/.docs/reference/processors/moderation-processor.md

@@ -26,6 +26,8 @@ const processor = new ModerationProcessor({
 
 **options.model** (`MastraModelConfig`): Model configuration for the moderation agent
 
+**options.errorStrategy** (`'warn' | 'strict'`): How to handle failures from the internal model call. 'warn' is fail-open: it logs the failure and allows the content through unchanged. 'strict' is fail-closed: it stops processing with a tripwire.
+
 **options.categories** (`string[]`): Categories to check for moderation. If not specified, uses default OpenAI categories
 
 **options.threshold** (`number`): Confidence threshold for flagging (0-1). Content is flagged if any category score exceeds this threshold

package/.docs/reference/processors/pii-detector.md

@@ -26,6 +26,8 @@ const processor = new PIIDetector({
 
 **options.model** (`MastraModelConfig`): Model configuration for the detection agent
 
+**options.errorStrategy** (`'warn' | 'strict'`): How to handle failures from the internal model call. 'warn' is fail-open: it logs the failure and allows the content through unchanged. 'strict' is fail-closed: it stops processing with a tripwire. This option doesn't affect regex-only streaming detection.
+
 **options.detectionTypes** (`string[]`): PII types to detect. If not specified, uses default types
 
 **options.threshold** (`number`): Confidence threshold for flagging (0-1). PII is flagged if any category score exceeds this threshold

package/.docs/reference/processors/processor-interface.md

@@ -387,6 +387,8 @@ processLLMRequest?(
 
 **model** (`MastraLanguageModel`): The resolved model that will receive the prompt. Use this to scope provider-specific rewrites.
 
+**messageList** (`MessageList`): The message list the prompt was converted from, when the call path has one. Use it for provenance the converted prompt no longer carries, such as per-turn provider stamps.
+
 **stepNumber** (`number`): Current step number (0-indexed). Step 0 is the initial LLM call.
 
 **steps** (`StepResult[]`): Results from previous steps, including text, toolCalls, and toolResults.

package/.docs/reference/processors/prompt-injection-detector.md

@@ -26,6 +26,8 @@ const processor = new PromptInjectionDetector({
 
 **options.model** (`MastraModelConfig`): Model configuration for the detection agent
 
+**options.errorStrategy** (`'warn' | 'strict'`): How to handle failures from the internal model call. 'warn' is fail-open: it logs the failure and allows the content through unchanged. 'strict' is fail-closed: it stops processing with a tripwire.
+
 **options.detectionTypes** (`string[]`): Detection types to check for. If not specified, uses default categories
 
 **options.threshold** (`number`): Confidence threshold for flagging (0-1). Higher threshold = less sensitive to avoid false positives

package/.docs/reference/processors/provider-history-compat.md

@@ -47,12 +47,13 @@ Mastra agents don't add this processor automatically. Add it explicitly when you
 
 `ProviderHistoryCompat` includes these built-in compatibility rules:
 
-| Rule                                        | Provider     | Timing                      | Behavior                                                                                                                                                    |
-| ------------------------------------------- | ------------ | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `anthropic-tool-id-format`                  | Anthropic    | Reactive API error recovery | Rewrites tool call IDs that contain characters outside `[a-zA-Z0-9_-]` and retries the request.                                                             |
-| `cerebras-strip-reasoning-content`          | Cerebras     | Preemptive prompt rewrite   | Removes assistant `reasoning` parts from the outbound prompt so they're not serialized as unsupported `reasoning_content` fields.                           |
-| `anthropic-strip-foreign-reasoning-content` | Anthropic    | Preemptive prompt rewrite   | Removes non-Anthropic assistant `reasoning` parts from the outbound prompt. Anthropic-native thinking history is preserved.                                 |
-| `azure-system-reminder-transform`           | Azure OpenAI | Preemptive prompt rewrite   | Renames `<system-reminder>` wrappers in user text and system instructions to `<memory-context>` for the outbound request. Stored history remains unchanged. |
+| Rule                                        | Provider             | Timing                      | Behavior                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------- | -------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `anthropic-tool-id-format`                  | Anthropic            | Reactive API error recovery | Rewrites tool call IDs that contain characters outside `[a-zA-Z0-9_-]` and retries the request.                                                                                                                                                                                                                                                             |
+| `cerebras-strip-reasoning-content`          | Cerebras             | Preemptive prompt rewrite   | Removes assistant `reasoning` parts from the outbound prompt so they're not serialized as unsupported `reasoning_content` fields.                                                                                                                                                                                                                           |
+| `anthropic-strip-foreign-reasoning-content` | Anthropic            | Preemptive prompt rewrite   | Removes non-Anthropic assistant `reasoning` parts from the outbound prompt. Anthropic-native thinking history is preserved.                                                                                                                                                                                                                                 |
+| `anthropic-strip-foreign-signed-reasoning`  | Anthropic-compatible | Preemptive prompt rewrite   | Drops signed thinking from the outbound prompt when its origin turn was stamped with a different provider (for example Kimi For Coding ↔ `anthropic/claude-sonnet-4-6`), since the receiving provider can't verify another provider's signature. Turns emptied of all content by the drop are removed from the prompt. Unstamped history is left untouched. |
+| `azure-system-reminder-transform`           | Azure OpenAI         | Preemptive prompt rewrite   | Renames `<system-reminder>` wrappers in user text and system instructions to `<memory-context>` for the outbound request. Stored history remains unchanged.                                                                                                                                                                                                 |
 
 Preemptive rules run through `processLLMRequest` after Mastra converts messages to the model prompt format and before the prompt is sent to the provider. These rewrites affect only the current provider call.
 

package/.docs/reference/processors/system-prompt-scrubber.md

@@ -26,6 +26,8 @@ const processor = new SystemPromptScrubber({
 
 **options.model** (`MastraModelConfig`): Model configuration for the detection agent
 
+**options.errorStrategy** (`'warn' | 'strict'`): How to handle failures from the internal model call. 'warn' is fail-open: it logs the failure and allows the content through unchanged. 'strict' is fail-closed: it stops processing with a tripwire.
+
 **options.strategy** (`'block' | 'warn' | 'filter' | 'redact'`): Strategy when system prompts are detected: 'block' rejects with error, 'warn' logs warning but allows through, 'filter' removes flagged messages, 'redact' replaces with redacted versions
 
 **options.customPatterns** (`string[]`): Custom patterns to detect system prompts (regex strings)

package/.docs/reference/tools/mcp-server.md

@@ -10,6 +10,34 @@ Note that if you only need to use your tools or agents directly within your Mast
 
 It supports both [stdio (subprocess) and SSE (HTTP) MCP transports](https://modelcontextprotocol.io/docs/concepts/transports).
 
+## Operate a remote Mastra server
+
+Use `MastraApiMCPServer` to give MCP clients the Mastra server operations from the `mastra api` CLI. It reads the target server's API schema when it starts and only registers operations supported by that server. Factory commands and routes outside this catalog aren't exposed.
+
+```typescript
+import { Mastra } from '@mastra/core/mastra'
+import { MastraApiMCPServer } from '@mastra/mcp'
+
+const operations = await MastraApiMCPServer.create({
+  url: 'https://my-mastra-server.example.com',
+  headers: {
+    Authorization: `Bearer ${process.env.MASTRA_API_TOKEN}`,
+  },
+})
+
+export const mastra = new Mastra({
+  mcpServers: { operations },
+})
+```
+
+Tool names follow the CLI command hierarchy. For example, `mastra api workflow run start` becomes `workflow_run_start`.
+
+The server can expose 60 tools across agents, workflows, tools, MCP servers, memory threads, working memory, traces, logs, metrics, scores, datasets, experiments, and Trace Intelligence. Each tool uses the input schema returned by the target server. Trace list and get tools also support the CLI's `verbose` option.
+
+The server uses stateless MCP transport. Read operations, mutations, and destructive operations have separate MCP tool annotations. Agent, workflow, experiment, and tool execution are marked as potentially destructive because they can invoke operations that delete or overwrite data. These annotations are hints for MCP clients, not authorization checks. Each tool call sends one request to the target API and doesn't retry mutations.
+
+Use `headers` to authenticate the API schema request. For tool calls, the MCP caller's bearer token replaces the configured `Authorization` header. You can also set `apiPrefix`, `timeoutMs`, `id`, `name`, and `version`.
+
 ## Constructor
 
 To create a new `MCPServer`, you need to provide some basic information about your server, the tools it will offer, and optionally, any agents you want to expose as tools.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.26-alpha.8",
+  "version": "1.2.26",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -27,8 +27,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/mcp": "^1.17.4-alpha.0",
-    "@mastra/core": "1.67.0-alpha.3"
+    "@mastra/mcp": "^1.18.0",
+    "@mastra/core": "1.67.0"
   },
   "devDependencies": {
     "@hono/node-server": "^2.0.0",
@@ -44,9 +44,9 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/types-builder": "0.0.107",
-    "@mastra/core": "1.67.0-alpha.3",
-    "@internal/lint": "0.0.132"
+    "@internal/types-builder": "0.0.108",
+    "@mastra/core": "1.67.0",
+    "@internal/lint": "0.0.133"
   },
   "homepage": "https://mastra.ai",
   "repository": {