# Unl

> Unl is a freemium MCP server for knowledge and memory. Stores project decisions with their reasons and gives them to coding agents first. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, macOS, Linux, Windows, API
- **Website:** https://unlimitless.ai
- **Repository:** https://github.com/unlimitless-inc/unl
- **MCP Registry name:** ai.unlimitless/unl
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-15

## About

Unl targets a common gap with coding agents: rules say what you chose, but not why, so the agent cannot apply the choice to a new case. Unl stores each decision with its reason, author, scope and history. Running npx unlimitless init reads your existing CLAUDE.md, AGENTS.md, Cursor rules and ADRs, shows what it found and lets you choose what to keep. When you replace a decision, the old one stays in the history and is marked replaced.

Supported hooks bring relevant decisions in before the agent acts. Claude Code has prompt and pre-edit hooks, Codex has a prompt judge with a full-session proof still pending, and Cursor uses word and file matching. Tools that read AGENTS.md get a generated decisions section. A receipt command shows what was handed over, though the README stresses that delivery does not prove the agent followed it.

The record lives on your machine, in git storage or .unl/local, with readable files in .unl/decisions/. With telemetry off the local package makes no network connection; the optional judge asks your own coding agent and its provider. A separate hosted connection, which needs an account, brings decisions into other AI chats, but it does not yet sync with the local record.

## Features

- **Decisions with reasons:** Stores wording, reason, author, scope and history together.
- **Import from rules files:** Reads CLAUDE.md, AGENTS.md, Cursor rules and ADRs.
- **Hook delivery:** Gives relevant decisions to the agent before supported actions.
- **Replace with history:** A confirmed new decision supersedes an old one and keeps the trail.
- **Delivery receipt:** Shows what was handed to the agent, without claiming it was followed.
- **Local record:** Keeps the database in git storage or .unl/local.

## Good for

- Stop re-explaining project conventions to each new agent session
- Capture why a library or tool was chosen
- Move decisions out of scattered rules files
- Record a changed decision without losing history
- Share decisions with other AI chats

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http unl https://api.unlimitless.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.unlimitless.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "unl": {
      "url": "https://api.unlimitless.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "unl": {
      "type": "http",
      "url": "https://api.unlimitless.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "unl": {
      "serverUrl": "https://api.unlimitless.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "unl": {
      "type": "http",
      "url": "https://api.unlimitless.ai/mcp"
    }
  }
}
```

## FAQ

### What does it cost?

The local open-source package is free under Apache-2.0 with no account. A hosted connection has paid tiers, shown on its pricing page without amounts here.

### What does it require?

Node.js 20 or later and a coding agent.

### Does it send data anywhere?

With telemetry off the local package makes no network connection, though the optional judge sends material to your coding agent's model provider.

### Does it guarantee the agent obeys?

No. The README says it delivers decisions but the agent still reasons and you decide.

### Is Unl free?

Unl has a free plan, with paid plans for more usage or features.

### How do I add Unl to Claude Code?

Run this command in your terminal: claude mcp add --transport http unl https://api.unlimitless.ai/mcp

### What are the best alternatives to Unl?

The closest alternatives to Unl are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/unl
