Skip to main content
You can deploy your Mastra projects to Blaxel with minimal code editing (and zero configuration), enabling you to use Serverless Deployments, Agentic Observability, Policies, and more.

​
Get started with Mastra on Blaxel

To get started with Mastra on Blaxel:
  • if you already have a Mastra agent, adapt your code with Blaxel SDK commands to connect to MCP servers, LLMs and other agents.
  • else initialize an example project in Mastra by using the following Blaxel CLI command and selecting the Mastra hello world:
bl new agent
Deploy it by running: 
bl deploy

​
Develop a Mastra agent using Blaxel features

While building your agent in Mastra, use Blaxel SDK to connect to resources already hosted on Blaxel:

​
Connect to MCP servers

Connect to MCP servers using the Blaxel SDK to access pre-built or custom tool servers hosted on Blaxel. This eliminates the need to manage server connections yourself, with credentials stored securely on the platform. Run the following command to retrieve tools in Mastra format: 

import { blTools } from '@blaxel/mastra';

const tools = await blTools(['mcp-server-name'])

​
Connect to LLMs

Connect to LLMs hosted on Blaxel using the SDK to avoid managing model API connections yourself. All credentials remain securely stored on the platform. 

import { blModel } from "@blaxel/mastra";

const model = await blModel("model-api-name");

​
Connect to other agents

Connect to other agents hosted on Blaxel from your code by using the Blaxel SDK. This allows for multi-agent chaining without managing connections yourself. This command is independent of the framework used to build the agent. 

import { blAgent } from "@blaxel/core";

const myAgentResponse = await blAgent("agent-name").run(input);

​
Host your agent on Blaxel

You can deploy your agent on Blaxel, enabling you to use Serverless Deployments, Agentic Observability, Policies, and more. This command is independent of the framework used to build the agent. Either run the following CLI command from the root of your agent repository. 
bl deploy
Or connect a GitHub repository to Blaxel for automatic deployments every time you push on main.
⌘I