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: Set environment variable NUANCED_DOCKER=1 and /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/mcp@latest

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