Mastra Hono

This walks you through building AI agents and workflows with Mastra v1 Beta, which is currently in beta until its stable release in January 2026. It covers the full stack from defining tools with Zod schemas to serving them through Hono API endpoints. The workflow section is especially detailed because schema matching between steps trips people up constantly. The quick start gets you to a working agent with a tool and HTTP server in about 50 lines. One thing to know upfront is that v1 Beta requires Node.js 22.13.0+ and has different patterns than the stable 0.24.x release, so don't mix documentation between versions or you'll waste time debugging signature mismatches.

skills.sh installs: 386
GitHub stars: 182
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jwynia/agent-skills --skill mastra-hono --agent claude-code

Installs into .claude/skills of the current project.

Files

Mastra + Hono Development

Build production-ready AI agents, tools, and workflows using Mastra v1 Beta with Hono API servers. This skill covers the complete stack from agent definition to deployment.

Target version: Mastra v1 Beta (stable release expected January 2026)

When to Use This Skill

Use when:

Creating Mastra agents with tools and memory
Defining tools with Zod input/output schemas
Building workflows with multi-step data flow
Setting up Hono API servers with Mastra adapters
Implementing agent networks for multi-agent collaboration
Authoring MCP servers to expose agents/tools
Integrating RAG and conversation memory

Do NOT use when:

Working with Mastra stable (0.24.x) - patterns differ significantly
Building non-AI web APIs (use Hono directly)
Simple LLM calls without agents/tools

Prerequisites

Node.js 22.13.0+ (required for v1 Beta)
Package manager: npm, pnpm, or bun
API keys: OpenAI, Anthropic, or other supported providers

# Install v1 Beta packages
npm install @mastra/core@beta @mastra/hono@beta
npm install @ai-sdk/openai  # or other provider
npm install zod hono @hono/node-server

SKILL.md on GitHub