@mastra/mcp-docs-server 1.2.8-alpha.7 → 1.2.8

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 (146) hide show
  1. package/.docs/docs/agent-builder/integrations.md +1 -3
  2. package/.docs/docs/agent-builder/overview.md +2 -0
  3. package/.docs/docs/agents/overview.md +17 -13
  4. package/.docs/docs/agents/skills.md +1 -3
  5. package/.docs/docs/agents/structured-output.md +2 -0
  6. package/.docs/docs/agents/using-tools.md +66 -49
  7. package/.docs/docs/browser/agent-browser.md +1 -0
  8. package/.docs/docs/browser/firecrawl.md +129 -0
  9. package/.docs/docs/browser/overview.md +16 -2
  10. package/.docs/docs/capabilities/channels/slack.md +111 -1
  11. package/.docs/docs/deployment/mastra-server.md +35 -0
  12. package/.docs/docs/deployment/monorepo.md +2 -0
  13. package/.docs/docs/deployment/overview.md +6 -0
  14. package/.docs/docs/deployment/sandbox.md +277 -0
  15. package/.docs/docs/editor/overview.md +2 -6
  16. package/.docs/docs/editor/tools.md +2 -6
  17. package/.docs/docs/evals/multi-turn.md +1 -1
  18. package/.docs/docs/evals/running-in-ci.md +3 -9
  19. package/.docs/docs/getting-started/build-with-ai.md +2 -6
  20. package/.docs/docs/getting-started/manual-install.md +1 -1
  21. package/.docs/docs/index.md +17 -13
  22. package/.docs/docs/long-running-agents/background-tasks.md +2 -2
  23. package/.docs/docs/long-running-agents/goals.md +3 -1
  24. package/.docs/docs/mastra-platform/database.md +12 -6
  25. package/.docs/docs/mastra-platform/deploy.md +14 -7
  26. package/.docs/docs/mastra-platform/environments.md +5 -4
  27. package/.docs/docs/mastra-platform/observability.md +4 -12
  28. package/.docs/docs/mastra-platform/overview.md +1 -1
  29. package/.docs/docs/mastra-platform/regions.md +73 -0
  30. package/.docs/docs/mastra-platform/workspace.md +111 -0
  31. package/.docs/docs/memory/observational-memory.md +77 -2
  32. package/.docs/docs/memory/overview.md +4 -0
  33. package/.docs/docs/observability/feedback.md +4 -0
  34. package/.docs/docs/observability/integrations/bridges/otel.md +1 -3
  35. package/.docs/docs/observability/integrations/exporters/otel.md +1 -3
  36. package/.docs/docs/server/auth/fga.md +40 -0
  37. package/.docs/docs/server/auth/simple-auth.md +1 -3
  38. package/.docs/docs/studio/overview.md +2 -0
  39. package/.docs/docs/workflows/control-flow.md +1 -3
  40. package/.docs/docs/workspace/filesystem.md +1 -0
  41. package/.docs/docs/workspace/sandbox.md +1 -0
  42. package/.docs/guides/getting-started/quickstart.md +40 -25
  43. package/.docs/guides/index.md +1 -1
  44. package/.docs/guides/migrations/vnext-to-standard-apis.md +1 -3
  45. package/.docs/models/environment-variables.md +3 -0
  46. package/.docs/models/gateways/netlify.md +3 -6
  47. package/.docs/models/gateways/openrouter.md +343 -344
  48. package/.docs/models/gateways/vercel.md +11 -5
  49. package/.docs/models/index.md +1 -1
  50. package/.docs/models/providers/aki-io.md +78 -0
  51. package/.docs/models/providers/alibaba-token-plan-cn.md +22 -21
  52. package/.docs/models/providers/alibaba-token-plan.md +22 -21
  53. package/.docs/models/providers/ambient.md +12 -10
  54. package/.docs/models/providers/baseten.md +3 -2
  55. package/.docs/models/providers/cline-pass.md +82 -0
  56. package/.docs/models/providers/cortecs.md +2 -1
  57. package/.docs/models/providers/crossmodel.md +2 -1
  58. package/.docs/models/providers/deepinfra.md +4 -7
  59. package/.docs/models/providers/deepseek.md +3 -1
  60. package/.docs/models/providers/empiriolabs.md +2 -1
  61. package/.docs/models/providers/evroc.md +3 -2
  62. package/.docs/models/providers/google.md +4 -2
  63. package/.docs/models/providers/huggingface.md +2 -1
  64. package/.docs/models/providers/inferx.md +3 -3
  65. package/.docs/models/providers/kenari.md +44 -29
  66. package/.docs/models/providers/kimi-for-coding.md +7 -9
  67. package/.docs/models/providers/llmgateway.md +4 -1
  68. package/.docs/models/providers/moonshotai-cn.md +3 -2
  69. package/.docs/models/providers/moonshotai.md +3 -2
  70. package/.docs/models/providers/nebius.md +3 -1
  71. package/.docs/models/providers/novita-ai.md +3 -1
  72. package/.docs/models/providers/opencode-go.md +6 -3
  73. package/.docs/models/providers/opencode.md +4 -2
  74. package/.docs/models/providers/poolside.md +2 -2
  75. package/.docs/models/providers/thinkingmachines.md +73 -0
  76. package/.docs/models/providers/togetherai.md +2 -6
  77. package/.docs/models/providers/wandb.md +2 -1
  78. package/.docs/models/providers/zenmux.md +3 -1
  79. package/.docs/models/providers.md +3 -0
  80. package/.docs/reference/agent-controller/session.md +13 -0
  81. package/.docs/reference/agents/agent.md +13 -1
  82. package/.docs/reference/agents/generate.md +18 -0
  83. package/.docs/reference/browser/firecrawl-browser.md +71 -0
  84. package/.docs/reference/cli/create-mastra.md +118 -43
  85. package/.docs/reference/cli/mastra.md +59 -5
  86. package/.docs/reference/code-sdk/mount-agent-controller.md +4 -4
  87. package/.docs/reference/core/getMCPServer.md +1 -3
  88. package/.docs/reference/core/getMCPServerById.md +1 -3
  89. package/.docs/reference/core/getWorkflow.md +1 -3
  90. package/.docs/reference/core/listMCPServers.md +2 -6
  91. package/.docs/reference/datasets/addItem.md +1 -3
  92. package/.docs/reference/datasets/addItems.md +1 -3
  93. package/.docs/reference/datasets/compareExperiments.md +1 -3
  94. package/.docs/reference/datasets/create.md +1 -3
  95. package/.docs/reference/datasets/dataset.md +2 -6
  96. package/.docs/reference/datasets/datasets-manager.md +5 -15
  97. package/.docs/reference/datasets/delete.md +1 -3
  98. package/.docs/reference/datasets/deleteExperiment.md +1 -3
  99. package/.docs/reference/datasets/deleteItem.md +1 -3
  100. package/.docs/reference/datasets/deleteItems.md +1 -3
  101. package/.docs/reference/datasets/get.md +1 -3
  102. package/.docs/reference/datasets/getDetails.md +1 -3
  103. package/.docs/reference/datasets/getExperiment.md +1 -3
  104. package/.docs/reference/datasets/getItem.md +1 -3
  105. package/.docs/reference/datasets/getItemHistory.md +1 -3
  106. package/.docs/reference/datasets/list.md +1 -3
  107. package/.docs/reference/datasets/listExperimentResults.md +1 -3
  108. package/.docs/reference/datasets/listExperiments.md +1 -3
  109. package/.docs/reference/datasets/listItems.md +1 -3
  110. package/.docs/reference/datasets/listVersions.md +1 -3
  111. package/.docs/reference/datasets/startExperiment.md +1 -3
  112. package/.docs/reference/datasets/startExperimentAsync.md +1 -3
  113. package/.docs/reference/datasets/update.md +1 -3
  114. package/.docs/reference/datasets/updateItem.md +1 -3
  115. package/.docs/reference/editor/mastra-editor.md +1 -3
  116. package/.docs/reference/evals/context-recall.md +205 -0
  117. package/.docs/reference/evals/create-scorer.md +3 -9
  118. package/.docs/reference/evals/mastra-scorer.md +1 -3
  119. package/.docs/reference/file-based-agents/tools.md +7 -6
  120. package/.docs/reference/index.md +5 -0
  121. package/.docs/reference/memory/observational-memory.md +21 -0
  122. package/.docs/reference/observability/tracing/exporters/posthog.md +39 -1
  123. package/.docs/reference/observability/tracing/processors/sensitive-data-filter.md +1 -3
  124. package/.docs/reference/processors/token-limiter-processor.md +1 -3
  125. package/.docs/reference/rag/database-config.md +12 -0
  126. package/.docs/reference/streaming/agents/stream.md +2 -0
  127. package/.docs/reference/templates/overview.md +6 -32
  128. package/.docs/reference/tools/create-tool.md +78 -52
  129. package/.docs/reference/tools/mcp-client.md +8 -24
  130. package/.docs/reference/tools/mcp-server.md +143 -44
  131. package/.docs/reference/tools/tavily.md +1 -1
  132. package/.docs/reference/tools/vector-query-tool.md +22 -0
  133. package/.docs/reference/vectors/mongodb.md +2 -0
  134. package/.docs/reference/vectors/turbopuffer.md +4 -0
  135. package/.docs/reference/voice/mistral.md +127 -0
  136. package/.docs/reference/workspace/daytona-sandbox.md +2 -6
  137. package/.docs/reference/workspace/platform-filesystem.md +182 -0
  138. package/.docs/reference/workspace/platform-sandbox.md +200 -0
  139. package/.docs/reference/workspace/railway-sandbox.md +37 -1
  140. package/CHANGELOG.md +78 -0
  141. package/dist/{chunk-GLPCVXXO.js → chunk-HGADBLKG.js} +2 -2
  142. package/dist/{chunk-GLPCVXXO.js.map → chunk-HGADBLKG.js.map} +1 -1
  143. package/dist/index.js +1 -1
  144. package/dist/stdio.js +1 -1
  145. package/dist/tools/docs.d.ts.map +1 -1
  146. package/package.json +8 -8
@@ -37,11 +37,11 @@ for await (const chunk of stream) {
37
37
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
38
  | ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
39
  | `inferx/google/gemma-4-31b-it-fp8` | 262K | | | | | | — | — |
40
- | `inferx/qwen/qwen3-coder-next-fp8` | 256K | | | | | | — | — |
41
- | `inferx/qwen/qwen3-coder-next-fp8-1m` | 1.0M | | | | | | — | — |
42
40
  | `inferx/qwen/qwen3.5-122b-a10b-nvfp4` | 256K | | | | | | — | — |
43
41
  | `inferx/qwen/qwen3.6-27b-fp8` | 262K | | | | | | — | — |
44
42
  | `inferx/qwen/qwen3.6-35b-a3b-fp8` | 262K | | | | | | — | — |
43
+ | `inferx/qwen3-coder-next-fp8` | 256K | | | | | | — | — |
44
+ | `inferx/qwen3-coder-next-fp8-1m` | 1.0M | | | | | | — | — |
45
45
 
46
46
  ## Advanced configuration
47
47
 
@@ -71,7 +71,7 @@ const agent = new Agent({
71
71
  model: ({ requestContext }) => {
72
72
  const useAdvanced = requestContext.task === "complex";
73
73
  return useAdvanced
74
- ? "inferx/qwen/qwen3.6-35b-a3b-fp8"
74
+ ? "inferx/qwen3-coder-next-fp8-1m"
75
75
  : "inferx/google/gemma-4-31b-it-fp8";
76
76
  }
77
77
  });
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Kenari logo](https://models.dev/logos/kenari.svg)Kenari
4
4
 
5
- Access 23 Kenari models through Mastra's model router. Authentication is handled automatically using the `KENARI_API_KEY` environment variable.
5
+ Access 38 Kenari models through Mastra's model router. Authentication is handled automatically using the `KENARI_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Kenari documentation](https://kenari.id/docs).
8
8
 
@@ -17,7 +17,7 @@ const agent = new Agent({
17
17
  id: "my-agent",
18
18
  name: "My Agent",
19
19
  instructions: "You are a helpful assistant",
20
- model: "kenari/claude-opus-4-7"
20
+ model: "kenari/claude-fable-5"
21
21
  });
22
22
 
23
23
  // Generate a response
@@ -34,31 +34,46 @@ for await (const chunk of stream) {
34
34
 
35
35
  ## Models
36
36
 
37
- | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
- | ------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
- | `kenari/claude-opus-4-7` | 1.0M | | | | | | — | — |
40
- | `kenari/claude-opus-4-8` | 1.0M | | | | | | — | — |
41
- | `kenari/claude-sonnet-4-6` | 1.0M | | | | | | — | — |
42
- | `kenari/deepseek-v4-flash` | 1.0M | | | | | | — | — |
43
- | `kenari/deepseek-v4-flash:free` | 1.0M | | | | | | — | — |
44
- | `kenari/deepseek-v4-pro` | 1.0M | | | | | | — | — |
45
- | `kenari/deepseek-v4-pro:free` | 1.0M | | | | | | — | — |
46
- | `kenari/gemma-4-31b-it` | 262K | | | | | | — | — |
47
- | `kenari/glm-5-1` | 200K | | | | | | — | — |
48
- | `kenari/glm-5-2` | 1.0M | | | | | | — | — |
49
- | `kenari/gpt-5-4-mini` | 400K | | | | | | — | — |
50
- | `kenari/gpt-5-5` | 1.1M | | | | | | — | — |
51
- | `kenari/gpt-image-2` | 272K | | | | | | — | — |
52
- | `kenari/gpt-oss-120b` | 131K | | | | | | — | — |
53
- | `kenari/gpt-oss-20b` | 131K | | | | | | — | — |
54
- | `kenari/grok-4-3` | 1.0M | | | | | | — | — |
55
- | `kenari/grok-build-0-1` | 256K | | | | | | — | — |
56
- | `kenari/kimi-k2-6` | 262K | | | | | | — | — |
57
- | `kenari/kimi-k2-7-code` | 262K | | | | | | — | — |
58
- | `kenari/mimo-v2-5` | 1.0M | | | | | | — | — |
59
- | `kenari/mimo-v2-5-pro` | 1.0M | | | | | | — | — |
60
- | `kenari/minimax-m3` | 512K | | | | | | — | — |
61
- | `kenari/qwen3-7-plus` | 1.0M | | | | | | — | — |
37
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
+ | ---------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
+ | `kenari/claude-fable-5` | 1.0M | | | | | | — | — |
40
+ | `kenari/claude-opus-4-7` | 1.0M | | | | | | — | — |
41
+ | `kenari/claude-opus-4-8` | 1.0M | | | | | | — | — |
42
+ | `kenari/claude-sonnet-5` | 1.0M | | | | | | — | — |
43
+ | `kenari/deepseek-v4-flash` | 1.0M | | | | | | — | — |
44
+ | `kenari/deepseek-v4-flash:free` | 1.0M | | | | | | — | — |
45
+ | `kenari/deepseek-v4-pro` | 1.0M | | | | | | — | — |
46
+ | `kenari/gemini-2-5-flash` | 1.0M | | | | | | — | — |
47
+ | `kenari/gemini-2-5-flash-lite` | 1.0M | | | | | | — | — |
48
+ | `kenari/gemini-3-1-flash-lite` | 1.0M | | | | | | — | — |
49
+ | `kenari/gemma-4-31b-it` | 262K | | | | | | — | — |
50
+ | `kenari/glm-4-7-flash:free` | 200K | | | | | | — | — |
51
+ | `kenari/glm-5-1` | 200K | | | | | | — | — |
52
+ | `kenari/glm-5-2` | 1.0M | | | | | | — | — |
53
+ | `kenari/gpt-5-4-mini` | 400K | | | | | | — | — |
54
+ | `kenari/gpt-5-5` | 1.1M | | | | | | — | — |
55
+ | `kenari/gpt-5-6-luna` | 1.1M | | | | | | — | — |
56
+ | `kenari/gpt-5-6-sol` | 1.1M | | | | | | — | — |
57
+ | `kenari/gpt-5-6-terra` | 1.1M | | | | | | — | — |
58
+ | `kenari/gpt-image-2` | 272K | | | | | | — | — |
59
+ | `kenari/gpt-oss-120b` | 131K | | | | | | — | — |
60
+ | `kenari/gpt-oss-20b` | 131K | | | | | | — | — |
61
+ | `kenari/grok-4-5` | 500K | | | | | | — | — |
62
+ | `kenari/grok-build-0-1` | 256K | | | | | | — | — |
63
+ | `kenari/kimi-k2-6` | 262K | | | | | | — | — |
64
+ | `kenari/kimi-k2-6:free` | 262K | | | | | | — | — |
65
+ | `kenari/kimi-k2-7-code` | 262K | | | | | | — | — |
66
+ | `kenari/kimi-k2-7-code:free` | 262K | | | | | | — | — |
67
+ | `kenari/kimi-k3` | 1.0M | | | | | | — | — |
68
+ | `kenari/mimo-v2-5` | 1.0M | | | | | | — | — |
69
+ | `kenari/mimo-v2-5-pro` | 1.0M | | | | | | — | — |
70
+ | `kenari/mimo-v2-5:free` | 1.0M | | | | | | — | — |
71
+ | `kenari/minimax-m3` | 512K | | | | | | — | — |
72
+ | `kenari/nemotron-3-nano-30b-a3b` | 262K | | | | | | — | — |
73
+ | `kenari/nemotron-3-super-120b-a12b` | 262K | | | | | | — | — |
74
+ | `kenari/nemotron-3-super-120b-a12b:free` | 262K | | | | | | — | — |
75
+ | `kenari/nemotron-3-ultra-550b-a55b` | 1.0M | | | | | | — | — |
76
+ | `kenari/qwen3-7-plus` | 1.0M | | | | | | — | — |
62
77
 
63
78
  ## Advanced configuration
64
79
 
@@ -70,7 +85,7 @@ const agent = new Agent({
70
85
  name: "custom-agent",
71
86
  model: {
72
87
  url: "https://kenari.id/v1",
73
- id: "kenari/claude-opus-4-7",
88
+ id: "kenari/claude-fable-5",
74
89
  apiKey: process.env.KENARI_API_KEY,
75
90
  headers: {
76
91
  "X-Custom-Header": "value"
@@ -89,7 +104,7 @@ const agent = new Agent({
89
104
  const useAdvanced = requestContext.task === "complex";
90
105
  return useAdvanced
91
106
  ? "kenari/qwen3-7-plus"
92
- : "kenari/claude-opus-4-7";
107
+ : "kenari/claude-fable-5";
93
108
  }
94
109
  });
95
110
  ```
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Kimi For Coding logo](https://models.dev/logos/kimi-for-coding.svg)Kimi For Coding
4
4
 
5
- Access 5 Kimi For Coding models through Mastra's model router. Authentication is handled automatically using the `KIMI_API_KEY` environment variable.
5
+ Access 3 Kimi For Coding models through Mastra's model router. Authentication is handled automatically using the `KIMI_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Kimi For Coding documentation](https://www.kimi.com/code/docs/en/third-party-tools/other-coding-agents.html).
8
8
 
@@ -17,7 +17,7 @@ const agent = new Agent({
17
17
  id: "my-agent",
18
18
  name: "My Agent",
19
19
  instructions: "You are a helpful assistant",
20
- model: "kimi-for-coding/k2p5"
20
+ model: "kimi-for-coding/k3"
21
21
  });
22
22
 
23
23
  // Generate a response
@@ -36,11 +36,9 @@ for await (const chunk of stream) {
36
36
 
37
37
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
38
  | ------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
- | `kimi-for-coding/k2p5` | 262K | | | | | | — | — |
40
- | `kimi-for-coding/k2p6` | 262K | | | | | | — | — |
41
- | `kimi-for-coding/k2p7` | 262K | | | | | | — | — |
39
+ | `kimi-for-coding/k3` | 1.0M | | | | | | — | — |
40
+ | `kimi-for-coding/kimi-for-coding` | 262K | | | | | | — | — |
42
41
  | `kimi-for-coding/kimi-for-coding-highspeed` | 262K | | | | | | — | — |
43
- | `kimi-for-coding/kimi-k2-thinking` | 262K | | | | | | — | — |
44
42
 
45
43
  ## Advanced configuration
46
44
 
@@ -52,7 +50,7 @@ const agent = new Agent({
52
50
  name: "custom-agent",
53
51
  model: {
54
52
  url: "https://api.kimi.com/coding/v1",
55
- id: "kimi-for-coding/k2p5",
53
+ id: "kimi-for-coding/k3",
56
54
  apiKey: process.env.KIMI_API_KEY,
57
55
  headers: {
58
56
  "X-Custom-Header": "value"
@@ -70,8 +68,8 @@ const agent = new Agent({
70
68
  model: ({ requestContext }) => {
71
69
  const useAdvanced = requestContext.task === "complex";
72
70
  return useAdvanced
73
- ? "kimi-for-coding/kimi-k2-thinking"
74
- : "kimi-for-coding/k2p5";
71
+ ? "kimi-for-coding/kimi-for-coding-highspeed"
72
+ : "kimi-for-coding/k3";
75
73
  }
76
74
  });
77
75
  ```
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![LLM Gateway logo](https://models.dev/logos/llmgateway.svg)LLM Gateway
4
4
 
5
- Access 170 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
5
+ Access 173 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
8
8
 
@@ -64,6 +64,8 @@ for await (const chunk of stream) {
64
64
  | `llmgateway/gemini-3.1-flash-lite` | 1.0M | | | | | | $0.25 | $2 |
65
65
  | `llmgateway/gemini-3.1-pro-preview` | 1.0M | | | | | | $2 | $12 |
66
66
  | `llmgateway/gemini-3.5-flash` | 1.0M | | | | | | $2 | $9 |
67
+ | `llmgateway/gemini-3.5-flash-lite` | 1.0M | | | | | | $0.30 | $3 |
68
+ | `llmgateway/gemini-3.6-flash` | 1.0M | | | | | | $2 | $8 |
67
69
  | `llmgateway/gemini-pro-latest` | 1.0M | | | | | | $2 | $12 |
68
70
  | `llmgateway/gemma-4-26b-a4b-it` | 262K | | | | | | $0.07 | $0.34 |
69
71
  | `llmgateway/gemma-4-31b-it` | 262K | | | | | | $0.13 | $0.38 |
@@ -133,6 +135,7 @@ for await (const chunk of stream) {
133
135
  | `llmgateway/kimi-k2.6` | 262K | | | | | | $0.40 | $2 |
134
136
  | `llmgateway/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
135
137
  | `llmgateway/kimi-k2.7-code-highspeed` | 262K | | | | | | $2 | $8 |
138
+ | `llmgateway/kimi-k3` | 1.0M | | | | | | $3 | $15 |
136
139
  | `llmgateway/llama-3-70b-instruct` | 8K | | | | | | $0.51 | $0.74 |
137
140
  | `llmgateway/llama-3.1-70b-instruct` | 128K | | | | | | $0.72 | $0.72 |
138
141
  | `llmgateway/llama-3.1-nemotron-ultra-253b` | 128K | | | | | | $0.60 | $2 |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Moonshot AI (China) logo](https://models.dev/logos/moonshotai-cn.svg)Moonshot AI (China)
4
4
 
5
- Access 9 Moonshot AI (China) models through Mastra's model router. Authentication is handled automatically using the `MOONSHOT_API_KEY` environment variable.
5
+ Access 10 Moonshot AI (China) models through Mastra's model router. Authentication is handled automatically using the `MOONSHOT_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Moonshot AI (China) documentation](https://platform.moonshot.cn).
8
8
 
@@ -45,6 +45,7 @@ for await (const chunk of stream) {
45
45
  | `moonshotai-cn/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
46
46
  | `moonshotai-cn/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
47
47
  | `moonshotai-cn/kimi-k2.7-code-highspeed` | 262K | | | | | | $2 | $8 |
48
+ | `moonshotai-cn/kimi-k3` | 1.0M | | | | | | $3 | $15 |
48
49
 
49
50
  ## Advanced configuration
50
51
 
@@ -74,7 +75,7 @@ const agent = new Agent({
74
75
  model: ({ requestContext }) => {
75
76
  const useAdvanced = requestContext.task === "complex";
76
77
  return useAdvanced
77
- ? "moonshotai-cn/kimi-k2.7-code-highspeed"
78
+ ? "moonshotai-cn/kimi-k3"
78
79
  : "moonshotai-cn/kimi-k2-0711-preview";
79
80
  }
80
81
  });
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Moonshot AI logo](https://models.dev/logos/moonshotai.svg)Moonshot AI
4
4
 
5
- Access 9 Moonshot AI models through Mastra's model router. Authentication is handled automatically using the `MOONSHOT_API_KEY` environment variable.
5
+ Access 10 Moonshot AI models through Mastra's model router. Authentication is handled automatically using the `MOONSHOT_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Moonshot AI documentation](https://platform.moonshot.ai).
8
8
 
@@ -45,6 +45,7 @@ for await (const chunk of stream) {
45
45
  | `moonshotai/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
46
46
  | `moonshotai/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
47
47
  | `moonshotai/kimi-k2.7-code-highspeed` | 262K | | | | | | $2 | $8 |
48
+ | `moonshotai/kimi-k3` | 1.0M | | | | | | $3 | $15 |
48
49
 
49
50
  ## Advanced configuration
50
51
 
@@ -74,7 +75,7 @@ const agent = new Agent({
74
75
  model: ({ requestContext }) => {
75
76
  const useAdvanced = requestContext.task === "complex";
76
77
  return useAdvanced
77
- ? "moonshotai/kimi-k2.7-code-highspeed"
78
+ ? "moonshotai/kimi-k3"
78
79
  : "moonshotai/kimi-k2-0711-preview";
79
80
  }
80
81
  });
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Nebius Token Factory logo](https://models.dev/logos/nebius.svg)Nebius Token Factory
4
4
 
5
- Access 19 Nebius Token Factory models through Mastra's model router. Authentication is handled automatically using the `NEBIUS_API_KEY` environment variable.
5
+ Access 21 Nebius Token Factory models through Mastra's model router. Authentication is handled automatically using the `NEBIUS_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Nebius Token Factory documentation](https://docs.tokenfactory.nebius.com/).
8
8
 
@@ -40,6 +40,8 @@ for await (const chunk of stream) {
40
40
  | `nebius/google/gemma-3-27b-it` | 110K | | | | | | $0.10 | $0.30 |
41
41
  | `nebius/meta-llama/Llama-3.3-70B-Instruct` | 128K | | | | | | $0.13 | $0.40 |
42
42
  | `nebius/MiniMaxAI/MiniMax-M2.5` | 197K | | | | | | $0.30 | $1 |
43
+ | `nebius/MiniMaxAI/MiniMax-M3` | 1.0M | | | | | | $0.30 | $1 |
44
+ | `nebius/moonshotai/Kimi-K2.7-Code` | 262K | | | | | | $0.95 | $4 |
43
45
  | `nebius/NousResearch/Hermes-4-405B` | 128K | | | | | | $1 | $3 |
44
46
  | `nebius/NousResearch/Hermes-4-70B` | 128K | | | | | | $0.13 | $0.40 |
45
47
  | `nebius/nvidia/Llama-3_1-Nemotron-Ultra-253B-v1` | 128K | | | | | | $0.60 | $2 |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![NovitaAI logo](https://models.dev/logos/novita-ai.svg)NovitaAI
4
4
 
5
- Access 105 NovitaAI models through Mastra's model router. Authentication is handled automatically using the `NOVITA_API_KEY` environment variable.
5
+ Access 107 NovitaAI models through Mastra's model router. Authentication is handled automatically using the `NOVITA_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [NovitaAI documentation](https://novita.ai/docs/guides/introduction).
8
8
 
@@ -90,6 +90,8 @@ for await (const chunk of stream) {
90
90
  | `novita-ai/moonshotai/kimi-k2-thinking` | 262K | | | | | | $0.60 | $3 |
91
91
  | `novita-ai/moonshotai/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
92
92
  | `novita-ai/moonshotai/kimi-k2.6` | 262K | | | | | | $0.80 | $3 |
93
+ | `novita-ai/moonshotai/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
94
+ | `novita-ai/moonshotai/kimi-k3` | 1.0M | | | | | | $3 | $15 |
93
95
  | `novita-ai/nousresearch/hermes-2-pro-llama-3-8b` | 8K | | | | | | $0.14 | $0.14 |
94
96
  | `novita-ai/openai/gpt-oss-120b` | 131K | | | | | | $0.05 | $0.25 |
95
97
  | `novita-ai/openai/gpt-oss-20b` | 131K | | | | | | $0.04 | $0.15 |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![OpenCode Go logo](https://models.dev/logos/opencode-go.svg)OpenCode Go
4
4
 
5
- Access 13 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
5
+ Access 16 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [OpenCode Go documentation](https://opencode.ai/docs/zen).
8
8
 
@@ -37,13 +37,16 @@ for await (const chunk of stream) {
37
37
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
38
  | ------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
39
  | `opencode-go/deepseek-v4-flash` | 1.0M | | | | | | $0.14 | $0.28 |
40
- | `opencode-go/deepseek-v4-pro` | 1.0M | | | | | | $2 | $3 |
40
+ | `opencode-go/deepseek-v4-pro` | 1.0M | | | | | | $0.43 | $0.87 |
41
41
  | `opencode-go/glm-5.1` | 203K | | | | | | $1 | $4 |
42
42
  | `opencode-go/glm-5.2` | 1.0M | | | | | | $1 | $4 |
43
+ | `opencode-go/grok-4.5` | 500K | | | | | | $2 | $6 |
44
+ | `opencode-go/hy3` | 256K | | | | | | $0.14 | $0.58 |
43
45
  | `opencode-go/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
44
46
  | `opencode-go/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
47
+ | `opencode-go/kimi-k3` | 1.0M | | | | | | $3 | $15 |
45
48
  | `opencode-go/mimo-v2.5` | 1.0M | | | | | | $0.14 | $0.28 |
46
- | `opencode-go/mimo-v2.5-pro` | 1.0M | | | | | | $2 | $3 |
49
+ | `opencode-go/mimo-v2.5-pro` | 1.0M | | | | | | $0.43 | $0.87 |
47
50
  | `opencode-go/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
48
51
  | `opencode-go/minimax-m3` | 1.0M | | | | | | $0.30 | $1 |
49
52
  | `opencode-go/qwen3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
4
4
 
5
- Access 55 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
5
+ Access 57 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
8
8
 
@@ -54,6 +54,8 @@ for await (const chunk of stream) {
54
54
  | `opencode/gemini-3-flash` | 1.0M | | | | | | $0.50 | $3 |
55
55
  | `opencode/gemini-3.1-pro` | 1.0M | | | | | | $2 | $12 |
56
56
  | `opencode/gemini-3.5-flash` | 1.0M | | | | | | $2 | $9 |
57
+ | `opencode/gemini-3.5-flash-lite` | 1.0M | | | | | | $0.30 | $3 |
58
+ | `opencode/gemini-3.6-flash` | 1.0M | | | | | | $2 | $8 |
57
59
  | `opencode/glm-5` | 205K | | | | | | $1 | $3 |
58
60
  | `opencode/glm-5.1` | 205K | | | | | | $1 | $4 |
59
61
  | `opencode/glm-5.2` | 1.0M | | | | | | $1 | $4 |
@@ -79,10 +81,10 @@ for await (const chunk of stream) {
79
81
  | `opencode/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
80
82
  | `opencode/grok-4.5` | 500K | | | | | | $2 | $6 |
81
83
  | `opencode/grok-build-0.1` | 256K | | | | | | $1 | $2 |
82
- | `opencode/hy3-free` | 190K | | | | | | — | — |
83
84
  | `opencode/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
84
85
  | `opencode/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
85
86
  | `opencode/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
87
+ | `opencode/laguna-s-2.1-free` | 256K | | | | | | — | — |
86
88
  | `opencode/mimo-v2.5-free` | 200K | | | | | | — | — |
87
89
  | `opencode/minimax-m2.5` | 205K | | | | | | $0.30 | $1 |
88
90
  | `opencode/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
@@ -37,8 +37,8 @@ for await (const chunk of stream) {
37
37
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
38
  | --------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
39
  | `poolside/poolside/laguna-m.1` | 262K | | | | | | — | — |
40
+ | `poolside/poolside/laguna-s-2.1` | 1.0M | | | | | | — | — |
40
41
  | `poolside/poolside/laguna-xs-2.1` | 262K | | | | | | — | — |
41
- | `poolside/poolside/laguna-xs.2` | 262K | | | | | | — | — |
42
42
 
43
43
  ## Advanced configuration
44
44
 
@@ -68,7 +68,7 @@ const agent = new Agent({
68
68
  model: ({ requestContext }) => {
69
69
  const useAdvanced = requestContext.task === "complex";
70
70
  return useAdvanced
71
- ? "poolside/poolside/laguna-xs.2"
71
+ ? "poolside/poolside/laguna-xs-2.1"
72
72
  : "poolside/poolside/laguna-m.1";
73
73
  }
74
74
  });
@@ -0,0 +1,73 @@
1
+ > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
2
+
3
+ # ![Thinking Machines logo](https://models.dev/logos/thinkingmachines.svg)Thinking Machines
4
+
5
+ Access 1 Thinking Machines model through Mastra's model router. Authentication is handled automatically using the `TINKER_API_KEY` environment variable.
6
+
7
+ Learn more in the [Thinking Machines documentation](https://tinker-docs.thinkingmachines.ai/tinker/compatible-apis/openai/).
8
+
9
+ ```bash
10
+ TINKER_API_KEY=your-api-key
11
+ ```
12
+
13
+ ```typescript
14
+ import { Agent } from "@mastra/core/agent";
15
+
16
+ const agent = new Agent({
17
+ id: "my-agent",
18
+ name: "My Agent",
19
+ instructions: "You are a helpful assistant",
20
+ model: "thinkingmachines/inkling"
21
+ });
22
+
23
+ // Generate a response
24
+ const response = await agent.generate("Hello!");
25
+
26
+ // Stream a response
27
+ const stream = await agent.stream("Tell me a story");
28
+ for await (const chunk of stream) {
29
+ console.log(chunk);
30
+ }
31
+ ```
32
+
33
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Thinking Machines documentation](https://tinker-docs.thinkingmachines.ai/tinker/compatible-apis/openai/) for details.
34
+
35
+ ## Models
36
+
37
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
+ | -------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
+ | `thinkingmachines/inkling` | 256K | | | | | | $4 | $9 |
40
+
41
+ ## Advanced configuration
42
+
43
+ ### Custom headers
44
+
45
+ ```typescript
46
+ const agent = new Agent({
47
+ id: "custom-agent",
48
+ name: "custom-agent",
49
+ model: {
50
+ url: "https://tinker.thinkingmachines.dev/services/tinker-prod/oai/api/v1",
51
+ id: "thinkingmachines/inkling",
52
+ apiKey: process.env.TINKER_API_KEY,
53
+ headers: {
54
+ "X-Custom-Header": "value"
55
+ }
56
+ }
57
+ });
58
+ ```
59
+
60
+ ### Dynamic model selection
61
+
62
+ ```typescript
63
+ const agent = new Agent({
64
+ id: "dynamic-agent",
65
+ name: "Dynamic Agent",
66
+ model: ({ requestContext }) => {
67
+ const useAdvanced = requestContext.task === "complex";
68
+ return useAdvanced
69
+ ? "thinkingmachines/inkling"
70
+ : "thinkingmachines/inkling";
71
+ }
72
+ });
73
+ ```
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Together AI logo](https://models.dev/logos/togetherai.svg)Together AI
4
4
 
5
- Access 25 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
5
+ Access 21 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Together AI documentation](https://docs.together.ai/docs/serverless-models).
8
8
 
@@ -36,7 +36,6 @@ for await (const chunk of stream) {
36
36
  | ----------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
37
  | `togetherai/deepcogito/cogito-v2-1-671b` | 164K | | | | | | $1 | $1 |
38
38
  | `togetherai/deepseek-ai/DeepSeek-V4-Pro` | 512K | | | | | | $2 | $3 |
39
- | `togetherai/essentialai/Rnj-1-Instruct` | 33K | | | | | | $0.15 | $0.15 |
40
39
  | `togetherai/google/gemma-3n-E4B-it` | 33K | | | | | | $0.06 | $0.12 |
41
40
  | `togetherai/google/gemma-4-31B-it` | 262K | | | | | | $0.39 | $0.97 |
42
41
  | `togetherai/LiquidAI/LFM2-24B-A2B` | 33K | | | | | | $0.03 | $0.12 |
@@ -51,13 +50,10 @@ for await (const chunk of stream) {
51
50
  | `togetherai/openai/gpt-oss-20b` | 131K | | | | | | $0.05 | $0.20 |
52
51
  | `togetherai/pearl-ai/gemma-4-31b-it` | 32K | | | | | | $0.28 | $0.86 |
53
52
  | `togetherai/Qwen/Qwen2.5-7B-Instruct-Turbo` | 33K | | | | | | $0.30 | $0.30 |
54
- | `togetherai/Qwen/Qwen3-235B-A22B-Instruct-2507-tput` | 262K | | | | | | $0.20 | $0.60 |
55
- | `togetherai/Qwen/Qwen3.5-397B-A17B` | 262K | | | | | | $0.60 | $4 |
56
53
  | `togetherai/Qwen/Qwen3.5-9B` | 262K | | | | | | $0.17 | $0.25 |
57
54
  | `togetherai/Qwen/Qwen3.6-Plus` | 1.0M | | | | | | $0.50 | $3 |
58
55
  | `togetherai/Qwen/Qwen3.7-Max` | 1.0M | | | | | | $1 | $4 |
59
- | `togetherai/zai-org/GLM-5` | 203K | | | | | | $1 | $3 |
60
- | `togetherai/zai-org/GLM-5.1` | 203K | | | | | | $1 | $4 |
56
+ | `togetherai/thinkingmachines/Inkling` | 524K | | | | | | $1 | $4 |
61
57
  | `togetherai/zai-org/GLM-5.2` | 262K | | | | | | $1 | $4 |
62
58
 
63
59
  ## Advanced configuration
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Weights & Biases logo](https://models.dev/logos/wandb.svg)Weights & Biases
4
4
 
5
- Access 25 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
5
+ Access 26 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Weights & Biases documentation](https://docs.wandb.ai).
8
8
 
@@ -46,6 +46,7 @@ for await (const chunk of stream) {
46
46
  | `wandb/meta-llama/Llama-3.1-8B-Instruct` | 128K | | | | | | $0.22 | $0.22 |
47
47
  | `wandb/meta-llama/Llama-3.3-70B-Instruct` | 128K | | | | | | $0.71 | $0.71 |
48
48
  | `wandb/MiniMaxAI/MiniMax-M2.5` | 197K | | | | | | $0.30 | $1 |
49
+ | `wandb/MiniMaxAI/MiniMax-M3` | 262K | | | | | | $0.29 | $1 |
49
50
  | `wandb/moonshotai/Kimi-K2.5` | 262K | | | | | | $0.60 | $3 |
50
51
  | `wandb/moonshotai/Kimi-K2.6` | 262K | | | | | | $0.95 | $4 |
51
52
  | `wandb/moonshotai/Kimi-K2.7-Code` | 262K | | | | | | $0.94 | $4 |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![ZenMux logo](https://models.dev/logos/zenmux.svg)ZenMux
4
4
 
5
- Access 118 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
5
+ Access 120 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [ZenMux documentation](https://docs.zenmux.ai).
8
8
 
@@ -83,6 +83,8 @@ for await (const chunk of stream) {
83
83
  | `zenmux/moonshotai/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
84
84
  | `zenmux/moonshotai/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
85
85
  | `zenmux/moonshotai/kimi-k2.7-code-free` | 262K | | | | | | — | — |
86
+ | `zenmux/moonshotai/kimi-k3` | 1.0M | | | | | | $3 | $15 |
87
+ | `zenmux/moonshotai/kimi-k3-free` | 1.0M | | | | | | — | — |
86
88
  | `zenmux/openai/gpt-5` | 400K | | | | | | $1 | $10 |
87
89
  | `zenmux/openai/gpt-5-codex` | 400K | | | | | | $1 | $10 |
88
90
  | `zenmux/openai/gpt-5.1` | 400K | | | | | | $1 | $10 |
@@ -15,6 +15,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
15
15
  - [Abacus](https://mastra.ai/models/providers/abacus)
16
16
  - [abliteration.ai](https://mastra.ai/models/providers/abliteration-ai)
17
17
  - [AI-ROUTER](https://mastra.ai/models/providers/ai-router)
18
+ - [AKI.IO](https://mastra.ai/models/providers/aki-io)
18
19
  - [Alibaba](https://mastra.ai/models/providers/alibaba)
19
20
  - [Alibaba (China)](https://mastra.ai/models/providers/alibaba-cn)
20
21
  - [Alibaba Coding Plan](https://mastra.ai/models/providers/alibaba-coding-plan)
@@ -33,6 +34,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
33
34
  - [Chutes](https://mastra.ai/models/providers/chutes)
34
35
  - [Clarifai](https://mastra.ai/models/providers/clarifai)
35
36
  - [Claudinio](https://mastra.ai/models/providers/claudinio)
37
+ - [ClinePass](https://mastra.ai/models/providers/cline-pass)
36
38
  - [CloudFerro Sherlock](https://mastra.ai/models/providers/cloudferro-sherlock)
37
39
  - [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)
38
40
  - [Cortecs](https://mastra.ai/models/providers/cortecs)
@@ -131,6 +133,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
131
133
  - [Tencent Token Plan](https://mastra.ai/models/providers/tencent-token-plan)
132
134
  - [Tencent TokenHub](https://mastra.ai/models/providers/tencent-tokenhub)
133
135
  - [The Grid AI](https://mastra.ai/models/providers/the-grid-ai)
136
+ - [Thinking Machines](https://mastra.ai/models/providers/thinkingmachines)
134
137
  - [Tinfoil](https://mastra.ai/models/providers/tinfoil)
135
138
  - [Together AI](https://mastra.ai/models/providers/togetherai)
136
139
  - [TrustedRouter](https://mastra.ai/models/providers/trustedrouter)
@@ -57,6 +57,19 @@ The session is organized into sub-objects, each owning one domain of per-convers
57
57
 
58
58
  ## Methods
59
59
 
60
+ ### Workspace
61
+
62
+ #### `getWorkspace()`
63
+
64
+ Return the workspace resolved for this session. This preserves session-level overrides and workspaces selected from the session scope.
65
+
66
+ ```typescript
67
+ const workspace = agentController.session.getWorkspace()
68
+ const skill = await workspace.skills?.get('code-review')
69
+ ```
70
+
71
+ Returns: `Workspace`
72
+
60
73
  ### Permissions
61
74
 
62
75
  Session-scoped grants auto-approve tools without prompting. Grants are ephemeral — they reset when the session restarts and are never persisted.
@@ -96,6 +96,18 @@ export const agent = new Agent({
96
96
  })
97
97
  ```
98
98
 
99
+ ## Model strings
100
+
101
+ For the simplest setup, pass `model` as a string in `provider/model` format. Separate the provider and model name with a slash. Mastra reads the matching provider credentials from the environment, so this format doesn't require a provider package or import.
102
+
103
+ Popular provider strings and credentials:
104
+
105
+ - **OpenAI**: `openai/gpt-5.5` uses `OPENAI_API_KEY`.
106
+ - **Anthropic**: `anthropic/claude-sonnet-4-6` uses `ANTHROPIC_API_KEY`.
107
+ - **Google**: `google/gemini-2.5-pro` uses `GOOGLE_API_KEY` or `GOOGLE_GENERATIVE_AI_API_KEY`.
108
+
109
+ See [models](https://mastra.ai/models) for supported model IDs and [environment variables](https://mastra.ai/models/environment-variables) for the complete provider list.
110
+
99
111
  ## Thread signals
100
112
 
101
113
  Use Agent signals to send real-time input and context into a memory thread. Message APIs are for user-authored input. `sendSignal()` is the lower-level API for system-generated context.
@@ -435,7 +447,7 @@ Returns an `AgentThreadSubscription` object with these members:
435
447
 
436
448
  **instructions** (`SystemMessage | ({ requestContext: RequestContext }) => SystemMessage | Promise<SystemMessage>`): Instructions that guide the agent's behavior. Can be a string, array of strings, system message object, array of system messages, or a function that returns any of these types dynamically. SystemMessage types: string | string\[] | CoreSystemMessage | CoreSystemMessage\[] | SystemModelMessage | SystemModelMessage\[]
437
449
 
438
- **model** (`MastraLanguageModel | ({ requestContext: RequestContext }) => MastraLanguageModel | Promise<MastraLanguageModel>`): The language model used by the agent. Can be provided statically or resolved at runtime.
450
+ **model** (`MastraLanguageModel | ({ requestContext: RequestContext }) => MastraLanguageModel | Promise<MastraLanguageModel>`): The language model used by the agent. Pass a model router string in provider/model format, a model configuration or provider instance, or a function that resolves the model at runtime. See Model strings for common providers and environment variables.
439
451
 
440
452
  **agents** (`Record<string, Agent> | ({ requestContext: RequestContext }) => Record<string, Agent> | Promise<Record<string, Agent>>`): Subagents that the agent can access. Can be provided statically or resolved dynamically.
441
453