NestJS Starter

npx create-xmcp-app --example nestjs

pnpm install
pnpm dev

├── src/
│   ├── main.ts                  # NestJS bootstrap
│   ├── app.module.ts            # Root module
│   ├── health/
│   │   └── health.controller.ts # Health endpoint
│   ├── users/
│   │   ├── users.controller.ts  # Example REST API
│   │   ├── users.module.ts
│   │   ├── users.service.ts
│   │   └── users.store.ts       # Shared in-memory data store
│   ├── tools/
│   │   └── list-users.ts        # Example MCP tool
│   └── xmcp/
│       ├── xmcp.controller.ts   # /mcp route
│       ├── xmcp.filter.ts       # JSON-RPC error response filter
│       └── xmcp.module.ts
├── nest-cli.json
├── xmcp.config.ts
├── package.json
└── tsconfig.json

import { Controller, UseFilters } from "@nestjs/common";
import { XmcpController } from "@xmcp/adapter";
import { McpExceptionFilter } from "./xmcp.filter";

@Controller("mcp")
@UseFilters(McpExceptionFilter)
export class McpController extends XmcpController {}

import { type ToolMetadata } from "xmcp";

export const schema = {};

export const metadata: ToolMetadata = {
  name: "list-users",
  description: "List users from the NestJS app",
};

export default async function listUsers() {
  return "No users yet.";
}

pnpm build
pnpm start