@nuanced-dev/nuanced

Nuanced MCP Server

Model Context Protocol (MCP) server that provides code analysis capabilities. The code graph and LSP tools are license‑gated and supports multiple activation paths suitable for native and Docker deployments.

Please see the dev docs for more information.

Tools

Nuanced MCP supports the following tools:

Tool	Requires Active License	Description
index	Yes	Index or re-index the code in a directory.
analyze_function	Yes	Analyze a function with its call graph and metadata.
list_files	Yes	List files in the current workspace.
read_source	Yes	Read source code for a file.
definitions_in_file	Yes	Retrieves symbol definitions for a specified file.
find_definition	Yes	Finds the definition of a symbol for a given position in a file.
find_identifier	Yes	Finds an identifier by name within a file.
find_referenced_symbols	Yes	Retrieves any symbols and their definitions within the function body of the provided position.
find_references	Yes	Retrieves a symbol’s references.
subscription_status	No	Return cached activation status for the MCP server process.
activate_subscription	No	Validate a user‑provided license key and activate.
resume_subscription	No	Re‑validate using env/file without asking the user for the key.

Subscription Activation Options

Start a free trial or get a subscription at https://www.nuanced.dev/pricing.

Once you have a license key, activate Nuanced using one of the following methods:

• On the command line, run:

  nuanced activate
  

• Set environment variable NUANCED_LICENSE_KEY=YOUR_LICENSE_KEY

• Edit the license config file (JSON) to say { "license_key": "YOUR_LICENSE_KEY" }:

  • macOS/Unix: ~/.config/nuanced/license.json
  • Linux: $XDG_CONFIG_HOME/nuanced/license.json or ~/.config/nuanced/license.json
  • Windows: %APPDATA%\nuanced\license.json
  • Docker: /var/lib/nuanced/license.json (via Docker named volume nuanced-mcp-data)

MCP Client Integration

Configure your favorite agent or IDE to use Nuanced by instructing it to use the following commands:

npx -y @nuanced-dev/nuanced@latest

Please see the dev docs for configuration instructions for various agents.