create-xmcp-app

The easiest way to get started with xmcp is by using create-xmcp-app. This CLI tool allows you to scaffold a template project with all the necessary files and dependencies to get you up and running quickly.

Usage

npx create-xmcp-app@latest

You will be asked for the project name and then guided through a series of prompts to configure your project.

To scaffold without installing dependencies:

npx create-xmcp-app@latest my-app --skip-install

Options

• -y, --yes: Skip all confirmation prompts and use defaults
• --use-npm: Use npm as package manager (default)
• --use-yarn: Use yarn as package manager
• --use-pnpm: Use pnpm as package manager
• --use-bun: Use bun as package manager
• --skip-install: Skip installing dependencies
• --http: Enable HTTP transport
• --stdio: Enable STDIO transport
• --ui: Initialize with MCP App template (non-tailwind)
• --ui-kit: Initialize with MCP App template and @xmcp-dev/ui starter files
• --tailwind, --tw: Use Tailwind CSS (only with MCP App template)

Use --ui-kit when you want the MCP App template to start with @xmcp-dev/ui, Tailwind, a schema-driven renderJson tool, and a small handwritten React MCP App. The generated config enables tools and resources, including the skill://xmcp-ui/schema-reference resource used by the renderer tool description. You can also select MCP App with UI kit in the interactive template prompt. The starter places globals.css at the project root, matching the Tailwind MCP App template. It includes shadcn CLI configuration, package imports, and shared theme styles, so you can run pnpm dlx shadcn@latest add button card dialog from the generated project.

Getting Started

• Visit xmcp.dev to learn more about the project.
• Visit xmcp.dev/docs to view the full documentation.

License

This project is licensed under the MIT License - see the LICENSE file for details.