@mastra/mcp-docs-server 1.1.35-alpha.0 → 1.1.35-alpha.2

package/.docs/guides/deployment/inngest.md

@@ -141,7 +141,7 @@ export const mastra = new Mastra({
     host: '0.0.0.0',
     apiRoutes: [
       {
-        path: '/api/inngest',
+        path: '/inngest/api',
         method: 'ALL',
         createHandler: async ({ mastra }) => {
           return serve({ mastra, inngest })
@@ -153,6 +153,8 @@ export const mastra = new Mastra({
 })
 ```
 
+> **Note:** The path is `/inngest/api`, not `/api/inngest`. Mastra reserves the `/api` prefix for built-in routes (agents, workflows, memory). Custom `apiRoutes` paths that start with the server's `apiPrefix` (default `/api`) throw at startup. See [#15743](https://github.com/mastra-ai/mastra/pull/15743) for context, or skip to [Using a custom `apiPrefix`](#using-a-custom-apiprefix) if you need to keep `/api/inngest`.
+
 ## Running workflows
 
 ### Running locally
@@ -162,10 +164,10 @@ export const mastra = new Mastra({
 2. Start the Inngest Dev Server. In a new terminal, run:
 
    ```bash
-   npx inngest-cli@latest dev -u http://localhost:4111/api/inngest
+   npx inngest-cli@latest dev -u http://localhost:4111/inngest/api
    ```
 
-   > **Note:** The URL after `-u` tells the Inngest dev server where to find your Mastra `/api/inngest` endpoint
+   > **Note:** The URL after `-u` tells the Inngest dev server where to find your Mastra `/inngest/api` endpoint
 
 3. Open the Inngest Dashboard at <http://localhost:8288> and go to the **Apps** section in the sidebar to verify your Mastra workflow is registered
 
@@ -229,6 +231,8 @@ Before you begin, make sure you have:
 
 5. Sync with the [Inngest dashboard](https://app.inngest.com/env/production/apps) by selecting **Sync new app with Vercel** and following the instructions
 
+   > **Warning:** Inngest's auto-discover convention assumes `/api/inngest`. Because this guide uses `/inngest/api`, set the **URL** field on the Inngest app to your deployed origin plus `/inngest/api` (for example `https://your-app.vercel.app/inngest/api`). If you leave it on the default, the Inngest dashboard will not find your app's functions.
+
 6. Invoke the workflow by going to **Functions**, selecting `workflow.increment-workflow`, selecting **All actions** > **Invoke**, and providing the following input:
 
    ```json
@@ -294,7 +298,7 @@ export const mastra = new Mastra({
     host: '0.0.0.0',
     apiRoutes: [
       {
-        path: '/api/inngest',
+        path: '/inngest/api',
         method: 'ALL',
         createHandler: async ({ mastra }) => {
           return serve({
@@ -316,7 +320,7 @@ When you include custom functions:
 
 1. Mastra workflows are automatically converted to Inngest functions with IDs like `workflow.${workflowId}`
 2. Custom functions retain their specified IDs (e.g., `send-welcome-email`, `process-webhook`)
-3. All functions are served together on the same `/api/inngest` endpoint
+3. All functions are served together on the same `/inngest/api` endpoint
 
 This allows you to combine Mastra's workflow orchestration with your existing Inngest functions.
 
@@ -338,7 +342,7 @@ const app = express()
 app.use(express.json())
 
 const handler = createServe(expressAdapter)({ mastra, inngest })
-app.use('/api/inngest', handler)
+app.use('/inngest/api', handler)
 
 app.listen(3000)
 ```
@@ -358,7 +362,7 @@ const handler = createServe(fastifyAdapter)({ mastra, inngest })
 
 fastify.route({
   method: ['GET', 'POST', 'PUT'],
-  url: '/api/inngest',
+  url: '/inngest/api',
   handler,
 })
 
@@ -382,7 +386,7 @@ const router = new Router()
 app.use(bodyParser())
 
 const handler = createServe(koaAdapter)({ mastra, inngest })
-router.all('/api/inngest', handler)
+router.all('/inngest/api', handler)
 
 app.use(router.routes())
 app.use(router.allowedMethods())
@@ -406,6 +410,33 @@ export { handler as GET, handler as POST, handler as PUT }
 
 The `createServe` function works with any Inngest adapter. See the [Inngest serve documentation](https://www.inngest.com/docs/reference/serve) for a complete list of available adapters including AWS Lambda, Cloudflare Workers, and more.
 
+## Using a custom `apiPrefix`
+
+If you need to keep `/api/inngest` (for example to match Inngest's auto-discover convention without changing the dashboard URL), set `server.apiPrefix` to relocate Mastra's built-in routes:
+
+```ts
+import { Mastra } from '@mastra/core'
+import { serve } from '@mastra/inngest'
+import { inngest } from './inngest'
+
+export const mastra = new Mastra({
+  server: {
+    apiPrefix: '/_mastra',
+    apiRoutes: [
+      {
+        path: '/api/inngest',
+        method: 'ALL',
+        createHandler: async ({ mastra }) => serve({ mastra, inngest }),
+      },
+    ],
+  },
+})
+```
+
+Mastra's built-in routes now resolve under `/_mastra/agents`, `/_mastra/workflows`, and so on, freeing the `/api/inngest` path for your custom route.
+
+> **Warning:** The default auth configuration protects `/api/*` and treats `/api`, `/api/auth/*` as public. When you change `apiPrefix`, those defaults no longer match and built-in routes fall outside the protected pattern. Update `server.auth.protected` and `server.auth.public` to reference the new prefix, and update any client code (including [`MastraClient`](https://mastra.ai/docs/server/mastra-client) `apiPrefix`) that hits `/api/*`.
+
 ## Flow control
 
 Inngest workflows support flow control features including concurrency limits, rate limiting, throttling, debouncing, and priority queuing. These options are configured in the `createWorkflow()` call and help manage workflow execution at scale.

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.1.35-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`ac47842`](https://github.com/mastra-ai/mastra/commit/ac478427aa7a5f5fdaed633a911218689b438c60)]:
+  - @mastra/core@1.33.0-alpha.0
+
 ## 1.1.34
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.35-alpha.0",
+  "version": "1.1.35-alpha.2",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.32.1",
+    "@mastra/core": "1.33.0-alpha.0",
     "@mastra/mcp": "^1.7.0"
   },
   "devDependencies": {
@@ -48,7 +48,7 @@
     "vitest": "4.1.5",
     "@internal/lint": "0.0.92",
     "@internal/types-builder": "0.0.67",
-    "@mastra/core": "1.32.1"
+    "@mastra/core": "1.33.0-alpha.0"
   },
   "homepage": "https://mastra.ai",
   "repository": {