# Lupin

> Lupin is an open-source MCP server for sales and crm. Local MCP server for an opportunity ledger and capability matching with lane-scoped access. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, CLI, self-hosted
- **Website:** https://qompass.ai/solutions/lupin/
- **Repository:** https://github.com/qompassai/lupin
- **MCP Registry name:** ai.qompass/lupin
- **Categories:** sales and CRM, productivity
- **Listing updated:** 2026-11-14

## About

Opportunities sit in one of two lanes, Qompass or NTRanch, and a caller scoped to one lane can never see the other lane's entries. The default operator scope sees both. Lupin is a single Rust binary speaking MCP over stdio and working on plain files under a data root, with no database and no network listener.

It is deliberately read-mostly. The only write is opportunity_submit, which files a candidate into a scan inbox; the validated ledger is never written by the server. capability_match is advisory keyword matching and never aligns an opportunity automatically.

It is one side of the Qompass revenue pipeline, with a separate research-feed server drafting candidates into it. Distribution is a Linux x64 MCPB bundle on GitHub releases under Apache-2.0. It suits operators of that pipeline rather than general users.

## Features

- **Lane-scoped access:** A caller limited to one lane never sees entries from the other.
- **Capability registry:** Lists the alignment vocabulary used to classify opportunities.
- **Advisory matching:** Keyword-matches free text against capabilities without auto-aligning.
- **Safe write path:** Candidates go to a scan inbox; the validated ledger stays untouched.
- **Pipeline summary:** Counts by status and lane plus parse health.
- **File-based storage:** Runs on plain files with no database or network listener.

## Good for

- List ledger opportunities filtered by status
- Match a free-text lead against the capability registry
- File a candidate opportunity for review
- Check pipeline counts by lane and status

## Install

### Claude Code (Terminal)

```sh
claude mcp add lupin -- npx -y https://github.com/qompassai/lupin/releases/download/v1.0.0/lupin-mcp-1.0.0-linux-x64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "lupin": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/lupin/releases/download/v1.0.0/lupin-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lupin": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/lupin/releases/download/v1.0.0/lupin-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "lupin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/lupin/releases/download/v1.0.0/lupin-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lupin": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/lupin/releases/download/v1.0.0/lupin-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lupin": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/lupin/releases/download/v1.0.0/lupin-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

## Tools

- `capability_list`: Return the capability registry.
- `capability_match`: Advisory keyword match of free text against capabilities.
- `opportunity_get`: Return one ledger entry by id.
- `opportunity_list`: List ledger opportunities, optionally by status.
- `opportunity_submit`: File a candidate into the scan inbox.
- `pipeline_summary`: Counts by status and lane plus parse health.

## FAQ

### Where does it store data?

In plain files under a data root set with --root or REVENUE_ROOT.

### Can it modify the ledger?

No. opportunity_submit only writes a candidate into the scan inbox.

### How do I restrict what a caller sees?

Start it with --lane-scope sfw; the default operator scope sees both lanes.

### What platform is it built for?

The release bundle is Linux x64, and the code is Apache-2.0.

### Is Lupin free?

Yes. Lupin is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add lupin -- npx -y https://github.com/qompassai/lupin/releases/download/v1.0.0/lupin-mcp-1.0.0-linux-x64.mcpb

### What are the best alternatives to Lupin?

The closest alternatives to Lupin are Ha MCP, Concord MCP, Calven, CompanyData and note1.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

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