Next.js

You can automatically explore and document your Next.js API routes with this MCP server. It analyzes your app’s route files to list each API path, supported HTTP methods, parameters, status codes, and request/response schemas, helping you understand and share your API surface quickly.

How to use

Connect to the Next.js MCP Server from your MCP client to start discovering your routes. Use the HTTP endpoint to fetch live route information or run the server locally to generate and serve the data yourself. The server exposes details for each route, including methods, paths, and schemas, so you can build client tooling, docs, or dashboards on top of your Next.js API.

How to install

npm install next-mcp-server

pnpm add next-mcp-server

Additional notes

Cursor usage lets you point clients at a shared MCP data source. Create a configuration file such as mcp.json under your home directory or next to your project, and reference the Next.js MCP Server URL. An example configuration is shown here.

{
  "mcpServers": {
    "next.js": {
      "url": "http://localhost:4857/sse"
    }
  }
}

Output

When you run the server or query it from a client, you receive a structured representation of your routes. Each route entry includes the file path, API path, and a list of handlers with their HTTP methods, paths, function signatures, descriptions, parameters, and possible status codes.

How It Works

The MCP server scans your Next.js app’s API route files, analyzes each route to extract methods, paths, and parameters, and returns a structured view of all API routes along with optional inline documentation.

Restrictions

This server is designed for Next.js App Router projects and may not work when your project is hosted over a network due to filesystem access constraints.

Tools

The server exposes a focused capability to extract route information from Next.js projects.

Available tools

get-routers-info

Scans Next.js app route files to extract API paths, HTTP methods, request parameters, status codes, and response schemas.