@mastra/mcp-docs-server 1.2.14-alpha.1 → 1.2.14-alpha.4

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

@@ -2,70 +2,69 @@
 
 # CopilotKit channels
 
-The same Mastra agent that powers your in-app copilot can also run as a bot in messaging platforms. CopilotKit's bot layer connects your agent to Slack, Discord, Telegram, WhatsApp, and Microsoft Teams, with threads, tool calls, and human-in-the-loop approvals handled in the channel.
+The same Mastra agent that powers your in-app copilot can also run as a bot in messaging platforms. CopilotKit's Channels SDK connects your agent to Slack and other messaging platforms, with threads, tool calls, rich interactive messages, and human-in-the-loop approvals handled natively in the channel.
 
-> **Info:** The full setup lives in the [CopilotKit bot documentation](https://docs.copilotkit.ai/slack). This page shows how it fits together with a Mastra agent.
+> **Info:** Full platform setup lives in the [CopilotKit Channels documentation](https://docs.copilotkit.ai/slack/mastra). This page shows how Channels fit together with a Mastra agent.
 
 ## How it fits together
 
-Your Mastra agent stays where it's, exposed through `registerCopilotKit()` as described in [CopilotKit overview](https://mastra.ai/guides/build-your-ui/copilotkit/overview). The bot is a separate process built with `@copilotkit/bot`: you attach one or more platform adapters and point the bot at your agent. `createBot` takes an array of adapters, so a single bot can serve several platforms at once.
+Your Mastra agent stays where it's deployed, exposed over AG-UI through `registerCopilotKit()` (see [CopilotKit overview](https://mastra.ai/guides/build-your-ui/copilotkit/overview)). A channel is a separate long-running process built with `@copilotkit/channels`: you attach one or more platform adapters and point the channel at your agent. `createChannel` takes an array of adapters, so a single process can serve several platforms at once.
 
-```typescript
-import { createBot } from '@copilotkit/bot'
-import { slack } from '@copilotkit/bot-slack'
-
-const bot = createBot({
-  adapters: [
-    slack({
-      botToken: process.env.SLACK_BOT_TOKEN!,
-      appToken: process.env.SLACK_APP_TOKEN!,
-    }),
-  ],
-  // Point the bot at your agent.
-  agent: threadId => {
-    // ...connect to your CopilotKit runtime / Mastra agent
-  },
-})
-
-bot.onMention(async ({ thread }) => {
-  await thread.runAgent()
-})
-
-await bot.start()
-```
-
-Rich messages are written as JSX and rendered to each platform's native message format (Block Kit on Slack, for example), so an interactive card degrades gracefully where a platform has no equivalent.
-
-## Slack
-
-The [Slack quickstart](https://docs.copilotkit.ai/slack) takes you from zero to a bot you can `@`-mention in a channel, then adds an interactive button card. Slack runs over Socket Mode, which opens an outbound WebSocket to Slack, so no public URL or tunnel is required during development.
-
-Install the packages:
+Install the SDK (batteries-included, every adapter):
 
 **npm**:
 
 ```bash
-npm install @copilotkit/bot @copilotkit/bot-ui @copilotkit/bot-slack
+npm install @copilotkit/channels
 ```
 
 **pnpm**:
 
 ```bash
-pnpm add @copilotkit/bot @copilotkit/bot-ui @copilotkit/bot-slack
+pnpm add @copilotkit/channels
 ```
 
 **Yarn**:
 
 ```bash
-yarn add @copilotkit/bot @copilotkit/bot-ui @copilotkit/bot-slack
+yarn add @copilotkit/channels
 ```
 
 **Bun**:
 
 ```bash
-bun add @copilotkit/bot @copilotkit/bot-ui @copilotkit/bot-slack
+bun add @copilotkit/channels
 ```
 
+```typescript
+import { createChannel, Message, Section } from '@copilotkit/channels'
+import { slack } from '@copilotkit/channels/slack'
+import { mastraAgent } from './agent' // your AG-UI Mastra agent
+
+const channel = createChannel({
+  // Point the channel at your Mastra agent (an AbstractAgent, or a per-thread factory).
+  agent: mastraAgent,
+  adapters: [
+    slack({
+      botToken: process.env.SLACK_BOT_TOKEN!,
+      appToken: process.env.SLACK_APP_TOKEN!,
+    }),
+  ],
+})
+
+channel.onMention(async ({ thread }) => {
+  await thread.runAgent()
+})
+
+await channel.start()
+```
+
+The agent receives ordinary AG-UI input and emits ordinary AG-UI events; the platform mechanics stay behind the adapter, so the same Mastra agent runs unchanged across every channel. Rich messages are written as JSX and rendered to each platform's native format (Block Kit on Slack, for example), so an interactive card degrades gracefully where a platform has no equivalent.
+
+## Slack
+
+The [Slack quickstart](https://docs.copilotkit.ai/slack/mastra) takes you from zero to a bot you can `@`-mention in a channel, then adds an interactive button card. Slack runs over Socket Mode, which opens an outbound WebSocket to Slack, so no public URL or tunnel is required during development.
+
 Set the Slack credentials in your environment:
 
 - `SLACK_BOT_TOKEN`: Bot User OAuth token (`xoxb-...`)
@@ -73,4 +72,15 @@ Set the Slack credentials in your environment:
 
 ## Other platforms
 
-The bot adapters share one `@copilotkit/bot` API and differ only in what each platform natively supports. For Discord, Telegram, WhatsApp, and Microsoft Teams, set the relevant platform credentials and add the matching adapter to the `adapters` array. See the [CopilotKit bot documentation](https://docs.copilotkit.ai/slack) for platform-specific setup.
+The Channels SDK isn't limited to Slack. Other platforms like Microsoft Teams run through the same `@copilotkit/channels` API: add the matching adapter to the `adapters` array and the rest of your agent code stays the same. See the [CopilotKit Channels documentation](https://docs.copilotkit.ai/slack/mastra) for the current platform list and per-platform setup.
+
+## Message pipeline and architecture
+
+Managed channels keep a deliberate credential split, which matters when your Mastra agent uses separate model keys and tools:
+
+- **You keep** the agent logic, model credentials, tools, and the channel process.
+- **CopilotKit Intelligence holds** the platform credentials, message delivery, registration, health, and reconnects.
+
+A turn begins when a user messages the app. Intelligence receives the platform event, and the gateway delivers the turn to your running channel process. Your Mastra agent runs and renders a reply. Intelligence then returns the reply as native platform content. Platform credentials never enter the agent process, and enterprise Intelligence can be self-hosted for data residency.
+
+> **Note:** By default, interactive actions live in memory and reset on restart. Back the channel with a durable action and state store (Redis or Postgres) so buttons and per-thread state survive restarts and span multiple instances.

package/.docs/guides/concepts/multi-agent-systems.md

@@ -44,7 +44,7 @@ A supervisor pattern keeps one lead agent in control for the full task. The supe
 
 Use this pattern when the task is open-ended and the full sequence isn't known in advance. For example, a research task may require different lines of inquiry based on what earlier steps uncover. A supervisor can adapt as the task unfolds. The tradeoff is that the supervisor becomes the main coordination point. That makes the pattern flexible, but it also means the result depends heavily on good delegation behavior and clear subagent boundaries.
 
-In Mastra, this pattern maps directly to [supervisor agents](https://mastra.ai/docs/agents/supervisor-agents). A supervisor agent defines subagents on the `agents` property and uses `stream()` or `generate()` to coordinate them. Mastra also provides delegation hooks, message filtering, and memory isolation to help control this pattern.
+In Mastra, this pattern maps directly to [supervisor agents](https://mastra.ai/docs/capabilities/subagents). A supervisor agent defines subagents on the `agents` property and uses `stream()` or `generate()` to coordinate them. Mastra also provides delegation hooks, message filtering, and memory isolation to help control this pattern.
 
 > **Tip:** Follow the [supervisor agents tutorial](https://mastra.ai/guides/guide/research-coordinator) for a step-by-step guide.
 
@@ -60,12 +60,12 @@ Mastra doesn't provide a dedicated council primitive. In Mastra, implement this
 
 These patterns differ mainly in how they distribute control:
 
-| Pattern           | Who stays in control | Use when                                         | Tradeoff                                                 | Mastra implementation                                                |
-| ----------------- | -------------------- | ------------------------------------------------ | -------------------------------------------------------- | -------------------------------------------------------------------- |
-| Handoffs          | Current specialist   | Ownership should move between specialists        | Context transfer becomes more important                  | Agents with workflows and memory                                     |
-| Workflows         | Execution graph      | The path is known in advance                     | Less adaptive when the task changes                      | [Workflows](https://mastra.ai/docs/workflows/overview)               |
-| Supervisor agents | One lead agent       | Delegation must adapt during execution           | Results depend on good coordination and clear boundaries | [Supervisor agents](https://mastra.ai/docs/agents/supervisor-agents) |
-| Council           | Final synthesis step | The task needs multiple independent perspectives | Higher cost and latency                                  | Agents with workflow parallelism                                     |
+| Pattern           | Who stays in control | Use when                                         | Tradeoff                                                 | Mastra implementation                                              |
+| ----------------- | -------------------- | ------------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------ |
+| Handoffs          | Current specialist   | Ownership should move between specialists        | Context transfer becomes more important                  | Agents with workflows and memory                                   |
+| Workflows         | Execution graph      | The path is known in advance                     | Less adaptive when the task changes                      | [Workflows](https://mastra.ai/docs/workflows/overview)             |
+| Supervisor agents | One lead agent       | Delegation must adapt during execution           | Results depend on good coordination and clear boundaries | [Supervisor agents](https://mastra.ai/docs/capabilities/subagents) |
+| Council           | Final synthesis step | The task needs multiple independent perspectives | Higher cost and latency                                  | Agents with workflow parallelism                                   |
 
 In practice, these patterns are often combined:
 

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

@@ -191,7 +191,7 @@ export async function createCodingAgentSession() {
 }
 ```
 
-This example uses one mode and disables the controller's additional built-in tools so the introductory UI can focus on workspace execution. The simplified setup is intended for this tutorial. 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).
+This example uses one mode and disables the controller's additional built-in tools so the introductory UI can focus on workspace execution. The simplified setup is intended for this tutorial. 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/harness/agent-controller).
 
 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.
 
@@ -387,6 +387,6 @@ 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 overview](https://mastra.ai/docs/harness/agent-controller)
 - [`AgentController` reference](https://mastra.ai/reference/agent-controller/agent-controller-class)
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)

package/.docs/guides/guide/research-coordinator.md

@@ -414,5 +414,5 @@ You can extend this research coordinator to:
 
 Learn more:
 
-- [Supervisor Agents](https://mastra.ai/docs/agents/supervisor-agents)
+- [Supervisor Agents](https://mastra.ai/docs/capabilities/subagents)
 - [Agent.stream() Reference](https://mastra.ai/reference/streaming/agents/stream)

package/.docs/guides/migrations/network-to-supervisor.md

@@ -255,7 +255,7 @@ const stream = await supervisorAgent.stream('Research AI in education', {
 
 ## See also
 
-- [Supervisor Agents](https://mastra.ai/docs/agents/supervisor-agents)
+- [Supervisor Agents](https://mastra.ai/docs/capabilities/subagents)
 - [Agent Networks](https://mastra.ai/docs/agents/networks)
 - [Agent.stream() Reference](https://mastra.ai/reference/streaming/agents/stream)
 - [Agent.generate() Reference](https://mastra.ai/reference/agents/generate)

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

@@ -101,7 +101,6 @@ List of required environment variables for each model provider and gateway suppo
 | [NanoGPT](https://mastra.ai/models/providers/nano-gpt)                                         | `nano-gpt/*`               | `NANO_GPT_API_KEY`                                                                                    |
 | [NEAR AI Cloud](https://mastra.ai/models/providers/nearai)                                     | `nearai/*`                 | `NEARAI_API_KEY`                                                                                      |
 | [Nebius Token Factory](https://mastra.ai/models/providers/nebius)                              | `nebius/*`                 | `NEBIUS_API_KEY`                                                                                      |
-| [Neon](https://mastra.ai/models/providers/neon)                                                | `neon/*`                   | `NEON_AI_GATEWAY_BASE_URL`, `NEON_AI_GATEWAY_TOKEN`                                                   |
 | [Neuralwatt](https://mastra.ai/models/providers/neuralwatt)                                    | `neuralwatt/*`             | `NEURALWATT_API_KEY`                                                                                  |
 | [Nova](https://mastra.ai/models/providers/nova)                                                | `nova/*`                   | `NOVA_API_KEY`                                                                                        |
 | [NovitaAI](https://mastra.ai/models/providers/novita-ai)                                       | `novita-ai/*`              | `NOVITA_API_KEY`                                                                                      |
@@ -171,6 +170,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Zhipu AI Coding Plan](https://mastra.ai/models/providers/zhipuai-coding-plan)                 | `zhipuai-coding-plan/*`    | `ZHIPU_API_KEY`                                                                                       |
 | [Azure OpenAI](https://mastra.ai/models/gateways/azure-openai) (Gateway)                       | `azure-openai/*`           | `AZURE_API_KEY`, `AZURE_TENANT_ID`, `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_SUBSCRIPTION_ID` |
 | [Mastra](https://mastra.ai/models/gateways/mastra) (Gateway)                                   | `mastra/*`                 | `MASTRA_GATEWAY_API_KEY`                                                                              |
+| [Neon](https://mastra.ai/models/gateways/neon) (Gateway)                                       | `neon/*`                   | `NEON_AI_GATEWAY_BASE_URL`, `NEON_AI_GATEWAY_TOKEN`                                                   |
 | [Netlify](https://mastra.ai/models/gateways/netlify) (Gateway)                                 | `netlify/*`                | `NETLIFY_TOKEN`, `NETLIFY_SITE_ID`                                                                    |
 | [OpenRouter](https://mastra.ai/models/gateways/openrouter) (Gateway)                           | `openrouter/*`             | `OPENROUTER_API_KEY`                                                                                  |
 | [Vercel](https://mastra.ai/models/gateways/vercel) (Gateway)                                   | `vercel/*`                 | `AI_GATEWAY_API_KEY`                                                                                  |

package/.docs/models/gateways/neon.md

@@ -0,0 +1,71 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![Neon logo](https://models.dev/logos/neon.svg)Neon
+
+Neon aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 36 models through Mastra's model router.
+
+Learn more in the [Neon documentation](https://neon.com/docs).
+
+## Usage
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "neon/claude-haiku-4-5"
+});
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Neon documentation](https://neon.com/docs) for details.
+
+## Configuration
+
+```bash
+# Gateway configuration
+NEON_AI_GATEWAY_BASE_URL=https://your-base-url
+NEON_AI_GATEWAY_TOKEN=your-gateway-key
+```
+
+## Available models
+
+| Model                         |
+| ----------------------------- |
+| `claude-haiku-4-5`            |
+| `claude-opus-4-1`             |
+| `claude-opus-4-5`             |
+| `claude-opus-4-6`             |
+| `claude-opus-4-7`             |
+| `claude-opus-4-8`             |
+| `claude-sonnet-4`             |
+| `claude-sonnet-4-5`           |
+| `claude-sonnet-4-6`           |
+| `gemini-2-5-flash`            |
+| `gemini-2-5-pro`              |
+| `gemini-3-1-flash-lite`       |
+| `gemini-3-1-pro`              |
+| `gemini-3-5-flash`            |
+| `gemini-3-flash`              |
+| `gemini-3-pro`                |
+| `gemma-3-12b`                 |
+| `gpt-5`                       |
+| `gpt-5-1`                     |
+| `gpt-5-1-codex-max`           |
+| `gpt-5-1-codex-mini`          |
+| `gpt-5-2`                     |
+| `gpt-5-2-codex`               |
+| `gpt-5-3-codex`               |
+| `gpt-5-4`                     |
+| `gpt-5-4-mini`                |
+| `gpt-5-4-nano`                |
+| `gpt-5-mini`                  |
+| `gpt-5-nano`                  |
+| `gpt-oss-120b`                |
+| `gpt-oss-20b`                 |
+| `llama-4-maverick`            |
+| `meta-llama-3-1-8b-instruct`  |
+| `meta-llama-3-3-70b-instruct` |
+| `qwen3-next-80b-a3b-instruct` |
+| `qwen35-122b-a10b`            |

package/.docs/models/gateways/netlify.md

@@ -9,14 +9,14 @@ Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gate
 ## Usage
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "netlify/anthropic/claude-fable-5"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'netlify/anthropic/claude-fable-5',
+})
 ```
 
 > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/) for details.

package/.docs/models/gateways/openrouter.md

@@ -9,14 +9,14 @@ Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 ## Usage
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "openrouter/ai21/jamba-large-1.7"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'openrouter/ai21/jamba-large-1.7',
+})
 ```
 
 > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [OpenRouter documentation](https://openrouter.ai/models) for details.

package/.docs/models/gateways/vercel.md

@@ -9,14 +9,14 @@ Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-pro
 ## Usage
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "vercel/alibaba/qwen-3-14b"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'vercel/alibaba/qwen-3-14b',
+})
 ```
 
 > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers) for details.

package/.docs/models/gateways.md

@@ -12,6 +12,7 @@ Create custom gateways for private LLM deployments or specialized provider integ
 
 - [Azure OpenAI](https://mastra.ai/models/gateways/azure-openai)
 - [Mastra](https://mastra.ai/models/gateways/mastra)
+- [Neon](https://mastra.ai/models/gateways/neon)
 - [Netlify](https://mastra.ai/models/gateways/netlify)
 - [OpenRouter](https://mastra.ai/models/gateways/openrouter)
 - [Vercel](https://mastra.ai/models/gateways/vercel)