Adonis MCP

Appearance

Adonis MCPYour AdonisJS app, ready for AI

Build typed tools, resources, and prompts with the framework conventions you already know.

Get started
Explore version 2
🛠️

Tools

Turn application services into typed actions that AI clients can discover and call.

Create a tool

📚

Resources

Expose files, records, and dynamic URI templates as contextual data for models.

Share resources

✨

Prompts

Package reusable workflows with typed arguments and argument completion.

Design prompts

Built for AdonisJS

From application code to MCP in one expressive API.

Keep dependency injection, authentication, Bouncer policies, and validation close to your domain. Adonis MCP handles discovery, protocol messages, and transport details.

TypeScript firstStateless HTTPJSON Schema
app/mcp/tools/greet_tool.ts
import { Tool } from '@jrmc/adonis-mcp'

export default class GreetTool extends Tool {
  name = 'greet'
  description = 'Welcome a user'

  async handle({ response }) {
    return response.text('Welcome!')
  }
}
One endpoint, every client

A clean bridge between AI and your application.

01AI client

Discovers capabilities and sends standard MCP requests.

02Adonis MCP

Routes, validates, authorizes, and formats every exchange.

03Your domain

Runs the application logic you already trust and maintain.

◆Authorization built inUse Auth and Bouncer directly from handler context.◇Your preferred schemaWork with JSON Schema, VineJS, or Zod.◉Easy to inspectDebug over HTTP or stdio and test with a fake transport.↗Modern protocolStateless MCP 2026-07-28 with legacy compatibility.
Ready when you are

Add MCP to your AdonisJS application.

Install the package, register a route, and create your first tool.

node ace add @jrmc/adonis-mcpRead the installation guide