Server data from the Official MCP Registry
Ground your LLM in EU financial, crypto and AI regulation, verbatim and cited, via Compass.
About
Ground your LLM in EU financial, crypto and AI regulation, verbatim and cited, via Compass.
Security Report
This is a well-structured MCP server with proper authentication, secure credential handling, and appropriate permissions for its purpose. The code demonstrates good security practices: API keys are sourced from environment variables (not hardcoded), error handling is comprehensive, and the server properly validates inputs via Zod schemas. One minor code quality issue around broad exception handling exists, but does not represent a meaningful security risk. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
3 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: COMPASS_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-licentiumio-compass-mcp": {
"env": {
"COMPASS_API_KEY": "your-compass-api-key-here"
},
"args": [
"-y",
"@licentium/compass-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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
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.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
