Quickstart

Prerequisites

Install uv if you don’t have it:

curl -LsSf https://astral.sh/uv/install.sh | sh

No other installation required - uvx fetches nablr on demand from PyPI.

Connect to your AI assistant

Cursor
Claude Desktop
Windsurf

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"]
    }
  }
}

Or via UI: Settings → MCP → Add New MCP Server

Name: nablr
Type: command
Command: uvx nablr

Add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"]
    }
  }
}

Restart your AI assistant after saving the config.

Verify the connection

In your AI assistant, type:

What nablr agents are available?

You should see a list of agents with descriptions. No key required - nablr runs in free tier by default.

Start a free trial

14-day full Pro access. No signup. No credit card. No browser required. Tell your AI assistant:

Start my nablr trial

nablr generates a device ID, calls the license server, and caches the trial key locally. Pro access activates immediately - no restart needed.

One trial per device. If you see “trial already used for this device”, your 14-day window has expired. Subscribe at nablr.nablrco.com to continue.

Activate a paid key

After subscribing at nablr.nablrco.com, you receive a key by email (sk_nablr_...). Option 1 - via your AI assistant (recommended):

Activate my key sk_nablr_<your-key-here>

Option 2 - via environment variable (CI / team deployments): Add env to your MCP config:

Cursor
Claude Desktop
Windsurf

{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"],
      "env": {
        "NABLR_API_KEY": "sk_nablr_<your-key-here>"
      }
    }
  }
}

{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"],
      "env": {
        "NABLR_API_KEY": "sk_nablr_<your-key-here>"
      }
    }
  }
}

{
  "mcpServers": {
    "nablr": {
      "command": "uvx",
      "args": ["nablr"],
      "env": {
        "NABLR_API_KEY": "sk_nablr_<your-key-here>"
      }
    }
  }
}

NABLR_API_KEY always takes precedence over any locally stored key.

What you get per tier

Feature	Free	Trial / Pro
40+ code scanners	✅	✅
Workflow tools	✅	✅
Codebase mapping (CODE_MAP)	✅	✅
19 SDLC persona prompts	-	✅
34 rule files	-	✅
Language & framework configs	-	✅
Offline asset cache	-	✅

Try a use case

Pick the problem that matches your situation:

Faultline

Codebase full of unknown debt

Tollgate

AI-generated code shipping defects

Blueprint

Requirements no one can build from

Tracer

Production incident with unknown root cause

ProofRun

Green CI but real failures in prod

Waypoint

Platform migration with no exit plan

Sentinel

AI-assisted dev with no audit trail

Blast Radius

Schema change breaking unknown services

Compass

Inherited codebase with no docs

Airlock

Concurrent sessions colliding on shared state

Full SDLC workflow

Set agent to discovery       → scan codebase, generate CODE_MAP
Set agent to product_manager → write requirements with testable AC
Set agent to qa_lead         → validate AC before development
Set agent to architect       → design boundaries and integration points
Set agent to developer       → implement with quality enforcement
Set agent to tester          → write real-execution tests
Set agent to pr_reviewer     → review for compliance + AI anti-patterns

Get started

Use Cases

Agents

Tools

License & Plans

Security

Prerequisites

Connect to your AI assistant

Verify the connection

Start a free trial

Activate a paid key

What you get per tier

Try a use case

Faultline

Tollgate

Blueprint

Tracer

ProofRun

Waypoint

Sentinel

Blast Radius

Compass

Airlock

Full SDLC workflow

​ Prerequisites

​ Connect to your AI assistant

​ Verify the connection

​ Start a free trial

​ Activate a paid key

​ What you get per tier

​ Try a use case

Faultline

Tollgate

Blueprint

Tracer

ProofRun

Waypoint

Sentinel

Blast Radius

Compass

Airlock

​ Full SDLC workflow

Prerequisites

Connect to your AI assistant

Verify the connection

Start a free trial

Activate a paid key

What you get per tier

Try a use case

Full SDLC workflow