Compass

io.github.LicentiumIOPublished by GitHub account LicentiumIOv1.0.1Updated Oct 24, 2026

Ground your LLM in EU financial, crypto and AI regulation, verbatim and cited, via Compass.

VerifiedSTDIODesktop onlyFinanceKnowledge & Memory

Overview

AI-generated overview

Compass grounds an assistant in EU financial, crypto and AI regulation, returning verbatim, article-cited provisions and checking quotes against them.

What you can do
  • Retrieve governing EU provisions: ask a regulatory question in plain language and get verbatim text with article-level citations and cross-references from acts such as MiCA, DORA, MiFID II, the AML package, the AI Act and GDPR, with an optional number of results.
  • Verify quotes: check whether a quote is a verbatim span of a specific provision identified by its node_id, so the model does not misquote the law.
When to use it
Useful when answers must be grounded in EU financial, crypto or AI regulation and you want cited primary-law text rather than model recall, for example for compliance research, scoping questions or checking a quotation before it is used.
Requirements
Runs as a local stdio process started with Node.js (npm package @licentium/compass-mcp, or a cloned and built repository). Requires a Compass API key in the COMPASS_API_KEY environment variable, created on the Compass developer site. Network access to the Compass API; COMPASS_API_URL can override the endpoint for self-hosted use.
Before you install
The API key is a secret and must be kept private; it is passed in the server's environment. The first calls are free, after which usage is metered against Compass credits, so queries can cost money. Questions and quotes are sent to Compass's API. It returns primary-law text only and is a research and scoping tool, not legal advice.

Installation

In SourceWeft

  1. Open Compass in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

compass-mcp

An MCP server that grounds your LLM in EU financial, crypto and AI regulation via Compass. Add it to Claude Desktop, Cursor, or any MCP host, and the model can pull the governing EU provisions, verbatim and article-cited, before it answers.

It exposes two tools over Compass's public grounding API:

  • compass_retrieve: a question in, the top governing provisions out (verbatim text, article-level citations, cross-references) from the core EU acts (MiCA, DORA, MiFID II, the AML package, the AI Act, GDPR and more).
  • compass_verify: check that a quote is a verbatim span of a specific provision, so the model never misquotes the law.

1. Get an API key

Create a key at compass.licentium.ai/developers. It looks like ck_live_.... The first calls are free; after that, usage is metered against your Compass credits. Keep the key secret.

2. Install and build

bash
git clone <this-repo> compass-mcpcd compass-mcpnpm installnpm run build

This produces dist/index.js. (Once published to npm, hosts can run it with npx -y @licentium/compass-mcp and skip the clone/build.)

3. Configure your MCP host

Set COMPASS_API_KEY to your key in the server's environment.

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

json
{  "mcpServers": {    "compass": {      "command": "node",      "args": ["/absolute/path/to/compass-mcp/dist/index.js"],      "env": { "COMPASS_API_KEY": "ck_live_your_key_here" }    }  }}

Restart Claude Desktop. You should see compass_retrieve and compass_verify in the tools list.

Cursor

Add to ~/.cursor/mcp.json (or the project's .cursor/mcp.json):

json
{  "mcpServers": {    "compass": {      "command": "node",      "args": ["/absolute/path/to/compass-mcp/dist/index.js"],      "env": { "COMPASS_API_KEY": "ck_live_your_key_here" }    }  }}

Any other MCP host

Run the binary over stdio with COMPASS_API_KEY set:

bash
COMPASS_API_KEY=ck_live_your_key_here node dist/index.js

Tools

compass_retrieve

ParamTypeNotes
querystringA regulatory question in plain language.
top_knumberOptional. Provisions to return, 1 to 20 (default 8).

Returns the governing provisions as verbatim text, each with its reference (e.g. MiCA, Article 59), a node_id, and any cross-references. Feed a node_id into compass_verify to confirm a quote.

compass_verify

ParamTypeNotes
node_idstringThe node_id of a provision from compass_retrieve.
quotestringThe exact text you intend to attribute to it.

Returns whether the quote is a verbatim span of that provision.

Configuration

Env varRequiredDefaultNotes
COMPASS_API_KEYyes(none)Your ck_live_ key.
COMPASS_API_URLnohttps://compass.licentium.aiOverride only for self-hosted endpoints.

Notes

Compass returns primary-law text only. It is a research and scoping tool, not legal advice. When the corpus does not govern a question, compass_retrieve returns nothing rather than guessing, so instruct your model not to assert an ungrounded answer.

Logs go to stderr so they never corrupt the stdio JSON-RPC stream.

Source: README.md at commit 1f2e13d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts