If your Mastra project lives in GitHub, you can now automatically deploy changes to the Mastra platform.
Connect an existing repository, or pick one of our templates and we'll create the repo for you, and from then on every commit you merge into main ships a new version of your server and studio.
Making CI-driven deployment easier with GitHub
When launching the new Mastra platform, we prioritized the current happy path for agents: all deploys ran through the CLI. While this allowed for local and CI-driven deployments, we knew that it could be easier than having to wire it all up yourself.
Now we’re running tens of thousands of deploys per month, and over half of them are from CI, so we decided it was time to make that even easier.
With our new GitHub app, you can connect any Mastra project to the platform and get new deployments on every merge to main.
Deploy on merge
Bring your own repo and we check that it's a Mastra project and link it to a new platform project in a couple of clicks.
Once a repository is connected, merging into main is the deploy. The platform listens for pushes to your branch, builds your project, and ships a new version — your Mastra server (the deployed runtime your agents and MCP servers run on) and your studio (the hosted workspace where you collaborate, evaluate, and iterate) both update from the same merge.
You can point server and studio at different branches if you want them on separate release cadences, and scope which file paths trigger a deploy so unrelated changes don't rebuild the world.
Deploy a Mastra template
If you don't want to start from an empty repo, templates give you a working project to fork from. Each one is a real, runnable Mastra project with agents, tools, and all the integrations they need. Since they all leverage the Mastra Gateway, you can deploy a template as-is and see a working agent in just a matter of minutes. Today you can try out any of our four starter templates:
Docs Expert: a research assistant that answers questions about libraries, APIs, and documentation by searching the live web and citing its sources.
Company Knowledge Agent: indexes your Linear issues and Notion pages into pgvector (on Neon) and exposes a single agent that answers questions across them. A RAG pipeline and two integrations, already wired.
Autonomous Personal Assistant: an assistant that operates a computer to finish multi-step tasks: read and write files, run shell commands in a sandboxed environment, and chain the steps on its own.
Browser Agent: a browser-using agent built on @mastra/agent-browser, for tasks that mean navigating and acting on real web pages.
Every template includes a quickstart in its repository, so once the project is connected you can add your API keys, run it, and watch it deploy on your next merge.
Get started
If you already have a Mastra project on the platform, open it, connect your GitHub repository, and merge a commit to main to watch it deploy.
If you're starting fresh, you can pick a template from the platform, let us create the repository, and you'll have a project in GitHub that deploys on every merge from the start.
For the full walkthrough, see the GitHub integration docs. We'd love to see what you connect first.
