Madjik Io

io.github.madjik-ioPublished by GitHub account madjik-iov2.0.2Updated Oct 25, 2026

Quantum-finance market metrics for AI agents, computed by the Black Belt Labs engine.

VerifiedSTDIODesktop onlyFinance Data & Analytics

Server details

Identifier: io.github.madjik-io/mcp-server
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account madjik-io for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.madjik-io%2Fmcp-server.svg)](https://sourceweft.com/mcp/io.github.madjik-io%2Fmcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A local MCP server that gives AI assistants access to Black Belt Labs quantum-finance market metrics, including portfolio optimisation, VaR and risk signals.

What you can do: Browse and search the metric catalog by category, keyword or computation method, and fetch any single metric by ID, including quantum-computed and AI-enhanced metrics. Retrieve a composite risk snapshot combining VaR, leverage, liquidation and correlation signals. Metrics cover portfolio optimisation, risk simulation, sentiment, market narrative and regime detection.
When to use it: Useful when an assistant needs quantitative market-risk or portfolio indicators for analysis or discussion, such as asking for a current VaR estimate or a risk snapshot across assets.
Requirements: Runs locally via npx with Node.js 18 or newer. Requires a Black Belt Labs API key supplied through the BLACKBELTLABS_API_KEY environment variable; the README states Madjik keys are not accepted. Network access to the provider's API is implied.

Before you install

Requires a paid-provider API key; the manifest and README disagree on the key name and format, so verify which variable and key type actually work. Metrics are informational indicators, not investment advice. Queries and the key are sent to the third-party provider.

Installation

In SourceWeft

Open Madjik Io in the dashboard and add it to a workspace.
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

@blackbeltlabs/mcp-server

Quantum-finance intelligence for AI agents.

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

Requirements

Node.js ≥ 18
A Black Belt Labs API key (bbl_live_... or bbl_test_...) — get one at blackbeltlabs.fi

Note: Madjik API keys (mk_...) are not accepted. BBL keys are issued separately at blackbeltlabs.fi.

Quickstart

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

{  "mcpServers": {    "blackbeltlabs": {      "command": "npx",      "args": ["-y", "@blackbeltlabs/mcp-server"],      "env": {        "BLACKBELTLABS_API_KEY": "bbl_live_your_key_here"      }    }  }}

{  "mcpServers": {    "blackbeltlabs": {      "command": "npx",      "args": ["-y", "@blackbeltlabs/mcp-server"],      "env": {        "BLACKBELTLABS_API_KEY": "bbl_live_your_key_here"      }    }  }}

Restart Claude Desktop. You can now ask: "What is the current quantum VaR estimate from Black Belt Labs?"

Other MCP clients

Available Tools

Tool	Description
`get_metric`	Fetch any single metric by ID (e.g. `ME10021`)
`get_quantum_metrics`	Fetch all quantum-computed metrics (ME10021, ME10022)
`get_ai_metrics`	Fetch all AI-enhanced metrics (ME10016, ME10017, ME10019, ME10020, ME10010)
`get_risk_snapshot`	Composite risk view: QC VaR + leverage + liquidation + correlation
`list_metrics`	Browse catalog by category or computation method
`search_metrics`	Search by keyword (e.g. `quantum`, `sentiment`, `regime`)

Key Metrics

ID	Name	Method
ME10021	Portfolio Optimisation	⚛️ Quantum (QAOA)
ME10022	Risk Simulation — VaR	⚛️ Quantum (QAE)
ME10017	Sentiment Index	🤖 AI (Gemini)
ME10019	Market Narrative	🤖 AI (Gemini)
ME10016	Regime Detection	🤖 AI + HMM
ME10002	Leverage Stress Index	Classical
ME10004	Liquidation Cascade Risk	Classical

License

Disclaimer

Madjik 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).

Source: README.md at commit 256fd42

Tools

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

Version history

v2.0.2LatestSep 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