@mastra/mcp-docs-server 1.2.23-alpha.3 → 1.2.23-alpha.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/.docs/docs/auth/fga.md +15 -15
  2. package/.docs/docs/evals/custom-scorers.md +2 -3
  3. package/.docs/docs/evals/overview.md +9 -9
  4. package/.docs/docs/memory/semantic-recall.md +0 -2
  5. package/.docs/docs/observability/feedback.md +1 -1
  6. package/.docs/docs/observability/integrations/exporters/mastra-storage.md +1 -1
  7. package/.docs/docs/observability/metrics/overview.md +1 -1
  8. package/.docs/docs/observability/overview.md +13 -11
  9. package/.docs/docs/observability/tracing/overview.md +12 -12
  10. package/.docs/docs/studio/observability.md +2 -2
  11. package/.docs/docs/workflows/agents-and-tools.md +0 -4
  12. package/.docs/docs/workflows/control-flow.md +0 -2
  13. package/.docs/models/gateways/merge-gateway.md +2 -1
  14. package/.docs/models/gateways/netlify.md +3 -2
  15. package/.docs/models/gateways/openrouter.md +1 -1
  16. package/.docs/models/gateways/vercel.md +2 -1
  17. package/.docs/models/index.md +1 -1
  18. package/.docs/models/providers/abliteration-ai.md +7 -6
  19. package/.docs/models/providers/coralbricks.md +4 -4
  20. package/.docs/models/providers/cortecs.md +2 -1
  21. package/.docs/models/providers/crossmodel.md +4 -3
  22. package/.docs/models/providers/edenai.md +6 -5
  23. package/.docs/models/providers/empiriolabs.md +1 -2
  24. package/.docs/models/providers/google.md +1 -2
  25. package/.docs/models/providers/groq.md +2 -1
  26. package/.docs/models/providers/hyper.md +8 -6
  27. package/.docs/models/providers/kilo.md +21 -22
  28. package/.docs/models/providers/llmgateway-providers.md +2 -26
  29. package/.docs/models/providers/llmgateway.md +3 -14
  30. package/.docs/models/providers/nano-gpt.md +6 -3
  31. package/.docs/models/providers/requesty.md +4 -4
  32. package/.docs/models/providers/vancine.md +18 -14
  33. package/.docs/reference/agents/durable-agent.md +76 -8
  34. package/.docs/reference/observability/tracing/configuration.md +2 -2
  35. package/.docs/reference/workflows/workflow-methods/agent.md +4 -4
  36. package/.docs/reference/workflows/workflow-methods/tool.md +2 -2
  37. package/CHANGELOG.md +7 -0
  38. package/package.json +5 -5
@@ -22,9 +22,9 @@ FGA is designed for multi-tenant B2B products where permissions are contextual:
22
22
  Configure FGA in your Mastra server config alongside authentication and RBAC:
23
23
 
24
24
  ```typescript
25
- import { Mastra } from '@mastra/core/mastra';
26
- import { MastraFGAPermissions } from '@mastra/core/auth/ee';
27
- import { MastraAuthWorkos, MastraFGAWorkos } from '@mastra/auth-workos';
25
+ import { Mastra } from '@mastra/core/mastra'
26
+ import { MastraFGAPermissions } from '@mastra/core/auth/ee'
27
+ import { MastraAuthWorkos, MastraFGAWorkos } from '@mastra/auth-workos'
28
28
 
29
29
  const mastra = new Mastra({
30
30
  server: {
@@ -35,8 +35,8 @@ const mastra = new Mastra({
35
35
  }),
36
36
  fga: new MastraFGAWorkos({
37
37
  resourceMapping: {
38
- agent: { fgaResourceType: 'team', deriveId: (ctx) => ctx.user.teamId },
39
- workflow: { fgaResourceType: 'team', deriveId: (ctx) => ctx.user.teamId },
38
+ agent: { fgaResourceType: 'team', deriveId: ctx => ctx.user.teamId },
39
+ workflow: { fgaResourceType: 'team', deriveId: ctx => ctx.user.teamId },
40
40
  thread: { fgaResourceType: 'workspace-thread', deriveId: ({ resourceId }) => resourceId },
41
41
  },
42
42
  permissionMapping: {
@@ -50,7 +50,7 @@ const mastra = new Mastra({
50
50
  scope: true,
51
51
  },
52
52
  },
53
- });
53
+ })
54
54
  ```
55
55
 
56
56
  When using `MastraFGAWorkos`, set `fetchMemberships: true` on `MastraAuthWorkos`. WorkOS FGA checks need the user's organization memberships to resolve the correct membership ID for authorization.
@@ -117,7 +117,7 @@ const mastra = new Mastra({
117
117
  scope: true,
118
118
  },
119
119
  },
120
- });
120
+ })
121
121
  ```
122
122
 
123
123
  With `scope: true`, Mastra reads `MASTRA_RESOURCE_ID_KEY` from the request context. `mapUserToResourceId()` sets this value after authentication. Stored resource handlers persist the scope in record metadata and filter list, read, update, publish, and delete operations by that scope.
@@ -155,7 +155,7 @@ const fga = new MastraFGAWorkos({
155
155
  validatePermissions: async permissions => {
156
156
  // Throw if a Mastra permission is missing from permissionMapping.
157
157
  },
158
- });
158
+ })
159
159
  ```
160
160
 
161
161
  Set `auditProtectedRoutes: 'error'` to fail startup when protected routes are missing built-in FGA metadata. If `requireForProtectedRoutes` is enabled, Mastra logs this audit as a warning by default.
@@ -163,7 +163,7 @@ Set `auditProtectedRoutes: 'error'` to fail startup when protected routes are mi
163
163
  For custom routes, prefer route-level `fga` metadata. This keeps authorization policy next to the route:
164
164
 
165
165
  ```typescript
166
- import { createRoute } from '@mastra/server/server-adapter';
166
+ import { createRoute } from '@mastra/server/server-adapter'
167
167
 
168
168
  export const getProjectRoute = createRoute({
169
169
  method: 'GET',
@@ -176,15 +176,15 @@ export const getProjectRoute = createRoute({
176
176
  permission: 'projects:read',
177
177
  },
178
178
  handler: async () => {
179
- return { project: null };
179
+ return { project: null }
180
180
  },
181
- });
181
+ })
182
182
  ```
183
183
 
184
184
  Use `resolveRouteFGA()` only when route metadata must be derived centrally from route, params, or request context. A route map scales better than string-prefix checks:
185
185
 
186
186
  ```typescript
187
- import type { FGARouteConfig, FGARouteResolver } from '@mastra/core/auth/ee';
187
+ import type { FGARouteConfig, FGARouteResolver } from '@mastra/core/auth/ee'
188
188
 
189
189
  const routeFGA = {
190
190
  'GET /billing/:accountId': {
@@ -192,14 +192,14 @@ const routeFGA = {
192
192
  resourceIdParam: 'accountId',
193
193
  permission: 'billing:read',
194
194
  },
195
- } satisfies Record<string, FGARouteConfig>;
195
+ } satisfies Record<string, FGARouteConfig>
196
196
 
197
- const resolveRouteFGA: FGARouteResolver = ({ route }) => routeFGA[`${route.method} ${route.path}`];
197
+ const resolveRouteFGA: FGARouteResolver = ({ route }) => routeFGA[`${route.method} ${route.path}`]
198
198
 
199
199
  const fga = new MastraFGAWorkos({
200
200
  /* ... */
201
201
  resolveRouteFGA,
202
- });
202
+ })
203
203
  ```
204
204
 
205
205
  ## Enforcement points
@@ -319,13 +319,12 @@ const customScorer = createScorer({
319
319
  id: 'recent-output',
320
320
  description: 'Scores only the last response',
321
321
  type: 'agent',
322
- prepareRun: (run) => ({
322
+ prepareRun: run => ({
323
323
  ...run,
324
324
  output: run.output.slice(-1), // Keep only the last message
325
325
  requestContext: undefined,
326
326
  }),
327
- })
328
- .generateScore(({ run }) => {
327
+ }).generateScore(({ run }) => {
329
328
  return run.output.length > 0 ? 1 : 0
330
329
  })
331
330
  ```
@@ -80,35 +80,35 @@ export const evaluatedAgent = new Agent({
80
80
  You can also add scorers to individual workflow steps to evaluate outputs at specific points in your process. Each scorer receives that step's own input and output, so you can measure quality at each step instead of only scoring the final answer:
81
81
 
82
82
  ```typescript
83
- import { createWorkflow, createStep } from "@mastra/core/workflows";
84
- import { z } from "zod";
85
- import { customStepScorer } from "../scorers/custom-step-scorer";
83
+ import { createWorkflow, createStep } from '@mastra/core/workflows'
84
+ import { z } from 'zod'
85
+ import { customStepScorer } from '../scorers/custom-step-scorer'
86
86
 
87
87
  const contentStep = createStep({
88
- id: "content-step",
88
+ id: 'content-step',
89
89
  inputSchema: z.object({ topic: z.string() }),
90
90
  outputSchema: z.object({ content: z.string() }),
91
91
  scorers: {
92
92
  customStepScorer: {
93
93
  scorer: customStepScorer(),
94
94
  sampling: {
95
- type: "ratio",
95
+ type: 'ratio',
96
96
  rate: 1, // Score every step execution
97
97
  },
98
98
  },
99
99
  },
100
100
  execute: async ({ inputData }) => {
101
- return { content: await generateContent(inputData.topic) };
101
+ return { content: await generateContent(inputData.topic) }
102
102
  },
103
- });
103
+ })
104
104
 
105
105
  export const contentWorkflow = createWorkflow({
106
- id: "content-workflow",
106
+ id: 'content-workflow',
107
107
  inputSchema: z.object({ topic: z.string() }),
108
108
  outputSchema: z.object({ content: z.string() }),
109
109
  })
110
110
  .then(contentStep)
111
- .commit();
111
+ .commit()
112
112
  ```
113
113
 
114
114
  For the step-level `scorers` API, see the [Step class reference](https://mastra.ai/reference/workflows/step).
@@ -14,8 +14,6 @@ Semantic recall is RAG-based search that helps agents maintain context across lo
14
14
 
15
15
  It uses vector embeddings of messages for similarity search and integrates with vector stores, plus has configurable context windows around retrieved messages.
16
16
 
17
- ![Diagram showing Mastra Memory semantic recall](/assets/images/semantic-recall-fd7b9336a6d0d18019216cb6d3dbe710.png)
18
-
19
17
  When it's enabled, new messages are used to query a vector DB for semantically similar messages.
20
18
 
21
19
  After getting a response from the LLM, all new messages (user, assistant, and tool calls/results) are inserted into the vector DB to be recalled in later interactions.
@@ -166,7 +166,7 @@ Feedback flows through the observability event bus, so exporters that support fe
166
166
  ## Related
167
167
 
168
168
  - [Observability overview](https://mastra.ai/docs/observability/overview)
169
- - [Tracing overview](https://mastra.ai/docs/observability/tracing/overview)
169
+ - [Traces usage](https://mastra.ai/docs/observability/tracing/overview)
170
170
  - [Metrics overview](https://mastra.ai/docs/observability/metrics/overview)
171
171
  - [Client SDK observability reference](https://mastra.ai/reference/client-js/observability)
172
172
  - [Feedback reference](https://mastra.ai/reference/observability/feedback)
@@ -248,7 +248,7 @@ new MastraStorageExporter({
248
248
 
249
249
  ## Related
250
250
 
251
- - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview)
251
+ - [Traces usage](https://mastra.ai/docs/observability/tracing/overview)
252
252
  - [MastraPlatformExporter](https://mastra.ai/docs/mastra-platform/observability)
253
253
  - [Composite Storage](https://mastra.ai/reference/storage/composite): Combine multiple storage providers
254
254
  - [Storage Configuration](https://mastra.ai/docs/storage)
@@ -104,5 +104,5 @@ In production, always include a timestamp range in metric queries. Time bounds l
104
104
  ## Related
105
105
 
106
106
  - [Observability overview](https://mastra.ai/docs/observability/overview)
107
- - [Tracing overview](https://mastra.ai/docs/observability/tracing/overview)
107
+ - [Traces usage](https://mastra.ai/docs/observability/tracing/overview)
108
108
  - [MastraStorageExporter](https://mastra.ai/docs/observability/integrations/exporters/mastra-storage)
@@ -4,14 +4,16 @@
4
4
 
5
5
  # Observability
6
6
 
7
- Mastra's observability system gives you visibility into every agent run, workflow step, tool call, and model interaction. Agent behavior depends on model responses, prompts, tools, memory, and workflow state, so observability helps you inspect runtime decisions from day one. It captures complementary signals that work together to help you understand what your application is doing and why.
7
+ Mastra's observability system gives you visibility into every agent run, workflow step, tool call, and model interaction. Agent behavior depends on model responses, prompts, tools, memory, and workflow state, so observability helps you inspect runtime decisions from day one.
8
8
 
9
- - [**Configuration**](#configuration): Configure observability once for traces, logs, metrics, and feedback.
10
- - [**Storage**](#storage): Choose storage backends for persisted traces, logs, metrics aggregation, and feedback queries.
11
- - [**Tracing**](https://mastra.ai/docs/observability/tracing/overview): Records every operation as a hierarchical timeline of spans, capturing inputs, outputs, token usage, and timing.
12
- - [**Logging**](https://mastra.ai/docs/observability/logging): Forwards structured log entries from your application and Mastra internals to observability storage, correlated to traces automatically.
13
- - [**Metrics**](https://mastra.ai/docs/observability/metrics/overview): Extracts trace usage and cost data. No additional instrumentation is required.
14
- - [**Feedback**](https://mastra.ai/docs/observability/feedback): Stores ratings, comments, corrections, and other review signals linked to traces and spans.
9
+ Start with the trace-correlated pages:
10
+
11
+ - [**Usage**](https://mastra.ai/docs/observability/tracing/overview): Inspect the span hierarchy, inputs, outputs, token usage, timing, and trace context for an execution.
12
+ - [**Logging**](https://mastra.ai/docs/observability/logging): Forward structured log entries from your application and Mastra internals, correlated to traces automatically.
13
+ - [**Feedback**](https://mastra.ai/docs/observability/feedback): Store ratings, comments, corrections, and other review signals linked to traces and spans.
14
+ - [**Storage**](#storage): Choose backends for persisted traces, logs, metrics aggregation, and feedback queries.
15
+
16
+ Use [**Metrics**](https://mastra.ai/docs/observability/metrics/overview) to analyze aggregate usage, performance, and cost data derived from spans. No additional instrumentation is required. Use [**Configuration**](#configuration) to enable the signals and exporters your application needs.
15
17
 
16
18
  ## When to use observability
17
19
 
@@ -23,15 +25,15 @@ Mastra's observability system gives you visibility into every agent run, workflo
23
25
 
24
26
  ## How the pieces fit together
25
27
 
26
- Tracing is the foundation. When observability is configured, every agent run, workflow execution, tool call, and model interaction produces a [span](https://opentelemetry.io/docs/concepts/signals/traces/#spans). Spans are organized into traces that show the full request lifecycle as a hierarchical timeline.
28
+ When observability is configured, every agent run, workflow execution, tool call, and model interaction produces a [span](https://opentelemetry.io/docs/concepts/signals/traces/#spans). Mastra organizes related spans into traces that show the full request lifecycle as a hierarchical timeline.
27
29
 
28
- Metrics are derived from traces automatically. When a span ends, Mastra extracts duration, token counts, and cost estimates without any extra code. These metrics power the dashboards in [Studio](https://mastra.ai/docs/studio/observability).
30
+ When a span ends, Mastra extracts duration, token counts, and cost estimates without any extra code. These metrics power the aggregate dashboards in [Studio](https://mastra.ai/docs/studio/observability).
29
31
 
30
- Logs are correlated to traces automatically. Every `logger.info()`, `logger.warn()`, or `logger.error()` call within a traced context is tagged with the current trace and span IDs. You can move through from a log entry directly to the trace that produced it.
32
+ Every `logger.info()`, `logger.warn()`, or `logger.error()` call within a traced context is tagged with the current trace and span IDs. You can move from a log entry directly to the trace that produced it.
31
33
 
32
34
  Feedback records human review signals such as ratings, comments, and corrections. Feedback can be linked to traces and spans, then queried with the same observability store used for metrics.
33
35
 
34
- These signals share correlation IDs such as trace ID, span ID, entity type, and entity name. You can use them to move from a metric spike to its traces, logs, and related feedback.
36
+ These records share correlation fields such as trace ID, span ID, entity type, and entity name. You can use them to move from a metric spike to its traces, logs, and related feedback.
35
37
 
36
38
  ## Quickstart
37
39
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
4
4
 
5
- # Traces
5
+ # Usage
6
6
 
7
7
  Tracing is the observability signal that records how a request moves through agents, workflows, tools, and model calls. Mastra represents each operation as a span and groups related spans into a trace so you can inspect the full execution path.
8
8
 
@@ -660,8 +660,8 @@ export const mastra = new Mastra({
660
660
  default: {
661
661
  serviceName: 'my-service',
662
662
  serializationOptions: {
663
- maxStringLength: 2048, // Maximum length for string values (default: 1024)
664
- maxDepth: 10, // Maximum depth for nested objects (default: 6)
663
+ maxStringLength: 2048, // Maximum length for string values (default: 131072)
664
+ maxDepth: 10, // Maximum depth for nested objects (default: 8)
665
665
  maxArrayLength: 100, // Maximum number of items in arrays (default: 50)
666
666
  maxObjectKeys: 75, // Maximum number of keys in objects (default: 50)
667
667
  },
@@ -674,12 +674,12 @@ export const mastra = new Mastra({
674
674
 
675
675
  ### Available options
676
676
 
677
- | Option | Default | Description |
678
- | ----------------- | ------- | ---------------------------------------------------------------- |
679
- | `maxStringLength` | 1024 | Maximum length for string values. Longer strings are truncated. |
680
- | `maxDepth` | 6 | Maximum depth for nested objects. Deeper levels are omitted. |
681
- | `maxArrayLength` | 50 | Maximum number of items in arrays. Additional items are omitted. |
682
- | `maxObjectKeys` | 50 | Maximum number of keys in objects. Additional keys are omitted. |
677
+ | Option | Default | Description |
678
+ | ----------------- | --------------- | ---------------------------------------------------------------- |
679
+ | `maxStringLength` | 131072 (128 KB) | Maximum length for string values. Longer strings are truncated. |
680
+ | `maxDepth` | 8 | Maximum depth for nested objects. Deeper levels are omitted. |
681
+ | `maxArrayLength` | 50 | Maximum number of items in arrays. Additional items are omitted. |
682
+ | `maxObjectKeys` | 50 | Maximum number of keys in objects. Additional keys are omitted. |
683
683
 
684
684
  ### Use cases
685
685
 
@@ -687,9 +687,9 @@ export const mastra = new Mastra({
687
687
 
688
688
  ```ts
689
689
  serializationOptions: {
690
- maxStringLength: 8192, // Capture longer text content
691
- maxDepth: 12, // Handle deeply nested JSON responses
692
- maxArrayLength: 200, // Keep more items from large lists
690
+ maxStringLength: 262144, // Capture longer text content (256 KB)
691
+ maxDepth: 12, // Handle deeply nested JSON responses
692
+ maxArrayLength: 200, // Keep more items from large lists
693
693
  }
694
694
  ```
695
695
 
@@ -102,7 +102,7 @@ Above the trace list, open **Columns** to show or hide input, entity, duration,
102
102
 
103
103
  Token and estimated cost columns require an observability store that supports metrics. These columns stay hidden in the **Branches** view because several branch rows can belong to the same trace.
104
104
 
105
- Tracing filters out low-level framework details so your traces stay focused and readable. Visit the [tracing overview](https://mastra.ai/docs/observability/tracing/overview) for more details.
105
+ Tracing filters out low-level framework details so your traces stay focused and readable. Visit [Traces usage](https://mastra.ai/docs/observability/tracing/overview) for more details.
106
106
 
107
107
  To export a trace, select **Download trace JSON** in the trace panel header. This saves the entire trace as a `trace-<id>.json` file, with every span and its full input, output, metadata, and attributes. Use it to share a trace or attach it to a bug report, or alternatively build an evaluation dataset offline.
108
108
 
@@ -116,6 +116,6 @@ Log forwarding is enabled by default when you configure observability. See [logg
116
116
 
117
117
  - [Observability overview](https://mastra.ai/docs/observability/overview)
118
118
  - [Metrics overview](https://mastra.ai/docs/observability/metrics/overview)
119
- - [Tracing overview](https://mastra.ai/docs/observability/tracing/overview)
119
+ - [Traces usage](https://mastra.ai/docs/observability/tracing/overview)
120
120
  - [Logging](https://mastra.ai/docs/observability/logging)
121
121
  - [Mastra platform observability](https://mastra.ai/docs/mastra-platform/observability)
@@ -41,8 +41,6 @@ const step1 = createStep({
41
41
 
42
42
  Compose an agent as a step using `createStep()` when you don't need to modify the agent call. Use `.map()` to transform the previous step's output into a `prompt` the agent can use.
43
43
 
44
- ![Agent as step](/assets/images/workflows-agent-tools-agent-step-b2f5be22552ce514f7f8cd785ffc5604.jpg)
45
-
46
44
  ```typescript
47
45
  import { testAgent } from '../agents/test-agent'
48
46
  const step1 = createStep(testAgent)
@@ -155,8 +153,6 @@ const step2 = createStep({
155
153
 
156
154
  Compose a tool as a step using `createStep()` when the previous step's output matches the tool's input context. You can use `.map()` to transform the previous step's output if they don't.
157
155
 
158
- ![Tool as step](/assets/images/workflows-agent-tools-tool-step-cfd56227ce83c2d03a8c8d0496faeeef.jpg)
159
-
160
156
  ```typescript
161
157
  import { testTool } from '../tools/test-tool'
162
158
 
@@ -212,8 +212,6 @@ Visit [Choosing the right pattern](#choosing-the-right-pattern) to understand wh
212
212
 
213
213
  Use `.branch()` to choose which step to run based on a condition. All steps in a branch need the same `inputSchema` and `outputSchema` because branching requires consistent schemas so workflows can follow different paths.
214
214
 
215
- ![Conditional branching with .branch()](/assets/images/workflows-control-flow-branch-1913ef107ba0198d73aa3c0a65145b7a.jpg)
216
-
217
215
  ```typescript
218
216
  const step1 = createStep({...})
219
217
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![Merge Gateway logo](https://models.dev/logos/merge-gateway.svg)Merge Gateway
6
6
 
7
- Merge Gateway aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 176 models through Mastra's model router.
7
+ Merge Gateway aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 177 models through Mastra's model router.
8
8
 
9
9
  Learn more in the [Merge Gateway documentation](https://docs.merge.dev/merge-gateway).
10
10
 
@@ -67,6 +67,7 @@ ANTHROPIC_API_KEY=ant-...
67
67
  | `deepseek/deepseek-v3.2` |
68
68
  | `deepseek/deepseek-v4-flash` |
69
69
  | `deepseek/deepseek-v4-flash-0731` |
70
+ | `deepseek/deepseek-v4-flash-0731-fast` |
70
71
  | `deepseek/deepseek-v4-pro` |
71
72
  | `deepseek/deepseek-v4-pro-0423` |
72
73
  | `deepseek/deepseek-v4-pro-0813` |
@@ -4,7 +4,7 @@
4
4
 
5
5
  # Netlify
6
6
 
7
- Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 233 models through Mastra's model router.
7
+ Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 234 models through Mastra's model router.
8
8
 
9
9
  Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
10
10
 
@@ -111,7 +111,6 @@ ANTHROPIC_API_KEY=ant-...
111
111
  | `openrouter/~x-ai/grok-latest` |
112
112
  | `openrouter/~z-ai/glm-latest` |
113
113
  | `openrouter/anthracite-org/magnum-v4-72b` |
114
- | `openrouter/arcee-ai/trinity-large-thinking` |
115
114
  | `openrouter/baidu/ernie-4.5-vl-424b-a47b` |
116
115
  | `openrouter/bytedance-seed/seed-1.6` |
117
116
  | `openrouter/bytedance-seed/seed-1.6-flash` |
@@ -132,6 +131,7 @@ ANTHROPIC_API_KEY=ant-...
132
131
  | `openrouter/deepseek/deepseek-v3.2-exp` |
133
132
  | `openrouter/deepseek/deepseek-v4-flash` |
134
133
  | `openrouter/deepseek/deepseek-v4-flash-0731` |
134
+ | `openrouter/deepseek/deepseek-v4-flash-vision-exp` |
135
135
  | `openrouter/deepseek/deepseek-v4-pro` |
136
136
  | `openrouter/deepseek/deepseek-v4-pro-0813` |
137
137
  | `openrouter/google/gemma-2-27b-it` |
@@ -142,6 +142,7 @@ ANTHROPIC_API_KEY=ant-...
142
142
  | `openrouter/google/gemma-4-31b-it` |
143
143
  | `openrouter/gryphe/mythomax-l2-13b` |
144
144
  | `openrouter/ibm-granite/granite-4.1-8b` |
145
+ | `openrouter/ibm-granite/granite-4.2-8b` |
145
146
  | `openrouter/inception/mercury-2` |
146
147
  | `openrouter/inclusionai/ling-3.0-flash` |
147
148
  | `openrouter/inclusionai/ling-3.0-flash-fin:free` |
@@ -140,10 +140,10 @@ ANTHROPIC_API_KEY=ant-...
140
140
  | `gryphe/mythomax-l2-13b` |
141
141
  | `ibm-granite/granite-4.0-h-micro` |
142
142
  | `ibm-granite/granite-4.1-8b` |
143
+ | `ibm-granite/granite-4.2-8b` |
143
144
  | `inception/mercury-2` |
144
145
  | `inclusionai/ling-3.0-flash` |
145
146
  | `inclusionai/ling-3.0-flash-fin:free` |
146
- | `kwaipilot/kat-coder-air-v2.5` |
147
147
  | `kwaipilot/kat-coder-pro-v2` |
148
148
  | `kwaipilot/kat-coder-pro-v2.5` |
149
149
  | `liquid/lfm-2.5-2.6b:free` |
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
6
6
 
7
- Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 361 models through Mastra's model router.
7
+ Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 362 models through Mastra's model router.
8
8
 
9
9
  Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
10
10
 
@@ -69,6 +69,7 @@ ANTHROPIC_API_KEY=ant-...
69
69
  | `alibaba/qwen3.8-2.4t-a95b` |
70
70
  | `alibaba/qwen3.8-27b` |
71
71
  | `alibaba/qwen3.8-flash` |
72
+ | `alibaba/qwen3.8-flash-next` |
72
73
  | `alibaba/qwen3.8-max` |
73
74
  | `alibaba/wan-v2.5-t2v-preview` |
74
75
  | `alibaba/wan-v2.6-i2v` |
@@ -4,7 +4,7 @@
4
4
 
5
5
  # Model Providers
6
6
 
7
- Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 7044 models from 199 providers through a single API.
7
+ Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 7023 models from 199 providers through a single API.
8
8
 
9
9
  ## Features
10
10
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![abliteration.ai logo](https://models.dev/logos/abliteration-ai.svg)abliteration.ai
6
6
 
7
- Access 2 abliteration.ai models through Mastra's model router. Authentication is handled automatically using the `ABLIT_KEY` environment variable.
7
+ Access 3 abliteration.ai models through Mastra's model router. Authentication is handled automatically using the `ABLIT_KEY` environment variable.
8
8
 
9
9
  Learn more in the [abliteration.ai documentation](https://docs.abliteration.ai/models).
10
10
 
@@ -36,10 +36,11 @@ for await (const chunk of stream) {
36
36
 
37
37
  ## Models
38
38
 
39
- | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
40
- | ----------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
41
- | `abliteration-ai/abliterated-model` | 150K | | | | | | $3 | $3 |
42
- | `abliteration-ai/abliterated-model-large` | 1.0M | | | | | | $5 | $5 |
39
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
40
+ | -------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
41
+ | `abliteration-ai/abliterated-model` | 150K | | | | | | $3 | $3 |
42
+ | `abliteration-ai/abliterated-model-large` | 1.0M | | | | | | $5 | $5 |
43
+ | `abliteration-ai/abliterated-model-large-v2` | 1.0M | | | | | | $5 | $5 |
43
44
 
44
45
  ## Advanced configuration
45
46
 
@@ -69,7 +70,7 @@ const agent = new Agent({
69
70
  model: ({ requestContext }) => {
70
71
  const useAdvanced = requestContext.task === "complex";
71
72
  return useAdvanced
72
- ? "abliteration-ai/abliterated-model-large"
73
+ ? "abliteration-ai/abliterated-model-large-v2"
73
74
  : "abliteration-ai/abliterated-model";
74
75
  }
75
76
  });
@@ -19,7 +19,7 @@ const agent = new Agent({
19
19
  id: "my-agent",
20
20
  name: "My Agent",
21
21
  instructions: "You are a helpful assistant",
22
- model: "coralbricks/glm-5.2-fp4"
22
+ model: "coralbricks/glm-5.3-fp4"
23
23
  });
24
24
 
25
25
  // Generate a response
@@ -38,7 +38,7 @@ for await (const chunk of stream) {
38
38
 
39
39
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
40
40
  | -------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
41
- | `coralbricks/glm-5.2-fp4` | 1.0M | | | | | | $1 | $4 |
41
+ | `coralbricks/glm-5.3-fp4` | 1.0M | | | | | | $1 | $4 |
42
42
  | `coralbricks/gpt-oss-120b` | 131K | | | | | | $0.12 | $0.60 |
43
43
  | `coralbricks/kimi-k3` | 1.0M | | | | | | $3 | $15 |
44
44
 
@@ -52,7 +52,7 @@ const agent = new Agent({
52
52
  name: "custom-agent",
53
53
  model: {
54
54
  url: "https://inference.coralbricks.ai/v1",
55
- id: "coralbricks/glm-5.2-fp4",
55
+ id: "coralbricks/glm-5.3-fp4",
56
56
  apiKey: process.env.CORAL_API_KEY,
57
57
  headers: {
58
58
  "X-Custom-Header": "value"
@@ -71,7 +71,7 @@ const agent = new Agent({
71
71
  const useAdvanced = requestContext.task === "complex";
72
72
  return useAdvanced
73
73
  ? "coralbricks/kimi-k3"
74
- : "coralbricks/glm-5.2-fp4";
74
+ : "coralbricks/glm-5.3-fp4";
75
75
  }
76
76
  });
77
77
  ```
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![Cortecs logo](https://models.dev/logos/cortecs.svg)Cortecs
6
6
 
7
- Access 111 Cortecs models through Mastra's model router. Authentication is handled automatically using the `CORTECS_API_KEY` environment variable.
7
+ Access 112 Cortecs models through Mastra's model router. Authentication is handled automatically using the `CORTECS_API_KEY` environment variable.
8
8
 
9
9
  Learn more in the [Cortecs documentation](https://cortecs.ai).
10
10
 
@@ -55,6 +55,7 @@ for await (const chunk of stream) {
55
55
  | `cortecs/deepseek-v3.2` | 164K | | | | | | $0.30 | $0.49 |
56
56
  | `cortecs/deepseek-v4-flash-0731` | 1.0M | | | | | | $0.13 | $0.28 |
57
57
  | `cortecs/deepseek-v4-pro` | 1.0M | | | | | | $2 | $3 |
58
+ | `cortecs/deepseek-v4-pro-0813` | 1.0M | | | | | | $2 | $4 |
58
59
  | `cortecs/devstral-2512` | 262K | | | | | | $0.45 | $2 |
59
60
  | `cortecs/gemini-2.5-flash` | 1.0M | | | | | | $0.30 | $2 |
60
61
  | `cortecs/gemini-2.5-pro` | 1.0M | | | | | | $1 | $10 |
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![CrossModel logo](https://models.dev/logos/crossmodel.svg)CrossModel
6
6
 
7
- Access 55 CrossModel models through Mastra's model router. Authentication is handled automatically using the `CROSSMODEL_API_KEY` environment variable.
7
+ Access 56 CrossModel models through Mastra's model router. Authentication is handled automatically using the `CROSSMODEL_API_KEY` environment variable.
8
8
 
9
9
  Learn more in the [CrossModel documentation](https://www.crossmodel.ai/docs).
10
10
 
@@ -75,11 +75,12 @@ for await (const chunk of stream) {
75
75
  | `crossmodel/qwen/qwen3.6-flash` | 1.0M | | | | | | $0.19 | $1 |
76
76
  | `crossmodel/qwen/qwen3.6-plus` | 1.0M | | | | | | $0.32 | $2 |
77
77
  | `crossmodel/qwen/qwen3.7-flash` | 1.0M | | | | | | $0.04 | $0.13 |
78
- | `crossmodel/qwen/qwen3.7-max` | 1.0M | | | | | | $2 | $5 |
79
- | `crossmodel/qwen/qwen3.7-plus` | 1.0M | | | | | | $0.29 | $1 |
78
+ | `crossmodel/qwen/qwen3.7-max` | 1.0M | | | | | | $2 | $6 |
79
+ | `crossmodel/qwen/qwen3.7-plus` | 1.0M | | | | | | $0.32 | $1 |
80
80
  | `crossmodel/qwen/qwen3.8-flash` | 1.0M | | | | | | $0.13 | $0.43 |
81
81
  | `crossmodel/qwen/qwen3.8-max` | 1.0M | | | | | | $2 | $6 |
82
82
  | `crossmodel/tencent/hy3` | 262K | | | | | | $0.16 | $0.64 |
83
+ | `crossmodel/tencent/hy4-preview` | 1.0M | | | | | | $0.96 | $3 |
83
84
  | `crossmodel/x-ai/grok-4.3` | 1.0M | | | | | | $1 | $3 |
84
85
  | `crossmodel/x-ai/grok-4.5` | 500K | | | | | | $2 | $6 |
85
86
  | `crossmodel/x-ai/grok-4.6` | 500K | | | | | | $2 | $6 |
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![Eden AI logo](https://models.dev/logos/edenai.svg)Eden AI
6
6
 
7
- Access 238 Eden AI models through Mastra's model router. Authentication is handled automatically using the `EDENAI_API_KEY` environment variable.
7
+ Access 239 Eden AI models through Mastra's model router. Authentication is handled automatically using the `EDENAI_API_KEY` environment variable.
8
8
 
9
9
  Learn more in the [Eden AI documentation](https://docs.edenai.co).
10
10
 
@@ -107,7 +107,7 @@ for await (const chunk of stream) {
107
107
  | `edenai/fireworks_ai/accounts/fireworks/models/gpt-oss-120b` | 131K | | | | | | $0.15 | $0.60 |
108
108
  | `edenai/fireworks_ai/accounts/fireworks/models/muse-glimmer-30b` | 131K | | | | | | $0.35 | $2 |
109
109
  | `edenai/fireworks_ai/gpt-oss-120b` | 131K | | | | | | $0.15 | $0.60 |
110
- | `edenai/flexai/deepseek-v4-flash-0731` | 786K | | | | | | $0.08 | $0.18 |
110
+ | `edenai/flexai/deepseek-v4-flash-0731` | 786K | | | | | | $0.03 | $0.10 |
111
111
  | `edenai/flexai/gpt-oss-120b` | 131K | | | | | | $0.04 | $0.10 |
112
112
  | `edenai/flexai/gpt-oss-20b` | 131K | | | | | | $0.02 | $0.10 |
113
113
  | `edenai/flexai/Muse-Glimmer-30B` | 131K | | | | | | $0.30 | $1 |
@@ -131,8 +131,8 @@ for await (const chunk of stream) {
131
131
  | `edenai/google/gemini-pro-latest` | 1.0M | | | | | | $2 | $12 |
132
132
  | `edenai/groq/openai/gpt-oss-120b` | 131K | | | | | | $0.15 | $0.60 |
133
133
  | `edenai/groq/openai/gpt-oss-20b` | 131K | | | | | | $0.07 | $0.30 |
134
- | `edenai/ionos/meta-llama/Llama-3.3-70B-Instruct` | 128K | | | | | | $0.76 | $0.76 |
135
- | `edenai/ionos/openai/gpt-oss-120b` | 131K | | | | | | $0.17 | $0.76 |
134
+ | `edenai/ionos/meta-llama/Llama-3.3-70B-Instruct` | 128K | | | | | | $0.75 | $0.75 |
135
+ | `edenai/ionos/openai/gpt-oss-120b` | 131K | | | | | | $0.17 | $0.75 |
136
136
  | `edenai/minimax/MiniMax-M2` | 205K | | | | | | $0.30 | $1 |
137
137
  | `edenai/minimax/MiniMax-M2.1` | 205K | | | | | | $0.30 | $1 |
138
138
  | `edenai/minimax/MiniMax-M2.5` | 205K | | | | | | $0.30 | $1 |
@@ -152,6 +152,7 @@ for await (const chunk of stream) {
152
152
  | `edenai/mistral/voxtral-small-latest` | 33K | | | | | | $0.10 | $0.40 |
153
153
  | `edenai/moonshot/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
154
154
  | `edenai/moonshot/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
155
+ | `edenai/moonshot/kimi-k2.7-code-highspeed` | 262K | | | | | | $2 | $8 |
155
156
  | `edenai/moonshot/kimi-k3` | 1.0M | | | | | | $3 | $15 |
156
157
  | `edenai/nebius/deepseek-ai/DeepSeek-V4-Flash-0731` | 1.0M | | | | | | $0.14 | $0.28 |
157
158
  | `edenai/nebius/meta-llama/Llama-3.3-70B-Instruct` | 131K | | | | | | $0.13 | $0.40 |
@@ -223,7 +224,7 @@ for await (const chunk of stream) {
223
224
  | `edenai/qwen/qwen3.8-flash` | 1.0M | | | | | | $0.16 | $0.47 |
224
225
  | `edenai/qwen/qwen3.8-max` | 1.0M | | | | | | $2 | $6 |
225
226
  | `edenai/qwen/qwq-plus` | 131K | | | | | | $0.80 | $2 |
226
- | `edenai/scaleway/deepseek-v4-flash-0731` | 256K | | | | | | $0.47 | $0.93 |
227
+ | `edenai/scaleway/deepseek-v4-flash-0731` | 256K | | | | | | $0.46 | $0.93 |
227
228
  | `edenai/scaleway/gpt-oss-120b` | 128K | | | | | | $0.17 | $0.70 |
228
229
  | `edenai/scaleway/llama-3.3-70b-instruct` | 128K | | | | | | $1 | $1 |
229
230
  | `edenai/tensorx/deepseek/deepseek-v4-flash-0731` | 1.0M | | | | | | $0.25 | $0.30 |
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![EmpirioLabs AI logo](https://models.dev/logos/empiriolabs.svg)EmpirioLabs AI
6
6
 
7
- Access 57 EmpirioLabs AI models through Mastra's model router. Authentication is handled automatically using the `EMPIRIOLABS_API_KEY` environment variable.
7
+ Access 56 EmpirioLabs AI models through Mastra's model router. Authentication is handled automatically using the `EMPIRIOLABS_API_KEY` environment variable.
8
8
 
9
9
  Learn more in the [EmpirioLabs AI documentation](https://docs.empiriolabs.ai).
10
10
 
@@ -62,7 +62,6 @@ for await (const chunk of stream) {
62
62
  | `empiriolabs/minimax-m2-7` | 200K | | | | | | $0.15 | $0.60 |
63
63
  | `empiriolabs/minimax-m2-7-highspeed` | 200K | | | | | | $0.30 | $1 |
64
64
  | `empiriolabs/minimax-m3` | 1.0M | | | | | | $0.23 | $0.90 |
65
- | `empiriolabs/mistral-medium-3` | 130K | | | | | | — | — |
66
65
  | `empiriolabs/mistral-small-4` | 256K | | | | | | $0.15 | $0.60 |
67
66
  | `empiriolabs/muse-glimmer-30b` | 131K | | | | | | $0.20 | $0.80 |
68
67
  | `empiriolabs/muse-spark-1-1` | 1.0M | | | | | | $1 | $4 |