ContextQMD
Back to Mastra

Hono Server Adapter Example

examples/server-hono-adapter/README.md

2025-12-181.0 KB
Original Source

Hono Server Adapter Example

This example demonstrates how to use the @mastra/hono server adapter to run Mastra with Hono.

What it shows

  • Basic server setup with MastraServer
  • Custom routes added after init() with access to Mastra context
  • Accessing the Mastra instance and agents in route handlers

Getting started

  1. Install dependencies:
bash
pnpm install
  1. Copy .env.example to .env and add your OpenAI API key:
bash
cp .env.example .env
  1. Start the server:
bash
pnpm start

Testing the endpoints

List agents:

bash
curl http://localhost:4111/api/agents

Health check (custom route):

bash
curl http://localhost:4111/health

Generate a response:

bash
curl -X POST http://localhost:4111/api/agents/assistantAgent/generate \
  -H "Content-Type: application/json" \
  -d '{"messages": "What is 2+2?"}'

Documentation