@mastra/mcp-docs-server 1.0.0-beta.8 → 1.0.0
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.
- package/.docs/organized/changelogs/%40internal%2Fchangeset-cli.md +1 -13
- package/.docs/organized/changelogs/%40internal%2Fexternal-types.md +1 -5
- package/.docs/organized/changelogs/%40internal%2Fplayground.md +40 -0
- package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +8 -8
- package/.docs/organized/changelogs/%40internal%2Ftypes-builder.md +1 -53
- package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +287 -287
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +315 -315
- package/.docs/organized/changelogs/%40mastra%2Fastra.md +53 -53
- package/.docs/organized/changelogs/%40mastra%2Fauth.md +38 -0
- package/.docs/organized/changelogs/%40mastra%2Fchroma.md +66 -66
- package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +522 -212
- package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +658 -196
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +439 -234
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +450 -211
- package/.docs/organized/changelogs/%40mastra%2Fcodemod.md +208 -0
- package/.docs/organized/changelogs/%40mastra%2Fconvex.md +448 -22
- package/.docs/organized/changelogs/%40mastra%2Fcore.md +3341 -271
- package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +60 -60
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +289 -289
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +90 -90
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +74 -74
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +70 -70
- package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +247 -220
- package/.docs/organized/changelogs/%40mastra%2Fduckdb.md +70 -0
- package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +403 -225
- package/.docs/organized/changelogs/%40mastra%2Felasticsearch.md +72 -0
- package/.docs/organized/changelogs/%40mastra%2Fevals.md +145 -145
- package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +54 -0
- package/.docs/organized/changelogs/%40mastra%2Flance.md +456 -226
- package/.docs/organized/changelogs/%40mastra%2Flibsql.md +604 -208
- package/.docs/organized/changelogs/%40mastra%2Floggers.md +71 -71
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +247 -247
- package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +28 -28
- package/.docs/organized/changelogs/%40mastra%2Fmcp.md +285 -285
- package/.docs/organized/changelogs/%40mastra%2Fmemory.md +354 -156
- package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +545 -212
- package/.docs/organized/changelogs/%40mastra%2Fmssql.md +481 -202
- package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +194 -194
- package/.docs/organized/changelogs/%40mastra%2Fpg.md +759 -213
- package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +198 -198
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +636 -229
- package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +163 -163
- package/.docs/organized/changelogs/%40mastra%2Frag.md +310 -310
- package/.docs/organized/changelogs/%40mastra%2Freact.md +328 -230
- package/.docs/organized/changelogs/%40mastra%2Fs3vectors.md +64 -0
- package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +160 -0
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +829 -218
- package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +57 -57
- package/.docs/organized/changelogs/%40mastra%2Fupstash.md +479 -232
- package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +53 -53
- package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +45 -45
- package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +45 -45
- package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +47 -47
- package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +110 -110
- package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +15 -0
- package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +98 -0
- package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +54 -54
- package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +46 -46
- package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +93 -93
- package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +47 -47
- package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +45 -45
- package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +45 -45
- package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +45 -45
- package/.docs/organized/changelogs/create-mastra.md +227 -227
- package/.docs/organized/changelogs/mastra.md +277 -277
- package/.docs/organized/code-examples/a2a.md +2 -2
- package/.docs/organized/code-examples/agent-v6.md +221 -0
- package/.docs/organized/code-examples/agui.md +4 -4
- package/.docs/organized/code-examples/ai-elements.md +3 -3
- package/.docs/organized/code-examples/ai-sdk-useChat.md +2 -2
- package/.docs/organized/code-examples/ai-sdk-v5.md +3 -3
- package/.docs/organized/code-examples/assistant-ui.md +5 -5
- package/.docs/organized/code-examples/bird-checker-with-express.md +1 -1
- package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +2 -2
- package/.docs/organized/code-examples/bird-checker-with-nextjs.md +3 -3
- package/.docs/organized/code-examples/client-side-tools.md +4 -4
- package/.docs/organized/code-examples/crypto-chatbot.md +5 -5
- package/.docs/organized/code-examples/experimental-auth-weather-agent.md +1 -1
- package/.docs/organized/code-examples/fireworks-r1.md +2 -2
- package/.docs/organized/code-examples/heads-up-game.md +7 -7
- package/.docs/organized/code-examples/inngest.md +1075 -0
- package/.docs/organized/code-examples/mcp-configuration.md +1 -1
- package/.docs/organized/code-examples/mcp-server-adapters.md +3 -4
- package/.docs/organized/code-examples/memory-per-resource-example.md +3 -3
- package/.docs/organized/code-examples/memory-todo-agent.md +1 -1
- package/.docs/organized/code-examples/memory-with-context.md +1 -1
- package/.docs/organized/code-examples/memory-with-processors.md +1 -1
- package/.docs/organized/code-examples/openapi-spec-writer.md +3 -3
- package/.docs/organized/code-examples/processors-with-ai-sdk.md +14 -0
- package/.docs/organized/code-examples/quick-start.md +1 -5
- package/.docs/organized/code-examples/server-app-access.md +3 -3
- package/.docs/organized/code-examples/server-express-adapter.md +1 -1
- package/.docs/organized/code-examples/server-fastify-adapter.md +83 -0
- package/.docs/organized/code-examples/server-hono-adapter.md +3 -3
- package/.docs/organized/code-examples/server-koa-adapter.md +94 -0
- package/.docs/organized/code-examples/stock-price-tool.md +21 -2
- package/.docs/organized/code-examples/workflow-ai-recruiter.md +1 -1
- package/.docs/organized/code-examples/workflow-with-inline-steps.md +1 -1
- package/.docs/organized/code-examples/workflow-with-memory.md +1 -1
- package/.docs/organized/code-examples/workflow-with-separate-steps.md +1 -1
- package/.docs/organized/code-examples/workflow-with-suspend-resume.md +1 -1
- package/.docs/raw/agents/adding-voice.mdx +24 -6
- package/.docs/raw/agents/agent-approval.mdx +209 -12
- package/.docs/raw/agents/agent-memory.mdx +36 -32
- package/.docs/raw/agents/guardrails.mdx +105 -56
- package/.docs/raw/agents/network-approval.mdx +281 -0
- package/.docs/raw/agents/networks.mdx +69 -13
- package/.docs/raw/agents/overview.mdx +43 -25
- package/.docs/raw/agents/processors.mdx +234 -17
- package/.docs/raw/agents/structured-output.mdx +78 -8
- package/.docs/raw/agents/using-tools.mdx +67 -6
- package/.docs/raw/course/01-first-agent/07-creating-your-agent.md +1 -2
- package/.docs/raw/course/01-first-agent/12-connecting-tool-to-agent.md +1 -1
- package/.docs/raw/course/01-first-agent/16-adding-memory-to-agent.md +1 -2
- package/.docs/raw/course/02-agent-tools-mcp/05-updating-your-agent.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/10-updating-agent-instructions-zapier.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/16-updating-agent-instructions-github.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/21-updating-agent-instructions-hackernews.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/27-updating-agent-instructions-filesystem.md +1 -1
- package/.docs/raw/course/02-agent-tools-mcp/31-enhancing-memory-configuration.md +3 -3
- package/.docs/raw/course/03-agent-memory/04-creating-basic-memory-agent.md +1 -2
- package/.docs/raw/course/03-agent-memory/07-understanding-memory-threads.md +35 -0
- package/.docs/raw/course/03-agent-memory/08-configuring-conversation-history.md +1 -2
- package/.docs/raw/course/03-agent-memory/13-vector-store-configuration.md +1 -1
- package/.docs/raw/course/03-agent-memory/16-configuring-semantic-recall.md +4 -5
- package/.docs/raw/course/03-agent-memory/18-advanced-configuration-semantic-recall.md +1 -1
- package/.docs/raw/course/03-agent-memory/21-configuring-working-memory.md +3 -4
- package/.docs/raw/course/03-agent-memory/22-custom-working-memory-templates.md +3 -4
- package/.docs/raw/course/03-agent-memory/25-combining-memory-features.md +3 -4
- package/.docs/raw/course/03-agent-memory/27-creating-learning-assistant.md +3 -4
- package/.docs/raw/course/04-workflows/11-creating-an-ai-agent.md +2 -3
- package/.docs/raw/deployment/cloud-providers.mdx +22 -0
- package/.docs/raw/deployment/mastra-server.mdx +140 -0
- package/.docs/raw/deployment/monorepo.mdx +106 -42
- package/.docs/raw/deployment/overview.mdx +35 -48
- package/.docs/raw/deployment/web-framework.mdx +17 -19
- package/.docs/raw/deployment/workflow-runners.mdx +16 -0
- package/.docs/raw/evals/built-in-scorers.mdx +2 -0
- package/.docs/raw/evals/custom-scorers.mdx +60 -12
- package/.docs/raw/evals/overview.mdx +6 -6
- package/.docs/raw/evals/running-in-ci.mdx +4 -2
- package/.docs/raw/getting-started/manual-install.mdx +20 -20
- package/.docs/raw/getting-started/mcp-docs-server.mdx +59 -2
- package/.docs/raw/getting-started/project-structure.mdx +2 -2
- package/.docs/raw/getting-started/start.mdx +17 -1
- package/.docs/raw/getting-started/studio.mdx +10 -37
- package/.docs/raw/guides/agent-frameworks/ai-sdk.mdx +151 -0
- package/.docs/raw/guides/build-your-ui/ai-sdk-ui.mdx +1034 -80
- package/.docs/raw/guides/build-your-ui/assistant-ui.mdx +8 -8
- package/.docs/raw/guides/build-your-ui/copilotkit.mdx +32 -11
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/amazon-ec2.mdx +9 -9
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/aws-lambda.mdx +13 -16
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/azure-app-services.mdx +5 -7
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/cloudflare-deployer.mdx +8 -5
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/digital-ocean.mdx +18 -23
- package/.docs/raw/guides/deployment/index.mdx +32 -0
- package/.docs/raw/guides/deployment/inngest.mdx +673 -0
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/netlify-deployer.mdx +7 -3
- package/.docs/raw/{deployment/cloud-providers → guides/deployment}/vercel-deployer.mdx +8 -5
- package/.docs/raw/guides/getting-started/astro.mdx +292 -451
- package/.docs/raw/guides/getting-started/express.mdx +72 -153
- package/.docs/raw/guides/getting-started/hono.mdx +227 -0
- package/.docs/raw/guides/getting-started/next-js.mdx +173 -61
- package/.docs/raw/guides/getting-started/nuxt.mdx +505 -0
- package/.docs/raw/guides/getting-started/quickstart.mdx +5 -5
- package/.docs/raw/guides/getting-started/sveltekit.mdx +238 -409
- package/.docs/raw/guides/getting-started/vite-react.mdx +317 -147
- package/.docs/raw/guides/guide/ai-recruiter.mdx +10 -10
- package/.docs/raw/guides/guide/chef-michel.mdx +9 -11
- package/.docs/raw/guides/guide/notes-mcp-server.mdx +15 -15
- package/.docs/raw/guides/guide/research-assistant.mdx +20 -20
- package/.docs/raw/guides/guide/stock-agent.mdx +5 -5
- package/.docs/raw/guides/guide/web-search.mdx +38 -38
- package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx +7 -7
- package/.docs/raw/guides/index.mdx +0 -1
- package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +2 -2
- package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +105 -4
- package/.docs/raw/guides/migrations/upgrade-to-v1/cli.mdx +15 -1
- package/.docs/raw/guides/migrations/upgrade-to-v1/client.mdx +170 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/deployment.mdx +42 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/mastra.mdx +0 -35
- package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +40 -3
- package/.docs/raw/guides/migrations/upgrade-to-v1/overview.mdx +17 -2
- package/.docs/raw/guides/migrations/upgrade-to-v1/processors.mdx +11 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/rag.mdx +47 -0
- package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +271 -25
- package/.docs/raw/guides/migrations/upgrade-to-v1/tools.mdx +3 -3
- package/.docs/raw/guides/migrations/upgrade-to-v1/tracing.mdx +72 -17
- package/.docs/raw/guides/migrations/upgrade-to-v1/vectors.mdx +46 -1
- package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +50 -7
- package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +21 -23
- package/.docs/raw/index.mdx +2 -2
- package/.docs/raw/mastra-cloud/deployment.mdx +86 -0
- package/.docs/raw/mastra-cloud/observability.mdx +43 -0
- package/.docs/raw/mastra-cloud/overview.mdx +31 -0
- package/.docs/raw/mastra-cloud/setup.mdx +64 -0
- package/.docs/raw/mastra-cloud/studio.mdx +35 -0
- package/.docs/raw/mcp/overview.mdx +60 -25
- package/.docs/raw/mcp/publishing-mcp-server.mdx +7 -4
- package/.docs/raw/memory/memory-processors.mdx +17 -12
- package/.docs/raw/memory/message-history.mdx +72 -0
- package/.docs/raw/memory/overview.mdx +38 -76
- package/.docs/raw/memory/semantic-recall.mdx +65 -52
- package/.docs/raw/memory/storage.mdx +248 -0
- package/.docs/raw/memory/working-memory.mdx +24 -13
- package/.docs/raw/observability/logging.mdx +16 -15
- package/.docs/raw/observability/overview.mdx +27 -7
- package/.docs/raw/observability/tracing/bridges/otel.mdx +7 -4
- package/.docs/raw/observability/tracing/exporters/arize.mdx +61 -24
- package/.docs/raw/observability/tracing/exporters/braintrust.mdx +32 -22
- package/.docs/raw/observability/tracing/exporters/cloud.mdx +24 -5
- package/.docs/raw/observability/tracing/exporters/datadog.mdx +175 -0
- package/.docs/raw/observability/tracing/exporters/default.mdx +28 -7
- package/.docs/raw/observability/tracing/exporters/laminar.mdx +89 -0
- package/.docs/raw/observability/tracing/exporters/langfuse.mdx +31 -22
- package/.docs/raw/observability/tracing/exporters/langsmith.mdx +33 -3
- package/.docs/raw/observability/tracing/exporters/otel.mdx +194 -22
- package/.docs/raw/observability/tracing/exporters/posthog.mdx +32 -22
- package/.docs/raw/observability/tracing/exporters/sentry.mdx +198 -0
- package/.docs/raw/observability/tracing/overview.mdx +388 -108
- package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +27 -7
- package/.docs/raw/rag/chunking-and-embedding.mdx +22 -33
- package/.docs/raw/rag/graph-rag.mdx +223 -0
- package/.docs/raw/rag/overview.mdx +6 -3
- package/.docs/raw/rag/retrieval.mdx +53 -57
- package/.docs/raw/rag/vector-databases.mdx +55 -31
- package/.docs/raw/reference/agents/agent.mdx +17 -14
- package/.docs/raw/reference/agents/generate.mdx +172 -44
- package/.docs/raw/reference/agents/generateLegacy.mdx +5 -3
- package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +5 -3
- package/.docs/raw/reference/agents/getDefaultOptions.mdx +5 -3
- package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +5 -3
- package/.docs/raw/reference/agents/getDescription.mdx +3 -1
- package/.docs/raw/reference/agents/getInstructions.mdx +5 -3
- package/.docs/raw/reference/agents/getLLM.mdx +5 -3
- package/.docs/raw/reference/agents/getMemory.mdx +5 -3
- package/.docs/raw/reference/agents/getModel.mdx +5 -3
- package/.docs/raw/reference/agents/getTools.mdx +4 -2
- package/.docs/raw/reference/agents/getVoice.mdx +4 -2
- package/.docs/raw/reference/agents/listAgents.mdx +4 -2
- package/.docs/raw/reference/agents/listScorers.mdx +5 -3
- package/.docs/raw/reference/agents/listTools.mdx +4 -2
- package/.docs/raw/reference/agents/listWorkflows.mdx +4 -2
- package/.docs/raw/reference/agents/network.mdx +113 -1
- package/.docs/raw/reference/ai-sdk/chat-route.mdx +6 -3
- package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx +4 -2
- package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx +4 -2
- package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx +5 -3
- package/.docs/raw/reference/ai-sdk/network-route.mdx +6 -3
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx +10 -6
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx +130 -0
- package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx +110 -0
- package/.docs/raw/reference/ai-sdk/with-mastra.mdx +122 -0
- package/.docs/raw/reference/ai-sdk/workflow-route.mdx +7 -4
- package/.docs/raw/reference/auth/auth0.mdx +5 -3
- package/.docs/raw/reference/auth/clerk.mdx +5 -3
- package/.docs/raw/reference/auth/firebase.mdx +6 -5
- package/.docs/raw/reference/auth/jwt.mdx +5 -3
- package/.docs/raw/reference/auth/supabase.mdx +5 -3
- package/.docs/raw/reference/auth/workos.mdx +5 -3
- package/.docs/raw/reference/cli/create-mastra.mdx +12 -10
- package/.docs/raw/reference/cli/mastra.mdx +63 -15
- package/.docs/raw/reference/client-js/agents.mdx +311 -85
- package/.docs/raw/reference/client-js/error-handling.mdx +3 -3
- package/.docs/raw/reference/client-js/logs.mdx +2 -0
- package/.docs/raw/reference/client-js/mastra-client.mdx +6 -4
- package/.docs/raw/reference/client-js/memory.mdx +47 -2
- package/.docs/raw/reference/client-js/observability.mdx +2 -0
- package/.docs/raw/reference/client-js/telemetry.mdx +2 -0
- package/.docs/raw/reference/client-js/tools.mdx +2 -0
- package/.docs/raw/reference/client-js/vectors.mdx +2 -0
- package/.docs/raw/reference/client-js/workflows.mdx +47 -3
- package/.docs/raw/reference/configuration.mdx +761 -0
- package/.docs/raw/reference/core/addGateway.mdx +2 -0
- package/.docs/raw/reference/core/getAgent.mdx +3 -1
- package/.docs/raw/reference/core/getAgentById.mdx +3 -1
- package/.docs/raw/reference/core/getDeployer.mdx +3 -1
- package/.docs/raw/reference/core/getGateway.mdx +2 -0
- package/.docs/raw/reference/core/getGatewayById.mdx +2 -0
- package/.docs/raw/reference/core/getLogger.mdx +3 -1
- package/.docs/raw/reference/core/getMCPServer.mdx +3 -1
- package/.docs/raw/reference/core/getMCPServerById.mdx +3 -1
- package/.docs/raw/reference/core/getMemory.mdx +77 -0
- package/.docs/raw/reference/core/getScorer.mdx +2 -0
- package/.docs/raw/reference/core/getScorerById.mdx +2 -0
- package/.docs/raw/reference/core/getServer.mdx +6 -4
- package/.docs/raw/reference/core/getStorage.mdx +5 -3
- package/.docs/raw/reference/core/getStoredAgentById.mdx +185 -0
- package/.docs/raw/reference/core/getTelemetry.mdx +3 -1
- package/.docs/raw/reference/core/getVector.mdx +3 -1
- package/.docs/raw/reference/core/getWorkflow.mdx +3 -1
- package/.docs/raw/reference/core/listAgents.mdx +3 -1
- package/.docs/raw/reference/core/listGateways.mdx +2 -0
- package/.docs/raw/reference/core/listLogs.mdx +3 -1
- package/.docs/raw/reference/core/listLogsByRunId.mdx +3 -1
- package/.docs/raw/reference/core/listMCPServers.mdx +3 -1
- package/.docs/raw/reference/core/listMemory.mdx +74 -0
- package/.docs/raw/reference/core/listScorers.mdx +2 -0
- package/.docs/raw/reference/core/listStoredAgents.mdx +153 -0
- package/.docs/raw/reference/core/listVectors.mdx +3 -1
- package/.docs/raw/reference/core/listWorkflows.mdx +3 -1
- package/.docs/raw/reference/core/mastra-class.mdx +35 -20
- package/.docs/raw/reference/core/mastra-model-gateway.mdx +2 -0
- package/.docs/raw/reference/core/setLogger.mdx +3 -1
- package/.docs/raw/reference/core/setStorage.mdx +6 -4
- package/.docs/raw/reference/deployer/cloudflare.mdx +22 -53
- package/.docs/raw/reference/deployer/deployer.mdx +2 -1
- package/.docs/raw/reference/deployer/netlify.mdx +4 -1
- package/.docs/raw/reference/deployer/vercel.mdx +5 -4
- package/.docs/raw/reference/evals/answer-relevancy.mdx +4 -1
- package/.docs/raw/reference/evals/answer-similarity.mdx +4 -1
- package/.docs/raw/reference/evals/bias.mdx +4 -1
- package/.docs/raw/reference/evals/completeness.mdx +4 -1
- package/.docs/raw/reference/evals/content-similarity.mdx +4 -1
- package/.docs/raw/reference/evals/context-precision.mdx +4 -1
- package/.docs/raw/reference/evals/context-relevance.mdx +2 -0
- package/.docs/raw/reference/evals/create-scorer.mdx +11 -3
- package/.docs/raw/reference/evals/faithfulness.mdx +4 -1
- package/.docs/raw/reference/evals/hallucination.mdx +4 -1
- package/.docs/raw/reference/evals/keyword-coverage.mdx +4 -1
- package/.docs/raw/reference/evals/mastra-scorer.mdx +2 -0
- package/.docs/raw/reference/evals/noise-sensitivity.mdx +2 -0
- package/.docs/raw/reference/evals/prompt-alignment.mdx +9 -7
- package/.docs/raw/reference/evals/run-evals.mdx +3 -1
- package/.docs/raw/reference/evals/scorer-utils.mdx +3 -0
- package/.docs/raw/reference/evals/textual-difference.mdx +4 -1
- package/.docs/raw/reference/evals/tone-consistency.mdx +4 -1
- package/.docs/raw/reference/evals/tool-call-accuracy.mdx +25 -23
- package/.docs/raw/reference/evals/toxicity.mdx +4 -1
- package/.docs/raw/reference/index.mdx +2 -1
- package/.docs/raw/reference/logging/pino-logger.mdx +10 -8
- package/.docs/raw/reference/memory/clone-utilities.mdx +345 -0
- package/.docs/raw/reference/memory/cloneThread.mdx +237 -0
- package/.docs/raw/reference/memory/createThread.mdx +6 -4
- package/.docs/raw/reference/memory/deleteMessages.mdx +4 -2
- package/.docs/raw/reference/memory/getThreadById.mdx +3 -1
- package/.docs/raw/reference/memory/listThreads.mdx +187 -0
- package/.docs/raw/reference/memory/memory-class.mdx +27 -20
- package/.docs/raw/reference/memory/recall.mdx +6 -4
- package/.docs/raw/reference/observability/tracing/bridges/otel.mdx +6 -2
- package/.docs/raw/reference/observability/tracing/configuration.mdx +51 -0
- package/.docs/raw/reference/observability/tracing/exporters/arize.mdx +25 -6
- package/.docs/raw/reference/observability/tracing/exporters/braintrust.mdx +23 -2
- package/.docs/raw/reference/observability/tracing/exporters/cloud-exporter.mdx +10 -0
- package/.docs/raw/reference/observability/tracing/exporters/console-exporter.mdx +3 -0
- package/.docs/raw/reference/observability/tracing/exporters/datadog.mdx +172 -0
- package/.docs/raw/reference/observability/tracing/exporters/default-exporter.mdx +10 -0
- package/.docs/raw/reference/observability/tracing/exporters/laminar.mdx +139 -0
- package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +26 -4
- package/.docs/raw/reference/observability/tracing/exporters/langsmith.mdx +10 -0
- package/.docs/raw/reference/observability/tracing/exporters/otel.mdx +51 -34
- package/.docs/raw/reference/observability/tracing/exporters/posthog.mdx +25 -4
- package/.docs/raw/reference/observability/tracing/exporters/sentry.mdx +224 -0
- package/.docs/raw/reference/observability/tracing/instances.mdx +2 -0
- package/.docs/raw/reference/observability/tracing/interfaces.mdx +20 -0
- package/.docs/raw/reference/observability/tracing/processors/sensitive-data-filter.mdx +2 -0
- package/.docs/raw/reference/observability/tracing/spans.mdx +2 -0
- package/.docs/raw/reference/processors/batch-parts-processor.mdx +4 -2
- package/.docs/raw/reference/processors/language-detector.mdx +6 -3
- package/.docs/raw/reference/processors/message-history-processor.mdx +5 -2
- package/.docs/raw/reference/processors/moderation-processor.mdx +6 -4
- package/.docs/raw/reference/processors/pii-detector.mdx +6 -4
- package/.docs/raw/reference/processors/processor-interface.mdx +326 -23
- package/.docs/raw/reference/processors/prompt-injection-detector.mdx +5 -3
- package/.docs/raw/reference/processors/semantic-recall-processor.mdx +7 -2
- package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +5 -3
- package/.docs/raw/reference/processors/token-limiter-processor.mdx +62 -19
- package/.docs/raw/reference/processors/tool-call-filter.mdx +5 -3
- package/.docs/raw/reference/processors/unicode-normalizer.mdx +6 -3
- package/.docs/raw/reference/processors/working-memory-processor.mdx +6 -3
- package/.docs/raw/reference/rag/chunk.mdx +7 -6
- package/.docs/raw/reference/rag/database-config.mdx +8 -6
- package/.docs/raw/reference/rag/document.mdx +2 -0
- package/.docs/raw/reference/rag/embeddings.mdx +2 -0
- package/.docs/raw/reference/rag/extract-params.mdx +57 -3
- package/.docs/raw/reference/rag/graph-rag.mdx +2 -0
- package/.docs/raw/reference/rag/metadata-filters.mdx +27 -7
- package/.docs/raw/reference/rag/rerank.mdx +2 -0
- package/.docs/raw/reference/rag/rerankWithScorer.mdx +2 -0
- package/.docs/raw/reference/server/create-route.mdx +34 -18
- package/.docs/raw/reference/server/express-adapter.mdx +78 -50
- package/.docs/raw/reference/server/fastify-adapter.mdx +130 -0
- package/.docs/raw/reference/server/hono-adapter.mdx +78 -48
- package/.docs/raw/reference/server/koa-adapter.mdx +129 -0
- package/.docs/raw/reference/server/mastra-server.mdx +52 -34
- package/.docs/raw/reference/server/routes.mdx +73 -10
- package/.docs/raw/reference/storage/cloudflare-d1.mdx +10 -5
- package/.docs/raw/reference/storage/cloudflare.mdx +12 -2
- package/.docs/raw/reference/storage/composite.mdx +245 -0
- package/.docs/raw/reference/storage/convex.mdx +8 -6
- package/.docs/raw/reference/storage/dynamodb.mdx +134 -8
- package/.docs/raw/reference/storage/lance.mdx +9 -5
- package/.docs/raw/reference/storage/libsql.mdx +76 -54
- package/.docs/raw/reference/storage/mongodb.mdx +115 -16
- package/.docs/raw/reference/storage/mssql.mdx +11 -6
- package/.docs/raw/{server-db/storage.mdx → reference/storage/overview.mdx} +15 -111
- package/.docs/raw/reference/storage/postgresql.mdx +228 -83
- package/.docs/raw/reference/storage/upstash.mdx +78 -2
- package/.docs/raw/reference/streaming/ChunkType.mdx +31 -3
- package/.docs/raw/reference/streaming/agents/MastraModelOutput.mdx +67 -6
- package/.docs/raw/reference/streaming/agents/stream.mdx +48 -51
- package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +5 -3
- package/.docs/raw/reference/streaming/workflows/observeStream.mdx +3 -1
- package/.docs/raw/reference/streaming/workflows/resumeStream.mdx +3 -1
- package/.docs/raw/reference/streaming/workflows/stream.mdx +37 -22
- package/.docs/raw/reference/streaming/workflows/timeTravelStream.mdx +6 -4
- package/.docs/raw/reference/templates/overview.mdx +3 -2
- package/.docs/raw/reference/tools/client.mdx +3 -0
- package/.docs/raw/reference/tools/create-tool.mdx +127 -5
- package/.docs/raw/reference/tools/document-chunker-tool.mdx +2 -0
- package/.docs/raw/reference/tools/graph-rag-tool.mdx +40 -3
- package/.docs/raw/reference/tools/mcp-client.mdx +110 -1
- package/.docs/raw/reference/tools/mcp-server.mdx +278 -24
- package/.docs/raw/reference/tools/vector-query-tool.mdx +68 -4
- package/.docs/raw/reference/vectors/astra.mdx +5 -3
- package/.docs/raw/reference/vectors/chroma.mdx +5 -3
- package/.docs/raw/reference/vectors/convex.mdx +14 -12
- package/.docs/raw/reference/vectors/couchbase.mdx +7 -5
- package/.docs/raw/reference/vectors/duckdb.mdx +12 -10
- package/.docs/raw/reference/vectors/elasticsearch.mdx +12 -4
- package/.docs/raw/reference/vectors/lance.mdx +6 -4
- package/.docs/raw/reference/vectors/libsql.mdx +66 -13
- package/.docs/raw/reference/vectors/mongodb.mdx +90 -10
- package/.docs/raw/reference/vectors/opensearch.mdx +30 -3
- package/.docs/raw/reference/vectors/pg.mdx +58 -6
- package/.docs/raw/reference/vectors/pinecone.mdx +23 -8
- package/.docs/raw/reference/vectors/qdrant.mdx +148 -4
- package/.docs/raw/reference/vectors/s3vectors.mdx +8 -6
- package/.docs/raw/reference/vectors/turbopuffer.mdx +6 -4
- package/.docs/raw/reference/vectors/upstash.mdx +60 -6
- package/.docs/raw/reference/vectors/vectorize.mdx +5 -3
- package/.docs/raw/reference/voice/azure.mdx +2 -0
- package/.docs/raw/reference/voice/cloudflare.mdx +2 -0
- package/.docs/raw/reference/voice/composite-voice.mdx +4 -0
- package/.docs/raw/reference/voice/deepgram.mdx +2 -0
- package/.docs/raw/reference/voice/elevenlabs.mdx +2 -0
- package/.docs/raw/reference/voice/google-gemini-live.mdx +3 -0
- package/.docs/raw/reference/voice/google.mdx +2 -0
- package/.docs/raw/reference/voice/mastra-voice.mdx +2 -0
- package/.docs/raw/reference/voice/murf.mdx +2 -0
- package/.docs/raw/reference/voice/openai-realtime.mdx +3 -0
- package/.docs/raw/reference/voice/openai.mdx +2 -0
- package/.docs/raw/reference/voice/playai.mdx +2 -0
- package/.docs/raw/reference/voice/sarvam.mdx +2 -0
- package/.docs/raw/reference/voice/speechify.mdx +2 -0
- package/.docs/raw/reference/voice/voice.addInstructions.mdx +3 -0
- package/.docs/raw/reference/voice/voice.addTools.mdx +3 -0
- package/.docs/raw/reference/voice/voice.answer.mdx +4 -0
- package/.docs/raw/reference/voice/voice.close.mdx +3 -0
- package/.docs/raw/reference/voice/voice.connect.mdx +5 -1
- package/.docs/raw/reference/voice/voice.events.mdx +2 -0
- package/.docs/raw/reference/voice/voice.getSpeakers.mdx +3 -0
- package/.docs/raw/reference/voice/voice.listen.mdx +6 -0
- package/.docs/raw/reference/voice/voice.off.mdx +2 -0
- package/.docs/raw/reference/voice/voice.on.mdx +5 -1
- package/.docs/raw/reference/voice/voice.send.mdx +4 -0
- package/.docs/raw/reference/voice/voice.speak.mdx +6 -0
- package/.docs/raw/reference/voice/voice.updateConfig.mdx +2 -0
- package/.docs/raw/reference/workflows/run-methods/cancel.mdx +55 -5
- package/.docs/raw/reference/workflows/run-methods/restart.mdx +3 -3
- package/.docs/raw/reference/workflows/run-methods/resume.mdx +6 -4
- package/.docs/raw/reference/workflows/run-methods/start.mdx +7 -5
- package/.docs/raw/reference/workflows/run-methods/startAsync.mdx +145 -0
- package/.docs/raw/reference/workflows/run-methods/timeTravel.mdx +10 -8
- package/.docs/raw/reference/workflows/run.mdx +11 -3
- package/.docs/raw/reference/workflows/step.mdx +56 -3
- package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +3 -1
- package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +3 -1
- package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +39 -2
- package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +3 -1
- package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +3 -1
- package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +71 -4
- package/.docs/raw/reference/workflows/workflow-methods/map.mdx +9 -7
- package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +3 -1
- package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +4 -6
- package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +4 -6
- package/.docs/raw/reference/workflows/workflow-methods/then.mdx +3 -1
- package/.docs/raw/reference/workflows/workflow.mdx +193 -2
- package/.docs/raw/{auth → server/auth}/auth0.mdx +40 -21
- package/.docs/raw/{auth → server/auth}/clerk.mdx +37 -16
- package/.docs/raw/{auth → server/auth}/firebase.mdx +47 -25
- package/.docs/raw/{auth → server/auth}/index.mdx +8 -6
- package/.docs/raw/{auth → server/auth}/jwt.mdx +22 -10
- package/.docs/raw/{auth → server/auth}/supabase.mdx +45 -25
- package/.docs/raw/{auth → server/auth}/workos.mdx +39 -20
- package/.docs/raw/{server-db → server}/custom-adapters.mdx +40 -24
- package/.docs/raw/{server-db → server}/custom-api-routes.mdx +6 -6
- package/.docs/raw/{server-db → server}/mastra-client.mdx +35 -38
- package/.docs/raw/server/mastra-server.mdx +86 -0
- package/.docs/raw/{server-db → server}/middleware.mdx +11 -9
- package/.docs/raw/{server-db → server}/request-context.mdx +85 -43
- package/.docs/raw/server/server-adapters.mdx +410 -0
- package/.docs/raw/streaming/events.mdx +16 -7
- package/.docs/raw/streaming/overview.mdx +30 -17
- package/.docs/raw/streaming/tool-streaming.mdx +15 -17
- package/.docs/raw/streaming/workflow-streaming.mdx +8 -8
- package/.docs/raw/tools-mcp/advanced-usage.mdx +4 -2
- package/.docs/raw/tools-mcp/mcp-overview.mdx +46 -12
- package/.docs/raw/tools-mcp/overview.mdx +14 -13
- package/.docs/raw/voice/overview.mdx +17 -2
- package/.docs/raw/voice/speech-to-speech.mdx +5 -0
- package/.docs/raw/voice/speech-to-text.mdx +4 -0
- package/.docs/raw/voice/text-to-speech.mdx +3 -0
- package/.docs/raw/workflows/agents-and-tools.mdx +70 -21
- package/.docs/raw/workflows/control-flow.mdx +369 -34
- package/.docs/raw/workflows/error-handling.mdx +192 -18
- package/.docs/raw/workflows/human-in-the-loop.mdx +8 -7
- package/.docs/raw/workflows/input-data-mapping.mdx +9 -7
- package/.docs/raw/workflows/overview.mdx +80 -34
- package/.docs/raw/workflows/snapshots.mdx +19 -45
- package/.docs/raw/workflows/suspend-and-resume.mdx +14 -14
- package/.docs/raw/workflows/time-travel.mdx +25 -21
- package/.docs/raw/workflows/workflow-state.mdx +7 -8
- package/CHANGELOG.md +254 -0
- package/README.md +36 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/logger.d.ts +3 -0
- package/dist/logger.d.ts.map +1 -1
- package/dist/stdio.js +746 -49
- package/dist/tools/course.d.ts.map +1 -1
- package/dist/tools/embedded-docs.d.ts +276 -0
- package/dist/tools/embedded-docs.d.ts.map +1 -0
- package/package.json +9 -8
- package/.docs/organized/changelogs/%40internal%2Fai-sdk-v4.md +0 -1
- package/.docs/raw/deployment/building-mastra.mdx +0 -73
- package/.docs/raw/deployment/cloud-providers/index.mdx +0 -55
- package/.docs/raw/deployment/mastra-cloud/dashboard.mdx +0 -100
- package/.docs/raw/deployment/mastra-cloud/observability.mdx +0 -53
- package/.docs/raw/deployment/mastra-cloud/overview.mdx +0 -65
- package/.docs/raw/deployment/mastra-cloud/setting-up.mdx +0 -105
- package/.docs/raw/memory/conversation-history.mdx +0 -24
- package/.docs/raw/memory/storage/memory-with-libsql.mdx +0 -140
- package/.docs/raw/memory/storage/memory-with-mongodb.mdx +0 -150
- package/.docs/raw/memory/storage/memory-with-pg.mdx +0 -138
- package/.docs/raw/memory/storage/memory-with-upstash.mdx +0 -146
- package/.docs/raw/memory/threads-and-resources.mdx +0 -95
- package/.docs/raw/reference/core/setTelemetry.mdx +0 -36
- package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +0 -110
- package/.docs/raw/reference/memory/query.mdx +0 -189
- package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +0 -70
- package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +0 -66
- package/.docs/raw/server-db/mastra-server.mdx +0 -97
- package/.docs/raw/server-db/server-adapters.mdx +0 -286
- package/.docs/raw/workflows/inngest-workflow.mdx +0 -363
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: "MCP Overview | MCP"
|
|
3
3
|
description: Learn about the Model Context Protocol (MCP), how to use third-party tools via MCPClient, connect to registries, and share your own tools using MCPServer.
|
|
4
|
+
packages:
|
|
5
|
+
- "@mastra/core"
|
|
6
|
+
- "@mastra/mcp"
|
|
4
7
|
---
|
|
5
8
|
|
|
6
9
|
import Tabs from "@theme/Tabs";
|
|
@@ -29,7 +32,7 @@ npm install @mastra/mcp@beta
|
|
|
29
32
|
|
|
30
33
|
The `MCPClient` connects Mastra primitives to external MCP servers, which can be local packages (invoked using `npx`) or remote HTTP(S) endpoints. Each server must be configured with either a `command` or a `url`, depending on how it's hosted.
|
|
31
34
|
|
|
32
|
-
```typescript title="src/mastra/mcp/test-mcp-client.ts"
|
|
35
|
+
```typescript title="src/mastra/mcp/test-mcp-client.ts"
|
|
33
36
|
import { MCPClient } from "@mastra/mcp";
|
|
34
37
|
|
|
35
38
|
export const testMcpClient = new MCPClient({
|
|
@@ -48,18 +51,29 @@ export const testMcpClient = new MCPClient({
|
|
|
48
51
|
});
|
|
49
52
|
```
|
|
50
53
|
|
|
51
|
-
|
|
54
|
+
:::info
|
|
55
|
+
|
|
56
|
+
Visit [MCPClient](/reference/v1/tools/mcp-client) for a full list of configuration options.
|
|
57
|
+
|
|
58
|
+
:::
|
|
59
|
+
|
|
60
|
+
:::tip Authentication
|
|
61
|
+
|
|
62
|
+
For connecting to OAuth-protected MCP servers, see the [OAuth Authentication](/reference/v1/tools/mcp-client#oauth-authentication) section.
|
|
63
|
+
|
|
64
|
+
:::
|
|
52
65
|
|
|
53
66
|
## Using `MCPClient` with an agent
|
|
54
67
|
|
|
55
|
-
To use tools from an MCP server in an agent, import your `MCPClient` and call `.
|
|
68
|
+
To use tools from an MCP server in an agent, import your `MCPClient` and call `.listTools()` in the `tools` parameter. This loads from the defined MCP servers, making them available to the agent.
|
|
56
69
|
|
|
57
|
-
```typescript {3,15} title="src/mastra/agents/test-agent.ts"
|
|
70
|
+
```typescript {3,15} title="src/mastra/agents/test-agent.ts"
|
|
58
71
|
import { Agent } from "@mastra/core/agent";
|
|
59
72
|
|
|
60
73
|
import { testMcpClient } from "../mcp/test-mcp-client";
|
|
61
74
|
|
|
62
75
|
export const testAgent = new Agent({
|
|
76
|
+
id: "test-agent",
|
|
63
77
|
name: "Test Agent",
|
|
64
78
|
description: "You are a helpful AI assistant",
|
|
65
79
|
instructions: `
|
|
@@ -69,17 +83,21 @@ export const testAgent = new Agent({
|
|
|
69
83
|
|
|
70
84
|
Answer questions using the information you find using the MCP Servers.`,
|
|
71
85
|
model: "openai/gpt-5.1",
|
|
72
|
-
tools: await testMcpClient.
|
|
86
|
+
tools: await testMcpClient.listTools(),
|
|
73
87
|
});
|
|
74
88
|
```
|
|
75
89
|
|
|
76
|
-
|
|
90
|
+
:::info
|
|
91
|
+
|
|
92
|
+
Visit [Agent Class](/reference/v1/agents/agent) for a full list of configuration options.
|
|
93
|
+
|
|
94
|
+
:::
|
|
77
95
|
|
|
78
96
|
## Configuring `MCPServer`
|
|
79
97
|
|
|
80
98
|
To expose agents, tools, and workflows from your Mastra application to external systems over HTTP(S) use the `MCPServer` class. This makes them accessible to any system or agent that supports the protocol.
|
|
81
99
|
|
|
82
|
-
```typescript title="src/mastra/mcp/test-mcp-server.ts"
|
|
100
|
+
```typescript title="src/mastra/mcp/test-mcp-server.ts"
|
|
83
101
|
import { MCPServer } from "@mastra/mcp";
|
|
84
102
|
|
|
85
103
|
import { testAgent } from "../agents/test-agent";
|
|
@@ -96,19 +114,28 @@ export const testMcpServer = new MCPServer({
|
|
|
96
114
|
});
|
|
97
115
|
```
|
|
98
116
|
|
|
99
|
-
|
|
117
|
+
:::info
|
|
118
|
+
|
|
119
|
+
Visit [MCPServer](/reference/v1/tools/mcp-server) for a full list of configuration options.
|
|
120
|
+
|
|
121
|
+
:::
|
|
122
|
+
|
|
123
|
+
:::tip Authentication
|
|
124
|
+
|
|
125
|
+
To protect your MCP server with OAuth, see the [OAuth Protection](/reference/v1/tools/mcp-server#oauth-protection) section.
|
|
126
|
+
|
|
127
|
+
:::
|
|
100
128
|
|
|
101
129
|
## Registering an `MCPServer`
|
|
102
130
|
|
|
103
131
|
To make an MCP server available to other systems or agents that support the protocol, register it in the main `Mastra` instance using `mcpServers`.
|
|
104
132
|
|
|
105
|
-
```typescript title="src/mastra/index.ts"
|
|
133
|
+
```typescript title="src/mastra/index.ts"
|
|
106
134
|
import { Mastra } from "@mastra/core/mastra";
|
|
107
135
|
|
|
108
136
|
import { testMcpServer } from "./mcp/test-mcp-server";
|
|
109
137
|
|
|
110
138
|
export const mastra = new Mastra({
|
|
111
|
-
// ...
|
|
112
139
|
mcpServers: { testMcpServer },
|
|
113
140
|
});
|
|
114
141
|
```
|
|
@@ -117,35 +144,39 @@ export const mastra = new Mastra({
|
|
|
117
144
|
|
|
118
145
|
`MCPClient` offers two approaches to retrieving tools from connected servers, suitable for different application architectures:
|
|
119
146
|
|
|
120
|
-
| Feature | Static Configuration (`await mcp.
|
|
121
|
-
| :---------------- |
|
|
122
|
-
| **Use Case** | Single-user, static config (e.g., CLI tool)
|
|
123
|
-
| **Configuration** | Fixed at agent initialization
|
|
124
|
-
| **Credentials** | Shared across all uses
|
|
125
|
-
| **Agent Setup** | Tools added in `Agent` constructor
|
|
147
|
+
| Feature | Static Configuration (`await mcp.listTools()`) | Dynamic Configuration (`await mcp.listToolsets()`) |
|
|
148
|
+
| :---------------- | :--------------------------------------------- | :--------------------------------------------------- |
|
|
149
|
+
| **Use Case** | Single-user, static config (e.g., CLI tool) | Multi-user, dynamic config (e.g., SaaS app) |
|
|
150
|
+
| **Configuration** | Fixed at agent initialization | Per-request, dynamic |
|
|
151
|
+
| **Credentials** | Shared across all uses | Can vary per user/request |
|
|
152
|
+
| **Agent Setup** | Tools added in `Agent` constructor | Tools passed in `.generate()` or `.stream()` options |
|
|
126
153
|
|
|
127
154
|
### Static tools
|
|
128
155
|
|
|
129
|
-
Use the `.
|
|
156
|
+
Use the `.listTools()` method to fetch tools from all configured MCP servers. This is suitable when configuration (such as API keys) is static and consistent across users or requests. Call it once and pass the result to the `tools` property when defining your agent.
|
|
130
157
|
|
|
131
|
-
|
|
158
|
+
:::info
|
|
132
159
|
|
|
133
|
-
|
|
160
|
+
Visit [listTools()](/reference/v1/tools/mcp-client#listtools) for more information.
|
|
161
|
+
|
|
162
|
+
:::
|
|
163
|
+
|
|
164
|
+
```typescript {6} title="src/mastra/agents/test-agent.ts"
|
|
134
165
|
import { Agent } from "@mastra/core/agent";
|
|
135
166
|
|
|
136
167
|
import { testMcpClient } from "../mcp/test-mcp-client";
|
|
137
168
|
|
|
138
169
|
export const testAgent = new Agent({
|
|
139
|
-
|
|
140
|
-
tools: await testMcpClient.
|
|
170
|
+
id: "test-agent",
|
|
171
|
+
tools: await testMcpClient.listTools(),
|
|
141
172
|
});
|
|
142
173
|
```
|
|
143
174
|
|
|
144
175
|
### Dynamic tools
|
|
145
176
|
|
|
146
|
-
Use the `.
|
|
177
|
+
Use the `.listToolsets()` method when tool configuration may vary by request or user, such as in a multi-tenant system where each user provides their own API key. This method returns toolsets that can be passed to the `toolsets` option in the agent's `.generate()` or `.stream()` calls.
|
|
147
178
|
|
|
148
|
-
```typescript {5-16,21}
|
|
179
|
+
```typescript {5-16,21}
|
|
149
180
|
import { MCPClient } from "@mastra/mcp";
|
|
150
181
|
import { mastra } from "./mastra";
|
|
151
182
|
|
|
@@ -166,7 +197,7 @@ async function handleRequest(userPrompt: string, userApiKey: string) {
|
|
|
166
197
|
const agent = mastra.getAgent("testAgent");
|
|
167
198
|
|
|
168
199
|
const response = await agent.generate(userPrompt, {
|
|
169
|
-
toolsets: await userMcp.
|
|
200
|
+
toolsets: await userMcp.listToolsets(),
|
|
170
201
|
});
|
|
171
202
|
|
|
172
203
|
await userMcp.disconnect();
|
|
@@ -177,7 +208,11 @@ async function handleRequest(userPrompt: string, userApiKey: string) {
|
|
|
177
208
|
}
|
|
178
209
|
```
|
|
179
210
|
|
|
180
|
-
|
|
211
|
+
:::info
|
|
212
|
+
|
|
213
|
+
Visit [listToolsets()](/reference/v1/tools/mcp-client#listtoolsets) for more information.
|
|
214
|
+
|
|
215
|
+
:::
|
|
181
216
|
|
|
182
217
|
## Connecting to an MCP registry
|
|
183
218
|
|
|
@@ -1,6 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: "Publishing an MCP Server | MCP"
|
|
3
3
|
description: Guide to setting up and building a Mastra MCP server using the stdio transport, and publishing it to NPM.
|
|
4
|
+
packages:
|
|
5
|
+
- "@mastra/core"
|
|
6
|
+
- "@mastra/mcp"
|
|
4
7
|
---
|
|
5
8
|
|
|
6
9
|
import Steps from "@site/src/components/Steps";
|
|
@@ -32,7 +35,7 @@ Create a file for your stdio server, for example, `/src/mastra/stdio.ts`.
|
|
|
32
35
|
|
|
33
36
|
Add the following code to the file. Remember to import your actual Mastra tools and name the server appropriately.
|
|
34
37
|
|
|
35
|
-
```typescript title="src/mastra/stdio.ts"
|
|
38
|
+
```typescript title="src/mastra/stdio.ts"
|
|
36
39
|
#!/usr/bin/env node
|
|
37
40
|
import { MCPServer } from "@mastra/mcp";
|
|
38
41
|
import { weatherTool } from "./tools";
|
|
@@ -55,7 +58,7 @@ server.startStdio().catch((error) => {
|
|
|
55
58
|
|
|
56
59
|
Update your `package.json` to include the `bin` entry pointing to your built server file and a script to build the server with both ESM and CJS outputs.
|
|
57
60
|
|
|
58
|
-
```json title="package.json"
|
|
61
|
+
```json title="package.json"
|
|
59
62
|
{
|
|
60
63
|
"bin": "dist/stdio.mjs",
|
|
61
64
|
"scripts": {
|
|
@@ -132,8 +135,8 @@ const mcp = new MCPClient({
|
|
|
132
135
|
});
|
|
133
136
|
|
|
134
137
|
// You can then get tools or toolsets from this configuration to use in your agent
|
|
135
|
-
const tools = await mcp.
|
|
136
|
-
const toolsets = await mcp.
|
|
138
|
+
const tools = await mcp.listTools();
|
|
139
|
+
const toolsets = await mcp.listToolsets();
|
|
137
140
|
```
|
|
138
141
|
|
|
139
142
|
Note: If you published without an organization scope, the `args` might just be `["-y", "your-package-name@latest"]`.
|
|
@@ -1,13 +1,19 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: "Memory Processors | Memory"
|
|
3
3
|
description: "Learn how to use memory processors in Mastra to filter, trim, and transform messages before they're sent to the language model to manage context window limits."
|
|
4
|
+
packages:
|
|
5
|
+
- "@mastra/core"
|
|
6
|
+
- "@mastra/libsql"
|
|
7
|
+
- "@mastra/memory"
|
|
8
|
+
- "@mastra/openai"
|
|
9
|
+
- "@mastra/pinecone"
|
|
4
10
|
---
|
|
5
11
|
|
|
6
12
|
# Memory Processors
|
|
7
13
|
|
|
8
14
|
Memory processors transform and filter messages as they pass through an agent with memory enabled. They manage context window limits, remove unnecessary content, and optimize the information sent to the language model.
|
|
9
15
|
|
|
10
|
-
When memory is enabled on an agent, Mastra adds memory processors to the agent's processor pipeline. These processors retrieve
|
|
16
|
+
When memory is enabled on an agent, Mastra adds memory processors to the agent's processor pipeline. These processors retrieve message history, working memory, and semantically relevant messages, then persist new messages after the model responds.
|
|
11
17
|
|
|
12
18
|
Memory processors are [processors](/docs/v1/agents/processors) that operate specifically on memory-related messages and state.
|
|
13
19
|
|
|
@@ -17,7 +23,7 @@ Mastra automatically adds these processors when memory is enabled:
|
|
|
17
23
|
|
|
18
24
|
### MessageHistory
|
|
19
25
|
|
|
20
|
-
Retrieves
|
|
26
|
+
Retrieves message history and persists new messages.
|
|
21
27
|
|
|
22
28
|
**When you configure:**
|
|
23
29
|
|
|
@@ -40,7 +46,7 @@ memory: new Memory({
|
|
|
40
46
|
|
|
41
47
|
**Example:**
|
|
42
48
|
|
|
43
|
-
```typescript
|
|
49
|
+
```typescript
|
|
44
50
|
import { Agent } from "@mastra/core/agent";
|
|
45
51
|
import { Memory } from "@mastra/memory";
|
|
46
52
|
import { LibSQLStore } from "@mastra/libsql";
|
|
@@ -89,7 +95,7 @@ memory: new Memory({
|
|
|
89
95
|
|
|
90
96
|
**Example:**
|
|
91
97
|
|
|
92
|
-
```typescript
|
|
98
|
+
```typescript
|
|
93
99
|
import { Agent } from "@mastra/core/agent";
|
|
94
100
|
import { Memory } from "@mastra/memory";
|
|
95
101
|
import { LibSQLStore } from "@mastra/libsql";
|
|
@@ -109,7 +115,6 @@ const agent = new Agent({
|
|
|
109
115
|
vector: new PineconeVector({
|
|
110
116
|
id: "memory-vector",
|
|
111
117
|
apiKey: process.env.PINECONE_API_KEY!,
|
|
112
|
-
environment: "us-east-1",
|
|
113
118
|
}),
|
|
114
119
|
embedder: new OpenAIEmbedder({
|
|
115
120
|
model: "text-embedding-3-small",
|
|
@@ -145,7 +150,7 @@ memory: new Memory({
|
|
|
145
150
|
|
|
146
151
|
**Example:**
|
|
147
152
|
|
|
148
|
-
```typescript
|
|
153
|
+
```typescript
|
|
149
154
|
import { Agent } from "@mastra/core/agent";
|
|
150
155
|
import { Memory } from "@mastra/memory";
|
|
151
156
|
import { LibSQLStore } from "@mastra/libsql";
|
|
@@ -169,10 +174,10 @@ const agent = new Agent({
|
|
|
169
174
|
|
|
170
175
|
If you manually add a memory processor to `inputProcessors` or `outputProcessors`, Mastra will **not** automatically add it. This gives you full control over processor ordering:
|
|
171
176
|
|
|
172
|
-
```typescript
|
|
177
|
+
```typescript
|
|
173
178
|
import { Agent } from "@mastra/core/agent";
|
|
174
179
|
import { Memory } from "@mastra/memory";
|
|
175
|
-
import { MessageHistory } from "@mastra/
|
|
180
|
+
import { MessageHistory } from "@mastra/core/processors";
|
|
176
181
|
import { TokenLimiter } from "@mastra/core/processors";
|
|
177
182
|
import { LibSQLStore } from "@mastra/libsql";
|
|
178
183
|
import { openai } from "@ai-sdk/openai";
|
|
@@ -211,7 +216,7 @@ Understanding the execution order is important when combining guardrails with me
|
|
|
211
216
|
1. **Memory processors run FIRST**: `WorkingMemory`, `MessageHistory`, `SemanticRecall`
|
|
212
217
|
2. **Your input processors run AFTER**: guardrails, filters, validators
|
|
213
218
|
|
|
214
|
-
This means memory loads
|
|
219
|
+
This means memory loads message history before your processors can validate or filter the input.
|
|
215
220
|
|
|
216
221
|
### Output Processors
|
|
217
222
|
|
|
@@ -236,7 +241,7 @@ Output guardrails run **before** memory processors save messages. If a guardrail
|
|
|
236
241
|
- Memory processors are skipped
|
|
237
242
|
- **No messages are persisted to storage**
|
|
238
243
|
|
|
239
|
-
```typescript
|
|
244
|
+
```typescript
|
|
240
245
|
import { Agent } from "@mastra/core/agent";
|
|
241
246
|
import { Memory } from "@mastra/memory";
|
|
242
247
|
import { openai } from "@ai-sdk/openai";
|
|
@@ -267,7 +272,7 @@ const agent = new Agent({
|
|
|
267
272
|
// If the guardrail aborts, nothing is saved to memory
|
|
268
273
|
const result = await agent.generate("Hello");
|
|
269
274
|
if (result.tripwire) {
|
|
270
|
-
console.log("Blocked:", result.
|
|
275
|
+
console.log("Blocked:", result.tripwire.reason);
|
|
271
276
|
// Memory is empty - no messages were persisted
|
|
272
277
|
}
|
|
273
278
|
```
|
|
@@ -281,7 +286,7 @@ Input guardrails run **after** memory processors load history. If a guardrail ab
|
|
|
281
286
|
- Output processors (including memory persistence) are skipped
|
|
282
287
|
- **No messages are persisted to storage**
|
|
283
288
|
|
|
284
|
-
```typescript
|
|
289
|
+
```typescript
|
|
285
290
|
// Input guardrail that validates user input
|
|
286
291
|
const inputValidator = {
|
|
287
292
|
id: "input-validator",
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Message History | Memory"
|
|
3
|
+
description: "Learn how to configure message history in Mastra to store recent messages from the current conversation."
|
|
4
|
+
packages:
|
|
5
|
+
- "@mastra/ai-sdk"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Message History
|
|
9
|
+
|
|
10
|
+
Message history is the simplest kind of memory. It is a list of messages from the current conversation.
|
|
11
|
+
|
|
12
|
+
Once enabled, each request includes the last 10 messages from the current memory thread, giving the agent short-term conversational context. This limit can be increased using the `lastMessages` parameter:
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
export const agent = new Agent({
|
|
16
|
+
id: "test-agent",
|
|
17
|
+
memory: new Memory({
|
|
18
|
+
options: {
|
|
19
|
+
lastMessages: 20,
|
|
20
|
+
},
|
|
21
|
+
}),
|
|
22
|
+
});
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Querying Messages
|
|
26
|
+
|
|
27
|
+
Messages are stored in the `MastraDBMessage` format, which provides a consistent structure across the entire Mastra system.
|
|
28
|
+
|
|
29
|
+
Storage in Mastra uses domain-specific stores. To access message operations, first get the memory store:
|
|
30
|
+
|
|
31
|
+
```typescript
|
|
32
|
+
// Get the memory store from storage
|
|
33
|
+
const storage = mastra.getStorage();
|
|
34
|
+
const memoryStore = await storage.getStore('memory');
|
|
35
|
+
|
|
36
|
+
// Get messages for a thread with pagination
|
|
37
|
+
const result = await memoryStore?.listMessages({
|
|
38
|
+
threadId: "your-thread-id",
|
|
39
|
+
page: 0,
|
|
40
|
+
perPage: 50
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
console.log(result?.messages); // MastraDBMessage[]
|
|
44
|
+
console.log(result?.total); // Total count
|
|
45
|
+
console.log(result?.hasMore); // Whether more pages exist
|
|
46
|
+
|
|
47
|
+
// Get messages from multiple threads at once
|
|
48
|
+
const multiThreadResult = await memoryStore?.listMessages({
|
|
49
|
+
threadId: ["thread-1", "thread-2", "thread-3"],
|
|
50
|
+
page: 0,
|
|
51
|
+
perPage: 100
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
// Get messages by their IDs
|
|
55
|
+
const messages = await memoryStore?.listMessagesById({ messageIds: messageIdArr });
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
The `threadId` parameter accepts either a single thread ID string or an array of thread IDs to query messages from multiple threads in a single request.
|
|
59
|
+
|
|
60
|
+
All message queries return `MastraDBMessage[]` format. If you need to convert messages to AI SDK formats for UI rendering, use the conversion utilities from `@mastra/ai-sdk/ui`:
|
|
61
|
+
|
|
62
|
+
```typescript
|
|
63
|
+
import { toAISdkV5Messages } from '@mastra/ai-sdk/ui';
|
|
64
|
+
|
|
65
|
+
const storage = mastra.getStorage();
|
|
66
|
+
const memoryStore = await storage.getStore('memory');
|
|
67
|
+
|
|
68
|
+
const result = await memoryStore?.listMessages({ threadId: "your-thread-id" });
|
|
69
|
+
|
|
70
|
+
// Convert to AI SDK v5+ UIMessage format for UI rendering
|
|
71
|
+
const uiMessages = toAISdkV5Messages(result?.messages ?? []);
|
|
72
|
+
```
|
|
@@ -1,32 +1,39 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: "Memory overview | Memory"
|
|
3
|
-
description: "Learn how Mastra's memory system works with working memory,
|
|
3
|
+
description: "Learn how Mastra's memory system works with working memory, message history, and semantic recall."
|
|
4
|
+
packages:
|
|
5
|
+
- "@mastra/core"
|
|
6
|
+
- "@mastra/libsql"
|
|
7
|
+
- "@mastra/memory"
|
|
4
8
|
---
|
|
5
9
|
|
|
6
|
-
# Memory
|
|
10
|
+
# Memory
|
|
7
11
|
|
|
8
|
-
Memory
|
|
12
|
+
Memory gives your agent coherence across interactions and allows it to improve over time by retaining relevant information from past conversations.
|
|
9
13
|
|
|
10
|
-
Mastra
|
|
14
|
+
Mastra requires a [storage provider](./storage) to persist memory and supports three types:
|
|
11
15
|
|
|
12
|
-
|
|
16
|
+
- [**Message history**](/docs/v1/memory/message-history) captures recent messages from the current conversation, providing short-term continuity and maintaining dialogue flow.
|
|
17
|
+
- [**Working memory**](/docs/v1/memory/working-memory) stores persistent user-specific details such as names, preferences, goals, and other structured data.
|
|
18
|
+
- [**Semantic recall**](/docs/v1/memory/semantic-recall) retrieves older messages from past conversations based on semantic relevance. Matches are retrieved using vector search and can include surrounding context for better comprehension.
|
|
19
|
+
|
|
20
|
+
You can enable any combination of these memory types. Mastra assembles the relevant memories into the model’s context window. If the total exceeds the model's token limit, use [memory processors](/docs/v1/memory/memory-processors) to trim or filter messages before sending them to the model.
|
|
13
21
|
|
|
14
22
|
## Getting started
|
|
15
23
|
|
|
16
|
-
|
|
24
|
+
Install Mastra's memory module and the storage adapter for your preferred database (see the storage section below):
|
|
17
25
|
|
|
18
|
-
```bash
|
|
19
|
-
npm install @mastra/
|
|
26
|
+
```bash
|
|
27
|
+
npm install @mastra/memory@beta @mastra/libsql@beta
|
|
20
28
|
```
|
|
21
29
|
|
|
22
|
-
|
|
30
|
+
Add the storage adapter to the main Mastra instance:
|
|
23
31
|
|
|
24
|
-
```typescript
|
|
32
|
+
```typescript title="src/mastra/index.ts"
|
|
25
33
|
import { Mastra } from "@mastra/core";
|
|
26
34
|
import { LibSQLStore } from "@mastra/libsql";
|
|
27
35
|
|
|
28
36
|
export const mastra = new Mastra({
|
|
29
|
-
// ...
|
|
30
37
|
storage: new LibSQLStore({
|
|
31
38
|
id: 'mastra-storage',
|
|
32
39
|
url: ":memory:",
|
|
@@ -34,88 +41,43 @@ export const mastra = new Mastra({
|
|
|
34
41
|
});
|
|
35
42
|
```
|
|
36
43
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
```typescript {3-5} title="src/mastra/agents/test-agent.ts" showLineNumbers copy
|
|
40
|
-
import { Memory } from "@mastra/memory";
|
|
41
|
-
import { Agent } from "@mastra/core/agent";
|
|
42
|
-
|
|
43
|
-
export const testAgent = new Agent({
|
|
44
|
-
id: "test-agent",
|
|
45
|
-
// ...
|
|
46
|
-
memory: new Memory(),
|
|
47
|
-
});
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
That memory instance has options you can configure for working memory, conversation history, and semantic recall.
|
|
51
|
-
|
|
52
|
-
## Different types of memory
|
|
53
|
-
|
|
54
|
-
Mastra supports three types of memory: working memory, conversation history, and semantic recall.
|
|
55
|
-
|
|
56
|
-
[**Working memory**](./working-memory) stores persistent user-specific details such as names, preferences, goals, and other structured data. (Compare this to ChatGPT where you can ask it to tell you about yourself). This is implemented as a block of Markdown text that the agent is able to update over time (or alternately, as a Zod schema)
|
|
57
|
-
|
|
58
|
-
[**Conversation history**](./conversation-history) captures recent messages from the current conversation, providing short-term continuity and maintaining dialogue flow.
|
|
59
|
-
|
|
60
|
-
[**Semantic recall**](./semantic-recall) retrieves older messages from past conversations based on semantic relevance. Matches are retrieved using vector search and can include surrounding context for better comprehension.
|
|
44
|
+
Enable memory by passing a `Memory` instance to your agent:
|
|
61
45
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
## Scoping memory with threads and resources
|
|
65
|
-
|
|
66
|
-
All memory types are [resource-scoped](./working-memory#resource-scoped-memory-default) by default, meaning they persist across all conversations for the same user or entity. [Thread-scoped](./working-memory#thread-scoped-memory) configuration isolates memory to a single conversation thread.
|
|
67
|
-
|
|
68
|
-
## Memory Storage Adapters
|
|
69
|
-
|
|
70
|
-
To persist and recall information between conversations, memory requires a storage adapter.
|
|
71
|
-
|
|
72
|
-
Supported options include [LibSQL](/docs/v1/memory/storage/memory-with-libsql), [MongoDB](/docs/v1/memory/storage/memory-with-mongodb), [Postgres](/docs/v1/memory/storage/memory-with-pg), and [Upstash](/docs/v1/memory/storage/memory-with-upstash)
|
|
73
|
-
|
|
74
|
-
We use LibSQL out of the box because it is file-based or in-memory, so it is easy to install and works well with Studio.
|
|
75
|
-
|
|
76
|
-
## Dedicated storage
|
|
77
|
-
|
|
78
|
-
Agents can be configured with their own dedicated storage, keeping tasks, conversations, and recalled information separate across agents.
|
|
79
|
-
|
|
80
|
-
### Adding storage to agents
|
|
81
|
-
|
|
82
|
-
To assign dedicated storage to an agent, install and import the required dependency and pass a `storage` instance to the `Memory` constructor:
|
|
83
|
-
|
|
84
|
-
```typescript {3, 9-11} title="src/mastra/agents/test-agent.ts" showLineNumbers copy
|
|
46
|
+
```typescript title="src/mastra/agents/test-agent.ts"
|
|
85
47
|
import { Memory } from "@mastra/memory";
|
|
86
48
|
import { Agent } from "@mastra/core/agent";
|
|
87
|
-
import { LibSQLStore } from "@mastra/libsql";
|
|
88
49
|
|
|
89
50
|
export const testAgent = new Agent({
|
|
90
51
|
id: "test-agent",
|
|
91
|
-
// ...
|
|
92
52
|
memory: new Memory({
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
url: "file:agent-memory.db",
|
|
97
|
-
}),
|
|
98
|
-
// ...
|
|
53
|
+
options: {
|
|
54
|
+
lastMessages: 20,
|
|
55
|
+
},
|
|
99
56
|
}),
|
|
100
57
|
});
|
|
101
58
|
```
|
|
59
|
+
When you send a new message, the model can now "see" the previous 20 messages, which gives it better context for the conversation and leads to more coherent, accurate replies.
|
|
102
60
|
|
|
103
|
-
|
|
61
|
+
This example configures basic [message history](/docs/v1/memory/message-history). You can also enable [working memory](/docs/v1/memory/working-memory) and [semantic recall](/docs/v1/memory/semantic-recall) by passing additional options to `Memory`.
|
|
104
62
|
|
|
105
|
-
|
|
63
|
+
## Storage
|
|
106
64
|
|
|
107
|
-
|
|
65
|
+
Before enabling memory, you must first configure a storage adapter. Mastra supports multiple database providers including PostgreSQL, MongoDB, libSQL, and more.
|
|
108
66
|
|
|
109
|
-
|
|
67
|
+
Storage can be configured at the instance level (shared across all agents) or at the agent level (dedicated per agent). You can also use different databases for storage and vector operations.
|
|
110
68
|
|
|
111
|
-
|
|
69
|
+
See the [Storage](/docs/v1/memory/storage) documentation for configuration options, supported providers, and examples.
|
|
112
70
|
|
|
113
|
-
|
|
71
|
+
## Debugging memory
|
|
114
72
|
|
|
115
|
-
|
|
73
|
+
When tracing is enabled, you can inspect exactly which messages the agent uses for context in each request. The trace output shows all memory included in the agent's context window - both recent message history and messages recalled via semantic recall.
|
|
116
74
|
|
|
117
|
-
|
|
75
|
+
This visibility helps you understand why an agent made specific decisions and verify that memory retrieval is working as expected.
|
|
76
|
+
|
|
77
|
+
For more details on enabling and configuring tracing, see [Tracing](/docs/v1/observability/tracing/overview).
|
|
118
78
|
|
|
119
|
-
|
|
79
|
+
## Next Steps
|
|
120
80
|
|
|
121
|
-
|
|
81
|
+
- Learn more about [Storage](/docs/v1/memory/storage) providers and configuration options
|
|
82
|
+
- Add [Message History](/docs/v1/memory/message-history), [Working Memory](/docs/v1/memory/working-memory), or [Semantic Recall](/docs/v1/memory/semantic-recall)
|
|
83
|
+
- Visit [Memory configuration reference](/reference/v1/memory/memory-class) for all available options
|