{
  "markdown": "# compass-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server that grounds your LLM in **EU financial, crypto and AI regulation** via [Compass](https://compass.licentium.ai). 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.\n\nIt exposes two tools over Compass's public grounding API:\n\n- **`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).\n- **`compass_verify`**: check that a quote is a verbatim span of a specific provision, so the model never misquotes the law.\n\n## 1. Get an API key\n\nCreate a key at **[compass.licentium.ai/developers](https://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.\n\n## 2. Install and build\n\n```bash\ngit clone <this-repo> compass-mcp\ncd compass-mcp\nnpm install\nnpm run build\n```\n\nThis produces `dist/index.js`. (Once published to npm, hosts can run it with `npx -y @licentium/compass-mcp` and skip the clone/build.)\n\n## 3. Configure your MCP host\n\nSet `COMPASS_API_KEY` to your key in the server's environment.\n\n### Claude Desktop\n\nEdit `claude_desktop_config.json` (Settings → Developer → Edit Config):\n\n```json\n{\n  \"mcpServers\": {\n    \"compass\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/compass-mcp/dist/index.js\"],\n      \"env\": { \"COMPASS_API_KEY\": \"ck_live_your_key_here\" }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You should see `compass_retrieve` and `compass_verify` in the tools list.\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json` (or the project's `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"compass\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/compass-mcp/dist/index.js\"],\n      \"env\": { \"COMPASS_API_KEY\": \"ck_live_your_key_here\" }\n    }\n  }\n}\n```\n\n### Any other MCP host\n\nRun the binary over stdio with `COMPASS_API_KEY` set:\n\n```bash\nCOMPASS_API_KEY=ck_live_your_key_here node dist/index.js\n```\n\n## Tools\n\n### `compass_retrieve`\n\n| Param   | Type   | Notes                                                    |\n| ------- | ------ | -------------------------------------------------------- |\n| `query` | string | A regulatory question in plain language.                 |\n| `top_k` | number | Optional. Provisions to return, 1 to 20 (default 8).     |\n\nReturns 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.\n\n### `compass_verify`\n\n| Param     | Type   | Notes                                              |\n| --------- | ------ | -------------------------------------------------- |\n| `node_id` | string | The `node_id` of a provision from `compass_retrieve`. |\n| `quote`   | string | The exact text you intend to attribute to it.      |\n\nReturns whether the quote is a verbatim span of that provision.\n\n## Configuration\n\n| Env var            | Required | Default                          | Notes                                    |\n| ------------------ | -------- | -------------------------------- | ---------------------------------------- |\n| `COMPASS_API_KEY`  | yes      | (none)                           | Your `ck_live_` key.                     |\n| `COMPASS_API_URL`  | no       | `https://compass.licentium.ai`   | Override only for self-hosted endpoints. |\n\n## Notes\n\nCompass 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.\n\nLogs go to stderr so they never corrupt the stdio JSON-RPC stream.\n",
  "bytes": 3924,
  "sha": "e2d37c3c684a821e482f20e8153a88f5be0e07535d15ccf8d541dc831bb763c6",
  "repo_slug": "licentiumio/compass-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_licentiumio_compass_mcp_fe2a9bd6/readme"
}