Nuxt MCP Toolkit skill

Q: How do I install the Nuxt MCP Toolkit skill?

Run npx skills add https://mcp-toolkit.nuxt.dev. The skill installs from the documentation site. The module itself is added with npx nuxt add mcp.

Q: Where do tool files go?

Into the server/mcp/ directory with tools, resources and prompts subfolders. A subfolder inside tools sets a group, for example admin.

The manage-mcp skill teaches an agent to build an MCP server inside a Nuxt app: tools, resources, prompts, handlers and MCP Apps.

182 ★ on the repository
Last commit Nov 10, 2026
MIT

Skill

nuxt-modules/mcp-toolkitAuthor:nuxt-modules

Install

Works in: Claude Code
Cursor
Codex
Koda
Coddy

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/nuxt-mcp-toolkit

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

The skill contains instructions and code examples. An MCP server generated by the agent exposes application data, so review authentication in the tools.

This is third-party code. Review the repository files before installing.

What it does

Nuxt MCP Toolkit is the `@nuxtjs/mcp-toolkit` module that turns a Nuxt application into an MCP server: files in `server/mcp/` are discovered automatically and registered as tools, resources and prompts. The module ships a manage-mcp skill. Once installed, an agent sets up MCP in a Nuxt project, writes tools, resources and prompts, splits endpoints across several handlers, adds authentication, logging and sessions, and builds interactive MCP Apps widgets in Vue. It also reviews an existing implementation for anti-patterns, sorts out auto-import and validation errors and writes eval suites that check which tools a model picks.

Who it is for. Nuxt developers adding an MCP endpoint to their app who want the agent to follow the module authors' recommendations.

Good fit when

A Nuxt project has no MCP yet and the agent must set up the module and the first tool.
An endpoint is split into public and admin parts, with tools filtered per user.
ChatGPT or Cursor must call an interactive Vue widget from the MCP server.
A tool is not discovered after an edit, or auto-imports stopped working.
An MCP implementation is reviewed for anti-patterns and tool description problems before release.

Not a fit when

The server is built on something other than Nuxt: the skill is entirely about `@nuxtjs/mcp-toolkit`.
You need a ready MCP server to plug in: the skill helps write the code of your own server.
The project runs on Nitro without Nuxt: the repository holds a separate nitro-mcp-toolkit package, while the skill covers the Nuxt module.

Example request

Set up an MCP server in my Nuxt app and add a tool that returns user data by id.

Limitations

The skill works only with the `@nuxtjs/mcp-toolkit` module and a Nuxt application. The package needs `zod`, and `nitro.experimental.asyncContext` must be enabled in `nuxt.config.ts`, otherwise `useEvent`, `useMcpServer` and `useMcpLogger` fail. The skill installs from the documentation site `mcp-toolkit.nuxt.dev` through `npx skills add`, so the site must be reachable. SKILL.md runs to about a thousand lines and together with reference files takes a noticeable share of the context.

How to disable. Delete the manage-mcp skill folder from the agent skills directory. Remove the module itself from `modules` in `nuxt.config.ts` and uninstall the `@nuxtjs/mcp-toolkit` package.

FAQ

How do I install the Nuxt MCP Toolkit skill?

Run `npx skills add https://mcp-toolkit.nuxt.dev`. The skill installs from the documentation site. The module itself is added with `npx nuxt add mcp`.

What can the agent do after installation?

Set up MCP in Nuxt, create tools, resources and prompts, split them into handlers, add authentication and logging, build MCP Apps, review the implementation and sort out typical failures such as an undiscovered tool.

Where do tool files go?

Into the `server/mcp/` directory with `tools`, `resources` and `prompts` subfolders. A subfolder inside `tools` sets a group, for example `admin`.

Why is zod needed?

The module validates tool input and output with zod schemas, so the package is installed together with the module.

How do I check that the model picks the right tools?

The skill can build eval suites: a set of prompts shows which tool the model picks. That exposes tools with unclear descriptions.

Discussion

No questions or reviews yet.

Skills

mcp-use

A plugin with skills for building TypeScript MCP servers and MCP apps: the agent scaffolds, edits, debugs and verifies them

PluginExtended access10.9K

MCP Framework CLI

A CLI creates a TypeScript MCP server scaffold, adds components and checks schema descriptions before client connection

CLIExtended access931

MCPify

A CLI compiler that reads app code, API specs and database schemas and generates a ready MCP server with tool permission checks.

CLIExtended access107

MCP Apps

Editors’ pick

The official plugin with skills for building MCP Apps: interactive UIs on top of MCP tools that render inline in Claude

PluginMinimal access3.1K

coding-tools-mcp

An MCP server that lets an agent read files, search code and run commands in a workspace

MCP serverBroad access1.2K

OpenMCP Client

The openmcp CLI and a VS Code extension for debugging MCP servers: tools, prompts and resources, chat with a model, test cases

CLIExtended access750

Comparison with similar tools

Cards that share the main search query, and how they differ.

Tool	Official	Authentication	Repository stars	Main difference
Nuxt MCP Toolkit (this card)	no		182
FastMCP	no		28,405	an MCP server framework for Python; this skill teaches an agent to do the same inside a Nuxt application
Nuxt MCP Dev	no	not required	914	gives an agent details about a running Nuxt project; here the agent learns to write its own MCP server

README in short

The module needs no configuration: create files and they register themselves. The README lists several handlers in one app, MCP Apps, an inspector in Nuxt DevTools and server advertising in `llms.txt` when `nuxt-llms` is registered.

README badge

Original SKILL.md

---
name: manage-mcp
description: Manage MCP servers in Nuxt with @nuxtjs/mcp-toolkit — setup, create tools/resources/prompts, organize with handlers, build interactive MCP Apps, add elicitation/logging/sessions, review, and troubleshoot.
---

# Manage MCP

Complete skill for managing Model Context Protocol (MCP) servers in Nuxt with [`@nuxtjs/mcp-toolkit`](https://mcp-toolkit.nuxt.dev). Setup, create tools/resources/prompts, organize with multi-handler folder convention, build interactive UI widgets (MCP Apps), wire up sessions and observability, review, and troubleshoot.

## When to Use

- **Setup**: "Setup an MCP server in my Nuxt app", "Add MCP to Nuxt"
- **Create**: "Add a tool that calculates BMI", "Expose a README as a resource", "Create a code-review prompt"
- **Organize**: "Split my MCP into admin + public endpoints", "Filter tools per user"
- **Customize**: "Add authentication to my MCP", "Log every tool call to Axiom", "Stream progress to the client"
- **Build apps**: "Add an interactive Vue widget callable from ChatGPT/Cursor"
- **Persist state**: "Remember the user across tool calls in one session"
- **Review**: "Review my MCP implementation", "Check for best practices"
- **Troubleshoot**: "My tool isn't discovered", "Auto-imports don't work", "OAuth flow keeps triggering"
- **Test**: "Eval which tools the model picks for these prompts"

---

## Setup MCP Server

### Installation

::code-group
```bash [pnpm]
pnpm add @nuxtjs/mcp-toolkit zod
```
```bash [npm]
npm install @nuxtjs/mcp-toolkit zod
```
```bash [yarn]
yarn add @nuxtjs/mcp-toolkit zod
```
```bash [bun]
bun add @nuxtjs/mcp-toolkit zod
```
::

Or in one go via the Nuxt CLI:

```bash

Report a problem