@mastra/mcp-docs-server 1.1.24 → 1.1.25-alpha.3

package/.docs/reference/mastra-platform/api.md

@@ -0,0 +1,108 @@
+# API reference
+
+## Members API
+
+The root URL for the endpoints below is: `/v1/org/members`
+
+| Method | Endpoint           | Description          |
+| ------ | ------------------ | -------------------- |
+| GET    | `/`                | List members         |
+| POST   | `/invitations`     | Send an invitation   |
+| GET    | `/invitations`     | List invitations     |
+| DELETE | `/invitations/:id` | Revoke an invitation |
+| PATCH  | `/:id`             | Update member role   |
+| DELETE | `/:id`             | Remove a member      |
+
+## API tokens
+
+The root URL for the endpoints below is: `/v1/auth/tokens`
+
+| Method | Endpoint | Description         |
+| ------ | -------- | ------------------- |
+| POST   | `/`      | Create an API token |
+| GET    | `/`      | List API tokens     |
+| DELETE | `/:id`   | Delete an API token |
+
+## Studio API
+
+The root URL for the endpoints below is: `/v1/studio`
+
+| Method | Endpoint                       | Description                    |
+| ------ | ------------------------------ | ------------------------------ |
+| GET    | `/projects`                    | List studio projects           |
+| POST   | `/projects`                    | Create a project               |
+| GET    | `/projects/:id`                | Get project detail and deploys |
+| DELETE | `/projects/:id`                | Delete a project               |
+| POST   | `/deploys`                     | Create a deploy                |
+| POST   | `/deploys/:id/upload-complete` | Confirm artifact upload        |
+| GET    | `/deploys/:id`                 | Get deploy status              |
+| GET    | `/deploys/:id/logs`            | Get deploy logs                |
+| GET    | `/deploys/:id/logs/stream`     | Stream deploy logs (SSE)       |
+
+## Server API
+
+The root URL for the endpoints below is: `/v1/server`
+
+| Method | Endpoint                       | Description                           |
+| ------ | ------------------------------ | ------------------------------------- |
+| GET    | `/projects`                    | List server projects                  |
+| POST   | `/projects`                    | Create a project                      |
+| GET    | `/projects/:id`                | Get project detail                    |
+| DELETE | `/projects/:id`                | Delete a project                      |
+| PUT    | `/projects/:id/env`            | Set environment variables             |
+| GET    | `/projects/:id/env`            | Get environment variables             |
+| POST   | `/projects/:id/env/restart`    | Restart after env change              |
+| GET    | `/projects/:id/domains`        | List domains                          |
+| POST   | `/projects/:id/domains`        | Add a custom domain                   |
+| GET    | `/projects/:id/runtime-logs`   | Get runtime logs                      |
+| POST   | `/projects/:id/redeploy`       | Trigger redeploy                      |
+| POST   | `/projects/:id/always-on`      | Enable always-on                      |
+| DELETE | `/projects/:id/always-on`      | Disable always-on                     |
+| POST   | `/deploys`                     | Create a deploy                       |
+| POST   | `/deploys/:id/upload-complete` | Confirm artifact upload               |
+| GET    | `/deploys/:id`                 | Get deploy status                     |
+| GET    | `/deploys/:id/logs`            | Get deploy logs                       |
+| POST   | `/deploys/:id/cancel`          | Cancel a queued or in-progress deploy |
+| DELETE | `/deploys/:id`                 | Stop a running deploy                 |
+
+## Gateway API
+
+The root URL for the endpoints below is: `/v1/gateway`
+
+| Method | Endpoint                                                      | Description                                 |
+| ------ | ------------------------------------------------------------- | ------------------------------------------- |
+| GET    | `/projects`                                                   | List gateway projects                       |
+| GET    | `/projects/:id`                                               | Get project detail                          |
+| PATCH  | `/projects/:id`                                               | Update project settings                     |
+| DELETE | `/projects/:id`                                               | Delete a project                            |
+| POST   | `/projects/provision`                                         | Provision a new gateway project             |
+| GET    | `/projects/:id/keys`                                          | List API keys                               |
+| POST   | `/projects/:id/keys`                                          | Create an API key                           |
+| DELETE | `/projects/:id/keys/:keyId`                                   | Revoke an API key                           |
+| GET    | `/projects/:id/keys/:keyId/bindings`                          | List key-level provider bindings            |
+| POST   | `/projects/:id/keys/:keyId/bindings`                          | Add a key-level provider binding (BYOK)     |
+| DELETE | `/projects/:id/keys/:keyId/bindings/:provider`                | Remove a key-level binding                  |
+| GET    | `/projects/:id/bindings`                                      | List project-level provider bindings        |
+| POST   | `/projects/:id/bindings`                                      | Add a project-level provider binding (BYOK) |
+| DELETE | `/projects/:id/bindings/:provider`                            | Remove a project-level binding              |
+| GET    | `/projects/:id/usage/has-activity`                            | Check whether project has any requests      |
+| GET    | `/projects/:id/usage/activity`                                | Get aggregated usage activity               |
+| GET    | `/projects/:id/usage/memory-activity`                         | Get memory-token totals over a time range   |
+| GET    | `/projects/:id/usage/logs`                                    | Get request logs                            |
+| GET    | `/projects/:id/usage/logs/facets`                             | Get log filter facets                       |
+| GET    | `/projects/:id/usage/logs/:requestId`                         | Get specific request detail                 |
+| GET    | `/projects/:id/memory/threads`                                | List threads (dashboard)                    |
+| POST   | `/projects/:id/memory/threads`                                | Create a thread (dashboard)                 |
+| GET    | `/projects/:id/memory/threads/:threadId`                      | Get thread (dashboard)                      |
+| PATCH  | `/projects/:id/memory/threads/:threadId`                      | Update thread (dashboard)                   |
+| DELETE | `/projects/:id/memory/threads/:threadId`                      | Delete thread (dashboard)                   |
+| POST   | `/projects/:id/memory/threads/:threadId/clone`                | Clone thread (dashboard)                    |
+| GET    | `/projects/:id/memory/threads/:threadId/messages`             | List messages (dashboard)                   |
+| POST   | `/projects/:id/memory/threads/:threadId/messages`             | Save messages (dashboard)                   |
+| DELETE | `/projects/:id/memory/threads/:threadId/messages`             | Delete messages (dashboard)                 |
+| GET    | `/projects/:id/memory/threads/:threadId/observations/history` | Observation history (dashboard)             |
+| GET    | `/models`                                                     | List available models                       |
+
+## Gateway proxy endpoints
+
+Visit the [Memory Gateway documentation](https://gateway.mastra.ai/docs) for more details.

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.1.25-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`8fad147`](https://github.com/mastra-ai/mastra/commit/8fad14759804179c8e080ce4d9dec6ef1a808b31), [`582644c`](https://github.com/mastra-ai/mastra/commit/582644c4a87f83b4f245a84d72b9e8590585012e), [`5d84914`](https://github.com/mastra-ai/mastra/commit/5d84914e0e520c642a40329b210b413fcd139898), [`fd2f314`](https://github.com/mastra-ai/mastra/commit/fd2f31473d3449b6b97e837ef8641264377f41a7), [`e80fead`](https://github.com/mastra-ai/mastra/commit/e80fead1412cc0d1b2f7d6a1ce5017d9e0098ff7), [`0287b64`](https://github.com/mastra-ai/mastra/commit/0287b644a5c3272755cf3112e71338106664103b)]:
+  - @mastra/core@1.25.0-alpha.1
+
+## 1.1.25-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`87df955`](https://github.com/mastra-ai/mastra/commit/87df955c028660c075873fd5d74af28233ce32eb), [`075e91a`](https://github.com/mastra-ai/mastra/commit/075e91a4549baf46ad7a42a6a8ac8dfa78cc09e6)]:
+  - @mastra/core@1.24.2-alpha.0
+
 ## 1.1.24
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.24",
+  "version": "1.1.25-alpha.3",
   "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.24.1",
+    "@mastra/core": "1.25.0-alpha.1",
     "@mastra/mcp": "^1.4.2"
   },
   "devDependencies": {
@@ -48,7 +48,7 @@
     "vitest": "4.0.18",
     "@internal/types-builder": "0.0.57",
     "@internal/lint": "0.0.82",
-    "@mastra/core": "1.24.1"
+    "@mastra/core": "1.25.0-alpha.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/docs/mastra-cloud/deployment.md

@@ -1,77 +0,0 @@
-# Deployment
-
-Deploy your Mastra application to production and expose your agents, tools, and workflows as REST API endpoints.
-
-> **Info:** Mastra Cloud is currently in beta, but many teams are already using it to deploy their agents. It's the easiest way to run Mastra agents in a managed environment.
-
-## Enable deployments
-
-After [setting up your project](https://mastra.ai/docs/mastra-cloud/setup), select **Deployment** in the sidebar and select **Enable Deployments**.
-
-Once enabled, your project automatically builds and deploys. Future pushes to your main branch trigger automatic redeployments.
-
-## Dashboard
-
-The **Overview** page shows your project's domain URL, status, latest deployment, and connected agents and workflows.
-
-![Project dashboard](/assets/images/mastra-cloud-project-dashboard-6890c8032419d5fb075313d08bfd598b.jpg)
-
-Click the **Deployments** menu item to view build logs. Open **Settings** to configure environment variables, branch, storage, and endpoint URLs.
-
-> **Note:** Changes to settings require a new deployment to take effect
-
-## Storage configuration
-
-Mastra Cloud offers two storage options:
-
-1. **Mastra Cloud Store**: Managed storage provided by Mastra Cloud
-2. **Bring your own database**: Connect to your own external database
-
-### Using Mastra Cloud Store
-
-When using the managed Mastra Cloud Store (enabled in your project settings), storage must be configured on the `Mastra` instance, not on individual agent `Memory` instances.
-
-Configure storage on your Mastra instance:
-
-```typescript
-import { Mastra } from '@mastra/core'
-import { LibSQLStore } from '@mastra/libsql'
-
-export const mastra = new Mastra({
-  storage: new LibSQLStore({
-    id: 'mastra-store',
-    url: 'file:./mastra.db',
-  }),
-  agents: { myAgent },
-})
-```
-
-Agents can use Memory without specifying storage as they inherit from the Mastra instance:
-
-```typescript
-import { Agent } from '@mastra/core/agent'
-import { Memory } from '@mastra/memory'
-
-export const myAgent = new Agent({
-  id: 'my-agent',
-  memory: new Memory({
-    // No storage here - uses instance-level storage from Mastra Cloud Store
-    options: {
-      lastMessages: 20,
-    },
-  }),
-})
-```
-
-### Bring your own database
-
-If you don't use Mastra Cloud Store, you can use any [storage provider](https://mastra.ai/docs/memory/storage) with any configuration. Set your database connection strings as environment variables in your project's **Settings** page.
-
-## Using your deployment
-
-After deployment, interact with your agents using the [Mastra Client](https://mastra.ai/docs/server/mastra-client) or call the REST API endpoints directly.
-
-## Next steps
-
-- [Studio](https://mastra.ai/docs/mastra-cloud/overview): Test your agents in the cloud
-- [Observability](https://mastra.ai/docs/mastra-cloud/observability): Monitor traces and logs

package/.docs/docs/mastra-cloud/observability.md

@@ -1,38 +0,0 @@
-# Observability
-
-Cloud provides observability for production applications, giving you insight into how your agents and workflows behave. Observability works whether your application is deployed to Mastra Cloud, running locally, or hosted on your own infrastructure. Any Mastra project can send traces and logs to the platform regardless of where it's running.
-
-For details on configuring observability, see the [Cloud Exporter](https://mastra.ai/docs/observability/tracing/exporters/cloud) docs.
-
-## Traces
-
-Traces are available for both agents and workflows by enabling [observability](https://mastra.ai/docs/observability/tracing/overview) using one of the [supported providers](https://mastra.ai/docs/observability/tracing/overview).
-
-### Agents
-
-With observability enabled, you can view detailed outputs from your agents in the **Traces** section in [Studio](https://mastra.ai/docs/mastra-cloud/overview).
-
-![observability agents](/assets/images/mastra-cloud-observability-agents-a51e3bcac8589ba42fc5bd958a627187.jpg)
-
-Agent traces break a run into clear steps: model calls, tool calls, and intermediate chunks. Each includes timing, inputs, outputs, and errors. Drill into any span to inspect prompts, token usage, and results.
-
-### Workflows
-
-With observability enabled, you can view detailed outputs from your workflows in the **Traces** section in [Studio](https://mastra.ai/docs/mastra-cloud/overview).
-
-![observability workflows](/assets/images/mastra-cloud-observability-workflows-47baf49146575e665e3aad9f1fd65e5f.jpg)
-
-Workflow traces capture each step in the run, including transitions, branching, timing, and any tool calls. Inspect inputs, outputs, and errors for every step to debug long-running or multi-step processes.
-
-## Logs
-
-The **Logs** page in the [project dashboard](https://mastra.ai/docs/mastra-cloud/deployment) displays detailed information for debugging and monitoring your application's behavior.
-
-![Dashboard logs](/assets/images/mastra-cloud-dashboard-logs-85576fde4dda03bba2892bb6134a6ebf.jpg)
-
-Each log entry includes its severity level and a detailed message showing agent, workflow, or storage activity.
-
-## Next steps
-
-- [Logging](https://mastra.ai/docs/observability/logging)
-- [Tracing](https://mastra.ai/docs/observability/tracing/overview)

package/.docs/docs/mastra-cloud/overview.md

@@ -1,23 +0,0 @@
-# Mastra Cloud
-
-[Mastra Cloud](https://cloud.mastra.ai) is a platform for deploying, managing, and monitoring Mastra applications. [Import your project](https://mastra.ai/docs/mastra-cloud/setup) to get started.
-
-## Studio
-
-Run [Studio](https://mastra.ai/docs/studio/overview) in the cloud and share access with your team via a link. Team members can test agents and workflows, tweak system prompts, and give feedback without running the project locally.
-
-## Deploy
-
-Enable [deployments](https://mastra.ai/docs/mastra-cloud/deployment) and Mastra Cloud hosts your server for you. Connect your GitHub repository for automatic deployments whenever you push to your configured branch. Mastra Cloud exposes your agents, tools, and workflows as REST API endpoints.
-
-Once deployed, the project dashboard gives you visibility into:
-
-- Deployment status and history
-- Build logs and configuration
-- Environment variables and settings
-
-## Observability
-
-[Observability](https://mastra.ai/docs/mastra-cloud/observability) provides insight into how your agents and workflows behave in production. View detailed traces of agent runs, workflow executions, and logs to debug issues and understand performance.
-
-> **Info:** You don’t need to deploy to Mastra Cloud to use Observability. You can send traces to Mastra from any environment

package/.docs/docs/mastra-cloud/setup.md

@@ -1,42 +0,0 @@
-# Setup
-
-Import your Mastra project to [Mastra Cloud](https://cloud.mastra.ai) to use [Studio](https://mastra.ai/docs/mastra-cloud/overview) and optionally [deploy](https://mastra.ai/docs/mastra-cloud/deployment) your agent.
-
-## Before you begin
-
-- [Sign in](https://cloud.mastra.ai) to Cloud
-- Push your [Mastra project](https://mastra.ai/docs) to GitHub
-
-## Options
-
-![Select project type](/assets/images/mastra-cloud-select-6b31837ad5bcfb2be5f8085a524b576c.png)
-
-When you create a new project, you can choose from three options:
-
-1. **Create from GitHub** - Import a Mastra project from GitHub
-2. **Create from your server** - Connect a self-hosted Mastra instance to [Studio](https://mastra.ai/docs/mastra-cloud/overview)
-3. **Create from template** - Start from a [pre-built template](https://mastra.ai/templates)
-
-To create a project from GitHub, follow these steps:
-
-## Create from GitHub
-
-1. Connect to GitHub when prompted
-
-   ![Deployment details](/assets/images/mastra-cloud-connect-3d62fb8eb348f63097d77079610a6d90.png)
-
-2. Search for your repository and click **Import**
-
-   ![Deployment details](/assets/images/mastra-cloud-import-git-repository-bed773afbf510103f535451cbee5040f.jpg)
-
-3. Configure your project settings. Mastra Cloud auto-detects most settings, but you'll still need to enter the environment variables for your configured [model provider](https://mastra.ai/models):
-
-   ![Deployment details](/assets/images/mastra-cloud-deployment-details-e2c25f0d7d3ede4add9f8a907784c829.jpg)
-
-4. Click **Create Project**
-
-## Next steps
-
-Once your project is imported, [Studio](https://mastra.ai/docs/mastra-cloud/overview) automatically creates a sandbox where you can interact with your agents and share access with your team.
-
-When you're ready for production, enable [Deployment](https://mastra.ai/docs/mastra-cloud/deployment) settings and hit deploy!