Skip to main content
Glama

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.

Related MCP server: mcp-eur-lex

2. Install and build

git clone <this-repo> compass-mcp
cd compass-mcp
npm install
npm 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):

{
  "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):

{
  "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:

COMPASS_API_KEY=ck_live_your_key_here node dist/index.js

Tools

compass_retrieve

Param

Type

Notes

query

string

A regulatory question in plain language.

top_k

number

Optional. 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

Param

Type

Notes

node_id

string

The node_id of a provision from compass_retrieve.

quote

string

The exact text you intend to attribute to it.

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

Configuration

Env var

Required

Default

Notes

COMPASS_API_KEY

yes

(none)

Your ck_live_ key.

COMPASS_API_URL

no

https://compass.licentium.ai

Override 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.

Available Tools

2 tools
compass_retrieveA

Ground a claim in EU financial, crypto or AI regulation. Returns the top governing provisions from the core EU acts (MiCA, DORA, MiFID II, the AML package, the AI Act, GDPR and more) as VERBATIM text with article-level citations and cross-references. Call this BEFORE stating anything about EU financial/crypto/AI regulation, and cite the returned provisions by their reference. If nothing is returned, do not assert an answer.

Inputs: query (required), top_k.

compass_verifyA

Check that a quote is a VERBATIM span of a specific EU provision (identified by the node_id returned by compass_retrieve). Use this before presenting a quotation as the words of the law, to guarantee you are not misquoting.

Inputs: quote (required), node_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one retrieves provisions, the other verifies quotes against a specific provision. There is no overlap in functionality.

    Naming Consistency5/5

    Both tools follow a consistent 'compass_verb' naming pattern using snake_case, providing clear and predictable tool names.

    Tool Count3/5

    With only 2 tools, the server feels thin for the broad domain of EU financial, crypto, and AI regulation. While focused, it may be insufficient for complex tasks.

    Completeness3/5

    The tools cover retrieving and verifying provisions, but lack search or listing capabilities, which are essential for navigating a large regulatory corpus. This is a notable gap.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      F
      maintenance
      Query 37 EU regulations — from GDPR and AI Act to DORA, MiFID II, eIDAS, Medical Device Regulation, and more — directly from Claude, Cursor, or any MCP-compatible client.
      14
      25
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Acquis gives your assistant exact, verifiable access to EU digital regulation. Instead of paraphrasing from training data, it returns the verbatim provision of the current consolidated version — with the full citation (act, article, paragraph, point), its in-force status, the consolidation date, and a deep link to EUR-Lex so every claim can be checked. The legal text is rendered from the signed c
      MIT