{
  "markdown": "# @blackbeltlabs/mcp-server\n\n**Quantum-finance intelligence for AI agents.**\n\nConnect any MCP-compatible AI agent to Black Belt Labs metrics — quantum-computed portfolio optimisation, VaR simulation, AI-enhanced regime detection, sentiment, and cross-asset risk signals.\n\n## Requirements\n\n- Node.js ≥ 18\n- A Black Belt Labs API key (`bbl_live_...` or `bbl_test_...`) — get one at [blackbeltlabs.fi](https://blackbeltlabs.fi)\n\n> **Note:** Madjik API keys (`mk_...`) are not accepted. BBL keys are issued separately at blackbeltlabs.fi.\n\n## Quickstart\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"blackbeltlabs\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@blackbeltlabs/mcp-server\"],\n      \"env\": {\n        \"BLACKBELTLABS_API_KEY\": \"bbl_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You can now ask: *\"What is the current quantum VaR estimate from Black Belt Labs?\"*\n\n### Other MCP clients\n\n```bash\nBLACKBELTLABS_API_KEY=bbl_live_your_key npx @blackbeltlabs/mcp-server\n```\n\n## Available Tools\n\n| Tool | Description |\n|---|---|\n| `get_metric` | Fetch any single metric by ID (e.g. `ME10021`) |\n| `get_quantum_metrics` | Fetch all quantum-computed metrics (ME10021, ME10022) |\n| `get_ai_metrics` | Fetch all AI-enhanced metrics (ME10016, ME10017, ME10019, ME10020, ME10010) |\n| `get_risk_snapshot` | Composite risk view: QC VaR + leverage + liquidation + correlation |\n| `list_metrics` | Browse catalog by category or computation method |\n| `search_metrics` | Search by keyword (e.g. `quantum`, `sentiment`, `regime`) |\n\n## Key Metrics\n\n| ID | Name | Method |\n|---|---|---|\n| ME10021 | Portfolio Optimisation | ⚛️ Quantum (QAOA) |\n| ME10022 | Risk Simulation — VaR | ⚛️ Quantum (QAE) |\n| ME10017 | Sentiment Index | 🤖 AI (Gemini) |\n| ME10019 | Market Narrative | 🤖 AI (Gemini) |\n| ME10016 | Regime Detection | 🤖 AI + HMM |\n| ME10002 | Leverage Stress Index | Classical |\n| ME10004 | Liquidation Cascade Risk | Classical |\n\n## License\n\nMIT © Black Belt Labs\n\n## Disclaimer\n\nMadjik metrics are informational market indicators computed by the Black Belt Labs engine. They are not investment advice, an offer, or a recommendation to buy or sell any asset. Quantum-computed metrics run on Qiskit simulators (hardware-ready circuit designs).\n",
  "bytes": 2415,
  "sha": "7a950f8afad05e1edbde7301bf7797e6246b369a4c1e91486c3db4304937ae5e",
  "repo_slug": "madjik-io/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_madjik_io_mcp_server_8087d8aa/readme"
}