Mastra

npm install @mastra/core@latest zod@latest typescript@latest @types/node@latest mastra@latest Create a tsconfig.json file: { "compilerOptions" : { "target" : "ES2022" , "module" : "ES2022" , "moduleResolution" : "bundler" , "esModuleInterop" : true , "forceConsistentCasingInFileNames" : true , "strict" : true , "skipLibCheck" : true , "noEmit" : true , "allowImportingTsExtensions" : true , "outDir" : "dist" } , "include" : [ "src/**/*" ] } If you need to add a tool to the agent, create a new file and use import { createTool } from "@mastra/core/tools" . Plain object tool definitions silently fail to execute; tools MUST be defined via createTool() with id , description , inputSchema (zod), execute() . execute has exactly one signature: execute(inputData, context) . The first parameter is the input validated against inputSchema . The second is the execution context, which the runtime always provides and contains requestContext , tracingContext , abortSignal , and other execution metadata. You may omit the second parameter from your function signature when you don't need it. If you've seen a different execute shape elsewhere, it's outdated. Use the signature shown here. Example: // src/mastra/tools/weather-tool.ts import { createTool } from '@mastra/core/tools' import { z } from 'zod' export const weatherTool = createTool ( { id : 'get-weather' , description : 'Get current weather for a location' , inputSchema : z . object ( { location : z . string ( ) . describe ( 'City name' ) , } ) , outputSchema : z . object ( { location : z . string ( ) , temperatureCelsius : z . number ( ) , conditions : z . string ( ) , } ) , execute : async ( { location } ) => { return { location , temperatureCelsius : 21 , conditions : 'sunny' , } } , } ) If you need to create an agent, create a new file and use import { Agent } from "@mastra/core/agent" . The constructor takes { id, name, instructions, model } . The model property is a string in Mastra's model router format. No provider import is needed for this format. Don't install any AI SDK package unless Mastra's documentation says otherwise. By defining the model using provider/model format Mastra automatically looks for environment variables for the provider. The defined model requires an environment variable to be set for the provider. OpenAI: OPENAI_API_KEY . Anthropic: ANTHROPIC_API_KEY . Google: GOOGLE_API_KEY . Example: Any openai/<model> requires the OPENAI_API_KEY environment variable. Go to https://mastra.ai/models/environment-variables for a full list of supported providers and their environment variable names. Short list of known model IDs are: openai/gpt-5.6-sol , openai/gpt-5-mini anthropic/claude-sonnet-4-6 , anthropic/claude-opus-4-7 , anthropic/claude-haiku-4-5 google/gemini-2.5-flash Go to https://mastra.ai/models for a full list of supported models. Add a tool to an agent by importing the tool and passing it to the agent constructor as a tools object. Example: // src/mastra/agents/weather-agent.ts import { Agent } from '@mastra/core/agent' import { weatherTool } from '../tools/weather-tool.ts' export const weatherAgent = new Agent ( { id : 'weather-agent' , name : 'Weather Agent' , instructions :