Developer-tools MCP server

Next.js DevTools MCP

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Packagenext-devtools-mcp
Latest analyzed version0.4.0
Current tool count4
Latest analysisNov 15, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed0.3.9 → 0.4.0Latest: 0.4.0
  • read0
  • write0
  • destructive0
  • unknown4

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
next-devtools-mcp@0.4.0
Registry
npm
Published
Jun 24, 2026
Integrity
sha512-PTIoi+TihyztSTPkl+YIesL81wU3pRDo6QCg1wgjvLGfBlXv3yamvQyoI8j/I2t7gqDStXoa7jtn/YUdvcBQuw==
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/vercel/next-devtools-mcp

4 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
browser_evalnext-devtools:tool:browser_eval
Observed interface and hashes

Set up and use browser automation for this project via the agent-browser CLI. This tool does NOT drive the browser itself. It points you at `agent-browser` — a fast, native browser-automation CLI built for agents (https://github.com/vercel-labs/agent-browser) — and tells you how to install it (if needed) and where to start. You then run its commands directly (you have shell access), which is faster and more capable than proxying automation through MCP. Call this when you need to open pages, click, type, screenshot, or capture console errors in a real browser.

Input schema

{
  "properties": {
    "task": {
      "type": "string"
    }
  },
  "type": "object"
}
sha256:b3583963ca666b6cd451dfe10bd950527022ba84d32b7ee0f39580eb7be51359

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:429d50713ef1ade588ecfa2470efb6c56364a425c158c263cf9f03ae6640a2ac

Interface hash: sha256:db475eae026e3e93b48bf42ee5ec3454cf2b38985fe30769bce998edff21d988

Other observed Modelara metadata
{
  "id": "mcp:next-devtools-mcp/browser_eval",
  "source": {
    "type": "mcp",
    "server": "next-devtools-mcp",
    "operation": "browser_eval"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:e516ae40d610610331316d4626a187e3d1086e89d2418a88429c299a0ae7e2b4"
}
toolunknown0.3.90.4.0
nextjs_callnext-devtools:tool:nextjs_call
Observed interface and hashes

Call a specific MCP tool on a running Next.js development server. REQUIREMENTS: - Port number of the target Next.js dev server - Tool name to execute - Optional arguments object (if the tool requires parameters) Use 'nextjs_index' first to discover available servers, tools, and their input schemas. If 'nextjs_index' auto-discovery fails, ask the user for the port and call 'nextjs_index' again with the 'port' parameter. IMPORTANT: When calling tools: - The 'args' parameter MUST be an object (e.g., {key: "value"}), NOT a string - If a tool doesn't require arguments, OMIT the 'args' parameter entirely - do NOT pass {} or "{}" - Check the tool's inputSchema from 'nextjs_index' to see what arguments are required Common Next.js MCP tools include: - Error diagnostics (get compilation/runtime errors) - Route information (list all routes) - Build status (check compilation state) - Cache management (clear caches) - And more (varies by Next.js version) Example usage: 1. Call 'nextjs_index' to see servers and tools 2. Call 'nextjs_call' with port=3000, toolName="get_errors" to get errors from server on port 3000

Input schema

{
  "properties": {
    "args": {
      "type": "string"
    },
    "port": {
      "description": "Port number of the Next.js dev server (required).",
      "type": "string"
    },
    "toolName": {
      "description": "Name of the Next.js MCP tool to call (required). Use 'nextjs_index' first to discover available tool names.",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:ff81ca23db374e00410e1972dd67358e07703d950d3f59df47789c8857e3e7eb

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:cf611f2e1aabe275b3d7c47b0085f329f32423f09741664df938de056d9bd8e1

Interface hash: sha256:4fbcee8ef66393deae42566e9314a857b25e32995159b3aacd098b99e19fc53f

Other observed Modelara metadata
{
  "id": "mcp:next-devtools-mcp/nextjs_call",
  "source": {
    "type": "mcp",
    "server": "next-devtools-mcp",
    "operation": "nextjs_call"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:7d2e5cd31eb4b6e759c96ff6993917a1d286dfd436c9341166201dda1289cbe9"
}
toolunknown0.3.9No change observed
nextjs_docsnext-devtools:tool:nextjs_docs
Observed interface and hashes

Find the version-accurate Next.js documentation for THIS project. This tool does NOT fetch documentation. Next.js 16+ ships its full docs inside the installed package at `node_modules/next/dist/docs/` (markdown), kept in sync with the exact version you have installed. This tool tells you where those docs are and how to read them — so you read the docs that match this project, not a generic or outdated copy. Call this before answering Next.js questions or writing Next.js code. Then read the relevant guide from the path it returns. If the project is on an older Next.js, it will tell you how to upgrade.

Input schema

{
  "properties": {
    "project_path": {
      "type": "string"
    },
    "topic": {
      "type": "string"
    }
  },
  "type": "object"
}
sha256:35bdacd20227dde2dff8bf45302809971b2c00317fb6f62703f37d6a8354910c

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:d447585ee478dd551098f9c9a300e15c8201b39ff99e3ae780c7c8f6875a1c45

Interface hash: sha256:828dc3f89dda4068884df2e589f945667f165288ebae96eebc2b7b2cbb314b09

Other observed Modelara metadata
{
  "id": "mcp:next-devtools-mcp/nextjs_docs",
  "source": {
    "type": "mcp",
    "server": "next-devtools-mcp",
    "operation": "nextjs_docs"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:4dab720a1bc391a97734ef0859dc9da51a1d66630118a71646e18a20815bad52"
}
toolunknown0.3.90.4.0
nextjs_indexnext-devtools:tool:nextjs_index
Observed interface and hashes

Discover all running Next.js development servers and list their available MCP tools. WHEN TO USE THIS TOOL - Use proactively in these scenarios: 1. **Before implementing ANY changes to the app**: When asked to add, modify, or fix anything in the application: - "Add a loading state" → Check current component structure and routes first - "Fix the navigation" → Inspect existing routes and components - "Update the API endpoint" → Query current routes and data flows - "Add error handling" → Check runtime errors and component hierarchy - "Refactor the auth logic" → Inspect current auth implementation and routes - "Optimize performance" → Check runtime diagnostics and component tree Use this to understand where changes should be made and what currently exists. 2. **For diagnostic and investigation questions**: - "What's happening?" / "What's going on?" / "Why isn't this working?" - "Check the errors" / "See what's wrong" - "What routes are available?" / "Show me the routes" - "Clear the cache" / "Reset everything" - Questions about build status, compilation errors, or runtime diagnostics 3. **For agentic codebase search**: Use this as FIRST CHOICE for searching the currently running app. If not found, fallback to static codebase search tools. KEY PRINCIPLE: If the request involves the running Next.js application (whether to investigate OR modify it), query the runtime FIRST to understand current state before proceeding. REQUIREMENTS: - Next.js 16 or later (MCP support was added in v16) - If you're on Next.js 15 or earlier, upgrade first by running 'npx @next/codemod@latest upgrade latest' Next.js 16+ exposes an MCP (Model Context Protocol) endpoint at /_next/mcp automatically when the dev server starts. No configuration needed - MCP is enabled by default in Next.js 16 and later. This tool discovers all running Next.js servers and returns: - Server port, PID, and URL - Complete list of available MCP tools for each server - Tool descriptions and input schemas After calling this tool, use 'nextjs_call' to execute specific tools. [IMPORTANT] If auto-discovery returns no servers: 1. Ask the user which port their Next.js dev server is running on 2. Call this tool again with the 'port' parameter set to the user-provided port If the MCP endpoint is not available: 1. Ensure you're running Next.js 16 or later (upgrade with 'npx @next/codemod@latest upgrade latest') 2. Verify the dev server is running (npm run dev) 3. Check that the dev server started successfully without errors

Input schema

{
  "properties": {
    "port": {
      "type": "string"
    }
  },
  "type": "object"
}
sha256:cc3fb8b260a4420e8fd86e908a6c6c7542c2f25426bb25d130946c3f227636f4

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:eebfaf7dbc4d8f14288cd9c59b07eeb13d1cea5a585c8b6e3a0455bdb88ce007

Interface hash: sha256:4f760490fa3bf6ef285de16042417d106cc60bb4e279a7a361f3b941d8758ee6

Other observed Modelara metadata
{
  "id": "mcp:next-devtools-mcp/nextjs_index",
  "source": {
    "type": "mcp",
    "server": "next-devtools-mcp",
    "operation": "nextjs_index"
  },
  "declared": {
    "read_only": "unknown",
    "destructive": "unknown",
    "idempotent": "unknown",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "unknown",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "absent"
  },
  "fingerprint": "sha256:4e5c95451141e99c63f41456f03fbec14b210128505de20bd5429a4721e0463d"
}
toolunknown0.3.90.4.0

STATIC COMPARISONS

Release history

2 release transitions
  1. 0 added3 removed2 schema0 write0 destructive0 unknown

    Nov 15, 2026· Pending human review

  2. 0 added0 removed1 schema0 write0 destructive0 unknown

    Nov 15, 2026· Pending human review