Skip to content
MCP server

Lupin

Local MCP server for an opportunity ledger and capability matching with lane-scoped access

Runs locallyStatus and history
Pricing
Open source
Platforms
Linux, CLI, self-hosted
Runs
Locally
Version
1.0.0
Listing updated
3 days ago

About Lupin

Lupin is an open-source MCP server for sales and crm. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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 this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Apache-2.0

Prices change. Check qompass.ai before you buy.

Lupin 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 to Lupin

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  4. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  6. Find, enrich and score B2B leads and run outreach sequences from an AI assistant

    • 31 tools
    • Remote
    • Freemium
    • 1 GitHub star
    • Sales and CRM