Lupin

An MCP server for the Revenue Alignment Engine: an opportunity ledger and capability registry with lane-scoped access. Opportunities live in one of two lanes — Qompass (sfw) or NTRanch (nsfw) — and a caller scoped to one lane can never see the other lane's entries.

Lupin is a single Rust binary. It speaks MCP over stdio (NDJSON JSON-RPC) to the client and works on plain files under a data root — no database, no network listener. It is the ledger side of the estate's revenue pipeline; the research-feed server phaedrus drafts candidates into it.

How it runs

• Data root (ledger, capability registry, scan inbox): --root <path> or the REVENUE_ROOT environment variable (default ~/workspace/revenue-alignment-20261019).

• Lane scope: --lane-scope operator|sfw (default operator). The operator scope sees both lanes; an sfw-scoped caller can never see nsfw entries.

• Read-mostly by design: the only write files a candidate into the scan inbox (opportunity_submit). The validated ledger is never written by this server, and capability_match is advisory only — it never auto-aligns an opportunity.

Related MCP server: BountyPilot

Tools

Client config

{
  "mcpServers": {
    "lupin": {
      "command": "/path/to/lupin",
      "args": []
    }
  }
}

Registry

server.json in this repo is the MCP Registry record for ai.qompass/lupin. The server is distributed as an MCPB bundle attached to the GitHub releases (Linux x64).

License

Apache-2.0 — see LICENSE.