@mastra/mcp-docs-server 1.2.7-alpha.6 → 1.2.7

package/.docs/guides/build-your-ui/copilotkit/overview.md

@@ -10,7 +10,7 @@ Visit the [CopilotKit documentation](https://docs.copilotkit.ai/) to learn more
 
 > **Info:** For a full-stack integration approach where Mastra runs directly in your Next.js API routes, see the [CopilotKit Quickstart](https://docs.copilotkit.ai/mastra/quickstart) guide.
 
-> **Tip:** Visit Mastra's ["UI Dojo"](https://ui-dojo.mastra.ai/) to see real-world examples of CopilotKit integrated with Mastra.
+Visit Mastra's ["UI Dojo"](https://ui-dojo.mastra.ai/) to see real-world examples of CopilotKit integrated with Mastra.
 
 ## Integration guide
 

package/.docs/guides/concepts/streaming.md

@@ -29,7 +29,7 @@ for await (const chunk of stream.textStream) {
 }
 ```
 
-> **Info:** Visit [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream) for more information.
+Visit [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream) for more information.
 
 > **Tip:** For agents that dispatch [background tasks](https://mastra.ai/docs/long-running-agents/background-tasks), use [`Agent.streamUntilIdle()`](https://mastra.ai/reference/streaming/agents/streamUntilIdle) to keep the stream open until those tasks complete and the agent has had a chance to respond to their results.
 
@@ -101,7 +101,7 @@ for await (const chunk of stream) {
 }
 ```
 
-> **Info:** Visit [Run.stream()](https://mastra.ai/reference/streaming/workflows/stream) for more information.
+Visit [Run.stream()](https://mastra.ai/reference/streaming/workflows/stream) for more information.
 
 ### Output from `Run.stream()`
 
@@ -160,7 +160,7 @@ for await (const chunk of stream) {
 }
 ```
 
-> **Info:** Visit [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream) for more information.
+Visit [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream) for more information.
 
 ### Example agent output
 

package/.docs/guides/guide/chef-michel.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# How to build an AI chef assistant
+# Building an AI chef assistant
 
 In this guide, you'll create a "Chef Assistant" agent that helps users cook meals with available ingredients.
 

package/.docs/guides/guide/coding-agent.md

@@ -0,0 +1,392 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Building a coding agent
+
+In this guide, you'll build a small coding-agent application in the same category as Mastra Code, Claude Code, or Codex. You'll create the coding agent with `buildBasePrompt()` and `createCodingAgent()`, wrap it in an `AgentController` for interactive sessions and tool approvals, and run the controller in a terminal UI built with pi-tui.
+
+The video below shows the coding agent you'll build in action.
+
+## Prerequisites
+
+- Node.js `v22.19.0` or later installed
+- An API key from a supported [Model Provider](https://mastra.ai/models)
+- An existing Mastra project. Follow the [installation guide](https://mastra.ai/guides/getting-started/quickstart) if needed.
+
+## Install the terminal dependencies
+
+Install [pi-tui](https://github.com/earendil-works/pi/tree/main/packages/tui) and `tsx`:
+
+**npm**:
+
+```bash
+npm install @earendil-works/pi-tui
+npm install --save-dev tsx
+```
+
+**pnpm**:
+
+```bash
+pnpm add @earendil-works/pi-tui
+pnpm add --save-dev tsx
+```
+
+**Yarn**:
+
+```bash
+yarn add @earendil-works/pi-tui
+yarn add --dev tsx
+```
+
+**Bun**:
+
+```bash
+bun add @earendil-works/pi-tui
+bun add --dev tsx
+```
+
+pi-tui provides the terminal renderer and input editor. `tsx` runs the TypeScript entry point directly.
+
+## Create the coding agent
+
+Create `src/mastra/agents/coding-agent.ts`. The prompt describes the current project and maps the prompt's generic tool names to the tools supplied by the default workspace.
+
+```typescript
+import { basename } from 'node:path'
+import { buildBasePrompt, createCodingAgent } from '@mastra/core/coding-agent'
+
+export const projectPath = process.cwd()
+const model = 'openai/gpt-5.5'
+
+const instructions = buildBasePrompt({
+  projectPath,
+  projectName: basename(projectPath),
+  platform: process.platform,
+  date: new Date().toISOString().slice(0, 10),
+  mode: 'build',
+  modelId: model,
+  productName: 'My Coding Agent',
+  coAuthorName: 'My Coding Agent',
+  coAuthorEmail: 'coding-agent@example.com',
+  toolGuidance: `# Workspace tools
+- Use mastra_workspace_read_file for view.
+- Use mastra_workspace_list_files for find_files.
+- Use mastra_workspace_grep for search_content.
+- Use mastra_workspace_execute_command for execute_command.
+- Use mastra_workspace_write_file, mastra_workspace_edit_file, and mastra_workspace_file_stat for writing, editing, and inspecting file metadata.
+- Use only the workspace tools provided to you. Do not attempt unavailable capabilities.`,
+})
+
+export const codingAgent = createCodingAgent({
+  id: 'coding-agent',
+  name: 'Coding Agent',
+  model,
+  instructions,
+  basePath: projectPath,
+})
+```
+
+Replace the branding values with the name and co-author details for your agent. `createCodingAgent()` supplies a local filesystem and sandbox workspace, along with defaults for recovering from transient provider errors. The `basePath` scopes the filesystem tools and sets the initial working directory for commands. Any configuration you pass to the factory takes precedence over its defaults.
+
+The default local sandbox runs commands directly on the host without isolation, so `basePath` isn't an operating-system security boundary. This example adds per-tool-call approval in the terminal, but you should still run it only against a trusted local project.
+
+## Register the coding agent
+
+Register the returned agent like any other Mastra agent in `src/mastra/index.ts`. Registration also makes the underlying agent available in Studio and through the Mastra server.
+
+```typescript
+import { Mastra } from '@mastra/core/mastra'
+import { codingAgent } from './agents/coding-agent'
+
+export const mastra = new Mastra({
+  agents: { codingAgent },
+})
+```
+
+## Test the coding agent
+
+Before adding the terminal interface, verify the underlying agent in Studio. When the development server starts, its working directory is `src/mastra/public`, so add a non-sensitive file there for the agent to inspect:
+
+```md
+# Project notes
+
+Name: Acme support portal
+Status: In development
+Owner: Platform team
+```
+
+Start the development server:
+
+**npm**:
+
+```bash
+npm run dev
+```
+
+**pnpm**:
+
+```bash
+pnpm run dev
+```
+
+**Yarn**:
+
+```bash
+yarn dev
+```
+
+**Bun**:
+
+```bash
+bun run dev
+```
+
+Open [Studio](https://mastra.ai/docs/studio/overview), select **Coding Agent**, and enter:
+
+```text
+Inspect project-notes.md and report the project name, status, and owner. Do not modify files.
+```
+
+The response should identify the Acme support portal, its development status, and the Platform team without changing the file. Model wording may vary.
+
+## Create the agent controller
+
+Create `src/mastra/coding-agent-controller.ts`. The controller owns the interactive session, exposes UI events, and pauses workspace tools for approval.
+
+```typescript
+import { AgentController } from '@mastra/core/agent-controller'
+import { codingAgent, projectPath } from './agents/coding-agent'
+
+export async function createCodingAgentSession() {
+  const workspace = await codingAgent.getWorkspace()
+
+  if (!workspace) {
+    throw new Error('The coding agent requires a workspace.')
+  }
+
+  const controller = new AgentController({
+    id: 'coding-agent-controller',
+    agent: codingAgent,
+    workspace,
+    modes: [{ id: 'build', name: 'Build', metadata: { default: true } }],
+    disableBuiltinTools: [
+      'ask_user',
+      'submit_plan',
+      'task_write',
+      'task_update',
+      'task_complete',
+      'task_check',
+      'subagent',
+    ],
+  })
+
+  await controller.init()
+
+  const session = await controller.createSession({
+    id: 'local-session',
+    ownerId: 'local-user',
+    resourceId: projectPath,
+  })
+
+  return { controller, session }
+}
+```
+
+This example uses one mode and disables the controller's additional built-in tools so the introductory UI can focus on workspace execution. This is a tutorial simplification, not a production recommendation. In a production application, enable the built-in tools your product needs and implement their UI flows: interactive tools such as `ask_user` and `submit_plan` suspend until your interface resumes them, while task and subagent tools have their own lifecycle events. See [tool approvals and suspensions](https://mastra.ai/docs/agent-controller/tool-approvals).
+
+The example also omits storage, so the conversation lasts only for the current process. You can add storage later when you want to resume sessions.
+
+## Build the terminal UI
+
+Create `src/coding-agent-tui.ts`. The UI renders assistant message updates, shows tool activity, and asks the user to approve or decline each workspace tool call.
+
+```typescript
+import { pathToFileURL } from 'node:url'
+import {
+  Editor,
+  matchesKey,
+  ProcessTerminal,
+  Text,
+  TUI,
+  type EditorTheme,
+  type Terminal,
+} from '@earendil-works/pi-tui'
+import { createCodingAgentSession } from './mastra/coding-agent-controller'
+
+const plain = (text: string) => text
+const editorTheme: EditorTheme = {
+  borderColor: plain,
+  selectList: {
+    selectedPrefix: plain,
+    selectedText: plain,
+    description: plain,
+    scrollInfo: plain,
+    noMatch: plain,
+  },
+}
+
+function getText(message: { content: Array<{ type: string; text?: string }> }) {
+  return message.content
+    .filter(part => part.type === 'text')
+    .map(part => part.text ?? '')
+    .join('')
+}
+
+export async function startCodingAgentTui(terminal: Terminal = new ProcessTerminal()) {
+  const { controller, session } = await createCodingAgentSession()
+  const tui = new TUI(terminal)
+  const output = new Text('Ask me to inspect or change this project.', 1, 0)
+  const editor = new Editor(tui, editorTheme)
+
+  let busy = false
+  let pendingApproval: { toolCallId: string; toolName: string } | undefined
+
+  const showError = (error: unknown) => {
+    output.setText(`Error: ${error instanceof Error ? error.message : String(error)}`)
+    busy = false
+    pendingApproval = undefined
+    tui.requestRender()
+  }
+
+  const unsubscribe = session.subscribe(event => {
+    if (event.type === 'message_update' && event.message.role === 'assistant') {
+      output.setText(getText(event.message))
+    } else if (event.type === 'tool_start') {
+      output.setText(`Running ${event.toolName}...`)
+    } else if (event.type === 'tool_approval_required') {
+      pendingApproval = { toolCallId: event.toolCallId, toolName: event.toolName }
+      output.setText(`Allow ${event.toolName}? Enter y or n.`)
+    } else if (event.type === 'agent_end') {
+      busy = false
+    } else if (event.type === 'error') {
+      showError(event.error)
+      return
+    }
+
+    tui.requestRender()
+  })
+
+  editor.onSubmit = value => {
+    if (pendingApproval) {
+      const answer = value.trim().toLowerCase()
+      if (answer !== 'y' && answer !== 'n') {
+        output.setText(`Allow ${pendingApproval.toolName}? Enter y or n.`)
+        tui.requestRender()
+        return
+      }
+
+      const approval = pendingApproval
+      pendingApproval = undefined
+      session.respondToToolApproval({
+        toolCallId: approval.toolCallId,
+        decision: answer === 'y' ? 'approve' : 'decline',
+      })
+      return
+    }
+
+    if (busy || !value.trim()) return
+
+    busy = true
+    output.setText('Thinking...')
+    tui.requestRender()
+    void session.sendMessage({ content: value.trim() }).catch(showError)
+  }
+
+  tui.addChild(new Text('My Coding Agent', 1, 0))
+  tui.addChild(output)
+  tui.addChild(editor)
+  tui.setFocus(editor)
+
+  let stopPromise: Promise<void> | undefined
+  let removeInputListener = () => {}
+
+  const stop = () => {
+    stopPromise ??= (async () => {
+      process.off('SIGINT', handleExit)
+      removeInputListener()
+      session.abort()
+      unsubscribe()
+      tui.stop()
+      await controller.destroy()
+    })()
+    return stopPromise
+  }
+
+  const handleExit = () => {
+    void stop().catch(error => {
+      console.error(error)
+      process.exitCode = 1
+    })
+  }
+
+  removeInputListener = tui.addInputListener(data => {
+    if (!matchesKey(data, 'ctrl+c')) return
+    handleExit()
+    return { consume: true }
+  })
+  process.once('SIGINT', handleExit)
+  tui.start()
+
+  return { stop }
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  await startCodingAgentTui()
+}
+```
+
+The optional `Terminal` parameter supports automated tests while using `ProcessTerminal` during normal execution. The UI intentionally renders only the latest response; the `Session` still maintains the conversation context for follow-up prompts.
+
+## Run the coding agent
+
+Start the terminal application from the project root so `process.cwd()` points to the project you want the agent to use:
+
+**npm**:
+
+```bash
+npx tsx src/coding-agent-tui.ts
+```
+
+**pnpm**:
+
+```bash
+pnpm dlx tsx src/coding-agent-tui.ts
+```
+
+**Yarn**:
+
+```bash
+yarn dlx tsx src/coding-agent-tui.ts
+```
+
+**Bun**:
+
+```bash
+bun x tsx src/coding-agent-tui.ts
+```
+
+Enter this prompt:
+
+```text
+Inspect package.json and report the package name and available scripts. Do not modify files.
+```
+
+When the controller asks whether to allow `mastra_workspace_read_file`, enter `y`. The agent reads `package.json` and reports what it finds. Model wording varies, but the response should include the package name and its scripts without changing the file.
+
+Press **Ctrl+C** to close the application and destroy the controller.
+
+## Next steps
+
+You can extend this foundation to:
+
+- Add storage to persist and resume controller sessions
+- Add more modes with different instructions and workspace-tool allowlists
+- Replace the latest-response component with a transcript that renders tool calls and results
+- Add sandbox isolation before accepting untrusted prompts or distributing the application
+
+Learn more:
+
+- [`createCodingAgent()` reference](https://mastra.ai/reference/coding-agent/create-coding-agent)
+- [`buildBasePrompt()` reference](https://mastra.ai/reference/coding-agent/build-base-prompt)
+- [AgentController overview](https://mastra.ai/docs/agent-controller/overview)
+- [`AgentController` reference](https://mastra.ai/reference/agent-controller/agent-controller-class)
+- [Workspace overview](https://mastra.ai/docs/workspace/overview)

package/.docs/guides/migrations/mastra-cloud.md

@@ -271,7 +271,7 @@ mastra studio deploy
 
 The CLI builds your project, uploads the artifact, and deploys it. On first deploy, a `.mastra-project.json` file is created to link your local project to the platform. Commit this file to your repository.
 
-The deploy requires a `.env` or `.env.*` file in the project directory. If none exists the CLI errors with `No env file found for deploy.` after the build completes — add at least an empty `.env` before running the command.
+A local env file is optional. When a `.env` or `.env.*` file is present in the project directory, the deploy bundles its environment variables.
 
 To create a new platform project in one non-interactive step (instead of running `mastra studio projects create` separately), pass a name with `--project` and accept defaults with `--yes`:
 
@@ -283,21 +283,14 @@ See [Studio deployment](https://mastra.ai/docs/studio/deployment) for details.
 
 ### Multiple environments
 
-Mastra platform projects don't have a built-in concept of named environments (for example `staging` vs `production`). To deploy the same codebase to multiple environments, create one project per environment and pair each deploy with the matching env file using `--env-file`.
-
-The pattern below uses one `.env.<env>` file per environment, deploys to a project named `my-app-<env>`, and overrides `.mastra-project.json` per deploy with `MASTRA_ORG_ID` and `MASTRA_PROJECT_ID`:
+A single Mastra platform project runs the same codebase across multiple named [environments](https://mastra.ai/docs/mastra-platform/environments), such as `production` and `staging`. Deploy to each with the unified [`mastra deploy`](https://mastra.ai/docs/mastra-platform/deploy) command:
 
 ```bash
-# First deploy of each environment — creates the project
-mastra studio deploy --project "my-app-staging" --env-file .env.staging --yes
-mastra studio deploy --project "my-app-production" --env-file .env.production --yes
-
-# Subsequent deploys (CI/CD) — target the existing project
-MASTRA_PROJECT_ID="<staging-id>" mastra studio deploy --env-file .env.staging --yes
-MASTRA_PROJECT_ID="<production-id>" mastra studio deploy --env-file .env.production --yes
+mastra deploy --env production --yes
+mastra deploy --env staging --env-file .env.staging --yes
 ```
 
-Each environment ends up with its own Studio URL and its own observability data. Send `MASTRA_PLATFORM_ACCESS_TOKEN` and `MASTRA_PROJECT_ID` per environment so `MastraPlatformExporter` routes traces to the correct project.
+Each environment gets its own URL, its own environment variables, and its own deploy history.
 
 ## Deploy Server (optional)
 

package/.docs/models/environment-variables.md

@@ -9,6 +9,7 @@ List of required environment variables for each model provider and gateway suppo
 | [302.AI](https://mastra.ai/models/providers/302ai)                                             | `302ai/*`                  | `302AI_API_KEY`                                                                                       |
 | [Abacus](https://mastra.ai/models/providers/abacus)                                            | `abacus/*`                 | `ABACUS_API_KEY`                                                                                      |
 | [abliteration.ai](https://mastra.ai/models/providers/abliteration-ai)                          | `abliteration-ai/*`        | `ABLIT_KEY`                                                                                           |
+| [AI-ROUTER](https://mastra.ai/models/providers/ai-router)                                      | `ai-router/*`              | `AI_ROUTER_API_KEY`                                                                                   |
 | [Alibaba](https://mastra.ai/models/providers/alibaba)                                          | `alibaba/*`                | `DASHSCOPE_API_KEY`                                                                                   |
 | [Alibaba (China)](https://mastra.ai/models/providers/alibaba-cn)                               | `alibaba-cn/*`             | `DASHSCOPE_API_KEY`                                                                                   |
 | [Alibaba Coding Plan](https://mastra.ai/models/providers/alibaba-coding-plan)                  | `alibaba-coding-plan/*`    | `ALIBABA_CODING_PLAN_API_KEY`                                                                         |
@@ -23,6 +24,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Bailing](https://mastra.ai/models/providers/bailing)                                          | `bailing/*`                | `BAILING_API_TOKEN`                                                                                   |
 | [Baseten](https://mastra.ai/models/providers/baseten)                                          | `baseten/*`                | `BASETEN_API_KEY`                                                                                     |
 | [Berget.AI](https://mastra.ai/models/providers/berget)                                         | `berget/*`                 | `BERGET_API_KEY`                                                                                      |
+| [Blue Claw](https://mastra.ai/models/providers/blueclaw)                                       | `blueclaw/*`               | `BLUECLAW_API_KEY`                                                                                    |
 | [Cerebras](https://mastra.ai/models/providers/cerebras)                                        | `cerebras/*`               | `CEREBRAS_API_KEY`                                                                                    |
 | [Chutes](https://mastra.ai/models/providers/chutes)                                            | `chutes/*`                 | `CHUTES_API_KEY`                                                                                      |
 | [Clarifai](https://mastra.ai/models/providers/clarifai)                                        | `clarifai/*`               | `CLARIFAI_PAT`                                                                                        |
@@ -31,12 +33,16 @@ List of required environment variables for each model provider and gateway suppo
 | [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)              | `cloudflare-workers-ai/*`  | `CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_API_KEY`                                                         |
 | [Cortecs](https://mastra.ai/models/providers/cortecs)                                          | `cortecs/*`                | `CORTECS_API_KEY`                                                                                     |
 | [CrofAI](https://mastra.ai/models/providers/crof)                                              | `crof/*`                   | `CROF_API_KEY`                                                                                        |
+| [CrossModel](https://mastra.ai/models/providers/crossmodel)                                    | `crossmodel/*`             | `CROSSMODEL_API_KEY`                                                                                  |
 | [D.Run (China)](https://mastra.ai/models/providers/drun)                                       | `drun/*`                   | `DRUN_API_KEY`                                                                                        |
+| [DaoXE](https://mastra.ai/models/providers/daoxe)                                              | `daoxe/*`                  | `DAOXE_API_KEY`                                                                                       |
 | [Databricks](https://mastra.ai/models/providers/databricks)                                    | `databricks/*`             | `DATABRICKS_HOST`, `DATABRICKS_TOKEN`                                                                 |
 | [Deep Infra](https://mastra.ai/models/providers/deepinfra)                                     | `deepinfra/*`              | `DEEPINFRA_API_KEY`                                                                                   |
 | [DeepSeek](https://mastra.ai/models/providers/deepseek)                                        | `deepseek/*`               | `DEEPSEEK_API_KEY`                                                                                    |
 | [DigitalOcean](https://mastra.ai/models/providers/digitalocean)                                | `digitalocean/*`           | `DIGITALOCEAN_ACCESS_TOKEN`                                                                           |
 | [DInference](https://mastra.ai/models/providers/dinference)                                    | `dinference/*`             | `DINFERENCE_API_KEY`                                                                                  |
+| [EBCloud](https://mastra.ai/models/providers/ebcloud)                                          | `ebcloud/*`                | `EBCLOUD_API_KEY`                                                                                     |
+| [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs)                               | `empiriolabs/*`            | `EMPIRIOLABS_API_KEY`                                                                                 |
 | [evroc](https://mastra.ai/models/providers/evroc)                                              | `evroc/*`                  | `EVROC_API_KEY`                                                                                       |
 | [FastRouter](https://mastra.ai/models/providers/fastrouter)                                    | `fastrouter/*`             | `FASTROUTER_API_KEY`                                                                                  |
 | [Fireworks AI](https://mastra.ai/models/providers/fireworks-ai)                                | `fireworks-ai/*`           | `FIREWORKS_API_KEY`                                                                                   |
@@ -54,6 +60,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Inception](https://mastra.ai/models/providers/inception)                                      | `inception/*`              | `INCEPTION_API_KEY`                                                                                   |
 | [Inceptron](https://mastra.ai/models/providers/inceptron)                                      | `inceptron/*`              | `INCEPTRON_API_KEY`                                                                                   |
 | [Inference](https://mastra.ai/models/providers/inference)                                      | `inference/*`              | `INFERENCE_API_KEY`                                                                                   |
+| [InferX](https://mastra.ai/models/providers/inferx)                                            | `inferx/*`                 | `INFERX_API_KEY`                                                                                      |
 | [IO.NET](https://mastra.ai/models/providers/io-net)                                            | `io-net/*`                 | `IOINTELLIGENCE_API_KEY`                                                                              |
 | [Jiekou.AI](https://mastra.ai/models/providers/jiekou)                                         | `jiekou/*`                 | `JIEKOU_API_KEY`                                                                                      |
 | [Kenari](https://mastra.ai/models/providers/kenari)                                            | `kenari/*`                 | `KENARI_API_KEY`                                                                                      |
@@ -67,7 +74,9 @@ List of required environment variables for each model provider and gateway suppo
 | [LMStudio](https://mastra.ai/models/providers/lmstudio)                                        | `lmstudio/*`               | `LMSTUDIO_API_KEY`                                                                                    |
 | [LongCat](https://mastra.ai/models/providers/longcat)                                          | `longcat/*`                | `LONGCAT_API_KEY`                                                                                     |
 | [LucidQuery](https://mastra.ai/models/providers/lucidquery)                                    | `lucidquery/*`             | `LUCIDQUERY_API_KEY`                                                                                  |
+| [Lynkr](https://mastra.ai/models/providers/lynkr)                                              | `lynkr/*`                  | `LYNKR_API_KEY`                                                                                       |
 | [Meganova](https://mastra.ai/models/providers/meganova)                                        | `meganova/*`               | `MEGANOVA_API_KEY`                                                                                    |
+| [Meta](https://mastra.ai/models/providers/meta)                                                | `meta/*`                   | `META_MODEL_API_KEY`                                                                                  |
 | [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)                             | `minimax/*`                | `MINIMAX_API_KEY`                                                                                     |
 | [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)                        | `minimax-cn/*`             | `MINIMAX_API_KEY`                                                                                     |
 | [MiniMax Token Plan (minimax.io)](https://mastra.ai/models/providers/minimax-coding-plan)      | `minimax-coding-plan/*`    | `MINIMAX_API_KEY`                                                                                     |
@@ -75,6 +84,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Mistral](https://mastra.ai/models/providers/mistral)                                          | `mistral/*`                | `MISTRAL_API_KEY`                                                                                     |
 | [Mixlayer](https://mastra.ai/models/providers/mixlayer)                                        | `mixlayer/*`               | `MIXLAYER_API_KEY`                                                                                    |
 | [Moark](https://mastra.ai/models/providers/moark)                                              | `moark/*`                  | `MOARK_API_KEY`                                                                                       |
+| [Model Oracle AI](https://mastra.ai/models/providers/model-oracle-ai)                          | `model-oracle-ai/*`        | `MODEL_ORACLE_API_KEY`                                                                                |
 | [ModelScope](https://mastra.ai/models/providers/modelscope)                                    | `modelscope/*`             | `MODELSCOPE_API_KEY`                                                                                  |
 | [Moonshot AI](https://mastra.ai/models/providers/moonshotai)                                   | `moonshotai/*`             | `MOONSHOT_API_KEY`                                                                                    |
 | [Moonshot AI (China)](https://mastra.ai/models/providers/moonshotai-cn)                        | `moonshotai-cn/*`          | `MOONSHOT_API_KEY`                                                                                    |
@@ -95,6 +105,7 @@ List of required environment variables for each model provider and gateway suppo
 | [OVHcloud AI Endpoints](https://mastra.ai/models/providers/ovhcloud)                           | `ovhcloud/*`               | `OVHCLOUD_API_KEY`                                                                                    |
 | [Perplexity](https://mastra.ai/models/providers/perplexity)                                    | `perplexity/*`             | `PERPLEXITY_API_KEY`                                                                                  |
 | [Perplexity Agent](https://mastra.ai/models/providers/perplexity-agent)                        | `perplexity-agent/*`       | `PERPLEXITY_API_KEY`                                                                                  |
+| [Pioneer](https://mastra.ai/models/providers/pioneer)                                          | `pioneer/*`                | `PIONEER_API_KEY`                                                                                     |
 | [Poe](https://mastra.ai/models/providers/poe)                                                  | `poe/*`                    | `POE_API_KEY`                                                                                         |
 | [Poolside](https://mastra.ai/models/providers/poolside)                                        | `poolside/*`               | `POOLSIDE_API_KEY`                                                                                    |
 | [Privatemode AI](https://mastra.ai/models/providers/privatemode-ai)                            | `privatemode-ai/*`         | `PRIVATEMODE_API_KEY`                                                                                 |
@@ -110,8 +121,10 @@ List of required environment variables for each model provider and gateway suppo
 | [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)                       | `siliconflow-cn/*`         | `SILICONFLOW_CN_API_KEY`                                                                              |
 | [Snowflake Cortex](https://mastra.ai/models/providers/snowflake-cortex)                        | `snowflake-cortex/*`       | `SNOWFLAKE_ACCOUNT`, `SNOWFLAKE_CORTEX_PAT`                                                           |
 | [STACKIT](https://mastra.ai/models/providers/stackit)                                          | `stackit/*`                | `STACKIT_API_KEY`                                                                                     |
-| [StepFun](https://mastra.ai/models/providers/stepfun)                                          | `stepfun/*`                | `STEPFUN_API_KEY`                                                                                     |
-| [StepFun AI](https://mastra.ai/models/providers/stepfun-ai)                                    | `stepfun-ai/*`             | `STEPFUN_API_KEY`                                                                                     |
+| [StepFun (China)](https://mastra.ai/models/providers/stepfun)                                  | `stepfun/*`                | `STEPFUN_API_KEY`                                                                                     |
+| [StepFun (Global)](https://mastra.ai/models/providers/stepfun-ai)                              | `stepfun-ai/*`             | `STEPFUN_API_KEY`                                                                                     |
+| [StepFun Step Plan (China)](https://mastra.ai/models/providers/stepfun-step-plan)              | `stepfun-step-plan/*`      | `STEPFUN_API_KEY`                                                                                     |
+| [StepFun Step Plan (Global)](https://mastra.ai/models/providers/stepfun-ai-step-plan)          | `stepfun-ai-step-plan/*`   | `STEPFUN_API_KEY`                                                                                     |
 | [Subconscious](https://mastra.ai/models/providers/subconscious)                                | `subconscious/*`           | `SUBCONSCIOUS_API_KEY`                                                                                |
 | [submodel](https://mastra.ai/models/providers/submodel)                                        | `submodel/*`               | `SUBMODEL_INSTAGEN_ACCESS_KEY`                                                                        |
 | [Synthetic](https://mastra.ai/models/providers/synthetic)                                      | `synthetic/*`              | `SYNTHETIC_API_KEY`                                                                                   |
@@ -124,6 +137,7 @@ List of required environment variables for each model provider and gateway suppo
 | [TrustedRouter](https://mastra.ai/models/providers/trustedrouter)                              | `trustedrouter/*`          | `TRUSTEDROUTER_API_KEY`                                                                               |
 | [Umans AI](https://mastra.ai/models/providers/umans-ai)                                        | `umans-ai/*`               | `UMANS_AI_API_KEY`                                                                                    |
 | [Umans AI Coding Plan](https://mastra.ai/models/providers/umans-ai-coding-plan)                | `umans-ai-coding-plan/*`   | `UMANS_AI_CODING_PLAN_API_KEY`                                                                        |
+| [UnoRouter](https://mastra.ai/models/providers/unorouter)                                      | `unorouter/*`              | `UNOROUTER_API_KEY`                                                                                   |
 | [Upstage](https://mastra.ai/models/providers/upstage)                                          | `upstage/*`                | `UPSTAGE_API_KEY`                                                                                     |
 | [Vivgrid](https://mastra.ai/models/providers/vivgrid)                                          | `vivgrid/*`                | `VIVGRID_API_KEY`                                                                                     |
 | [Vultr](https://mastra.ai/models/providers/vultr)                                              | `vultr/*`                  | `VULTR_API_KEY`                                                                                       |