Midasflow Mcp Quickstart

io.github.midasflowai-labPublished by GitHub account midasflowai-labv1.0.0Updated Oct 24, 2026

Agent-native crypto market-data over MCP+REST: order flow, whales, liquidations, calibrated scores

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server giving an assistant cross-exchange crypto market data: order flow, whales, liquidations, derivatives context and calibrated scores.

What you can do
Read price history and live order books, including support/resistance levels and book imbalance for a symbol. Pull order-flow microstructure, whale prints, liquidation prints and liquidation heatmaps. Get derivatives context, market regime and phase reads, plus whole-market movers, overview and anomaly boards. Retrieve signal feeds and calibrated P(TP1) scores with coarse trade plans for a single symbol. Check realized accuracy and outcomes, and run research tools: backtests, a full AI-analyst report and a local expected-value calculator. Inspect account tier, quota, usage weights and billing.
When to use it
Useful when an assistant needs structured crypto market data and derived analytics to reason over, rather than raw exchange APIs. Suited to research and analysis workflows that want order flow, liquidation and derivatives context in one feed, or calibrated scores and backtests for a symbol.
Requirements
A remote Streamable-HTTP endpoint; no local package. A MidasFlow API key sent as an Authorization Bearer header. A paid tier is needed for real-time data and heavier calls; the free tier is lagged and limited to 200 units per day. Network access required.
Before you install
The key is a credential passed in the Authorization header; keep it out of shared configs. Paid tiers cost money monthly and calls consume weighted daily units, with the heaviest calls costing the most. Data is market data, not financial advice, and the free tier is lagged. Account and usage tools expose billing and balance information.

Installation

In SourceWeft

  1. Open Midasflow Mcp Quickstart in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.midasflowai-lab%2Fmidasflow-mcp-quickstart/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "midasflow-quickstart": {
      "type": "http",
      "url": "https://mcp.midasflow.ai/mcp"
    }
  }
}

README

MidasFlow Flow API — MCP Quickstart

Agent-native crypto market-data feed for AI agents and LLMs. Connect Claude, ChatGPT, Cursor, or any MCP-compatible agent to cross-exchange order flow, whale prints, liquidations, derivatives context, anomaly/squeeze detection, and calibrated P(TP1) scores — over a native Model Context Protocol (MCP) server or plain REST, with one Bearer key.

⚠️ Market DATA, not financial advice. And not the Flow (FLOW) blockchain — this is MidasFlow Flow API.


What it gives an agent

A single Bearer-key feed of cross-exchange crypto market DATA, shaped for an LLM to reason over:

  • Order flow — CVD, cross-exchange flow origin (where the aggression actually comes from)
  • Whale prints + multi-exchange liquidations + liquidation heatmap
  • Derivatives context — funding, open interest, basis
  • Anomalies, squeeze proximity, regime/phase context, support/resistance, sweeps
  • Calibrated P(TP1) scores + structured trade plans (size by expectancy, not vibes)
  • Realized track-record / accuracy feeds (honest win-rate with confidence bounds)

The agent discovers the full, current tool + field set itself from the keyless schema — no hardcoded parser to break:

bash
curl -s https://mcp.midasflow.ai/v1/schema | jq '.tiers, .endpoints[].path'

Connect

Claude Code / CLI (remote MCP)

bash
claude mcp add --transport http midasflow https://mcp.midasflow.ai/mcp \  --header "Authorization: Bearer mf_live_YOUR_KEY"

Claude Desktop (config)

See examples/claude_desktop_config.json. Add the midasflow block to your mcpServers and replace the key.

Any MCP client

Point it at the remote Streamable-HTTP endpoint https://mcp.midasflow.ai/mcp with header Authorization: Bearer mf_live_YOUR_KEY.

REST (no MCP client needed)

See examples/rest_quickstart.sh:

bash
# whole-market context (cheap), then a per-symbol calibrated scorecurl -s -H "Authorization: Bearer mf_live_YOUR_KEY" https://mcp.midasflow.ai/v1/marketcurl -s -H "Authorization: Bearer mf_live_YOUR_KEY" https://mcp.midasflow.ai/v1/score/BTCUSDT

Tiers (agent / API — daily weighted units)

TierPriceUnits/dayNotes
Free$0200feed ~15 min lagged; great for poking the schema
PRO$49/mo750real-time
VIP$99/mo1,500real-time + raw PUMP + per-signal edge band
Prime$199/mo8,500model scores + MFBreakout
Apex$399/mo16,600everything + priority rate-limit / queue

Each tier also includes the human-facing Telegram bot. A "unit" is a weighted cost (context calls ~1, heavy crown calls up to ~12); see GET /v1/usage for live weights.


License

The sample code in this repo is MIT (see LICENSE). The MidasFlow Flow API service itself is proprietary / commercial.


MidasFlow Flow API — market DATA for AI agents. Founded 2022. Not financial advice; not the Flow (FLOW) blockchain.

Source: README.md at commit 6fa5976

Tools

14

get_signals

Get Flow signals (live feed / elite crown)

Pull recent MidasFlow SignalEvent records (newest first). quality='normal' (default) = the bucketed signal log across source families; quality='elite' = the rare highest-conviction multi-model-consensus crown feed (premium+, lagged anti-front-run). Tier-gated + moat-scrubbed server-side. Market DATA, not advice. Routes: normal→/v1/signals/pull, elite→/v1/signals/elite.

Parameterslimitcursorsourcesymbolquality

score_symbol

Score symbol (calibrated P(TP1) + plan + safety)

CROWN data product: calibrated P(first TP1 before SL) band + coarse trade plan (TP ladder %, SL %, weights) for ONE symbol, FOLDED with a pre-trade feed-safety check (is the feed live/real-volume/fresh, no phantom ticks). Coverage is present-or-null — most symbols return p_tp1_band=null (valid, NOT an error). Feed the band into calc_ev; never read it as buy/sell. Routes: /v1/score/{symbol} + folds /v1/symbol/check as `safety`.

Parameterssymbolrequireddirectioninclude_safety

get_candles

Get OHLCV candles (price history)

Recent OHLCV candle bars for a symbol at a chosen timeframe — the raw price/volume history other tools are derived from. Inspect trend, range, volatility, volume profile, or feed your own indicators. Market DATA, not advice. A symbol outside the candle store returns an empty bars list (normal, not an error). Routes: /v1/candles/{symbol}.

Parameterstflimitsymbolrequired

get_orderbook

Get order-book snapshot (walls / imbalance + S/R)

Live order-book snapshot for a symbol — bid/ask walls, book imbalance, spread — FOLDED with support/resistance levels (classic TA fused with cross-exchange book walls + Fibonacci) so you see resting liquidity AND the level map in one call. Cross-exchange aggregate, derived levels only. Market DATA, not advice; thin/uncovered symbols return null fields (normal). Routes: /v1/orderbook/{symbol} + folds /v1/sr as `sr`.

Parameterssymbolrequiredinclude_srsr_timeframe

get_flow

Get order-flow (cvd / sweeps / cross / vpin) [grouped]

Per-symbol order-flow microstructure, grouped by `kind`. kind='vpin'/'all' (default)=full snapshot (CVD trend+divergence, VPIN toxicity, sweep state, buy/whale aggression, /v1/flow); 'cvd'=CVD series (/v1/cvd); 'sweeps'=stop-sweep events (/v1/sweeps); 'cross'=cross-exchange flow origin (/v1/cross_flow). Realtime market CONTEXT, NOT advice / a win-rate. Empty/unknown kind → a menu of kinds. VPIN is ONE contested signal — pair with get_accuracy before treating it as edge.

Parameterskindsymbol

get_heatmap

Get liquidation heatmap (price-magnet zones)

Liquidation-heatmap matrix for a symbol — price levels where leveraged positions cluster and are likely force-liquidated (price-magnet zones / liquidity pools). Anticipate where a move may accelerate or stall. Market DATA, not advice; a symbol with no clustering returns an empty matrix (normal, not an error). Routes: /v1/heatmap/{symbol}.

Parameterssymbolrequired

get_context

Get context (regime / phase / derivatives / funding / squeeze / intel) [grouped]

Contextual market reads, grouped by `kind`. kind='regime'=market-regime labels (/v1/regime, market-wide, no symbol needed); 'phase'=move-lifecycle / entry-timing for a symbol (/v1/phase, premium+); 'derivatives'=normalized cross-exchange funding/OI/basis summary (/v1/derivatives); 'funding'=PER-VENUE funding+OI (/v1/funding); 'squeeze'=liquidation-cascade proximity (/v1/squeeze); 'intel'=per-symbol aggregated signal-quality roll-up (/v1/intel). Market DATA / context, NOT advice and NOT a win-rate. Empty/unknown kind → a menu of kinds.

Parameterskindsymbol

get_whales

Get whales / liquidations (large-print intel) [grouped]

Large-player / forced-flow intel, grouped by `kind`. kind='whales' (default)=recent large ('whale') prints for a symbol, banded size+side (/v1/whales); kind='liquidations'=multi-exchange liquidation prints over a rolling window, long-liq vs short-liq notional bands per venue (/v1/liquidations; empty symbol = market-wide top movers by liq notional). Raw notional is banded. Market DATA, NOT a signal/advice. Empty/unknown kind → a menu of kinds.

Parameterskindsymbolwindowexchange

get_market

Get market board (movers / overview / anomalies) [grouped]

Whole-market reads, grouped by `kind`. kind='movers' (default)=top movers ranked (/v1/movers); 'overview'=whole-market roll-up — breadth / direction / activity (/v1/market); 'anomalies'=per-symbol or cross-market anomaly board (volume_spike/abnormal_spread/phantom_tick) with severity bands (/v1/anomalies). Cheap top-level CONTEXT to find what's MOVING before drilling into one symbol. Market DATA, NOT advice. Empty/unknown kind → a menu of kinds.

Parameterskindlimitsymbol

get_accuracy

Get accuracy / outcomes (proof of edge) [grouped]

Realized track-record (proof of edge, forward-only, Wilson-bounded), grouped by `kind`. kind='accuracy' (default)=source×boost first-TP win-rate + boost lift in the canonical TP1 frame (/v1/accuracy); kind='outcomes'=realized aggregate track-record over a window from resolved signal_outcomes, model-free (/v1/outcomes). Win-rate frame = P(price hit TP1 before SL), NOT realized PnL. Model internals never exposed. Empty/unknown kind → a menu of kinds.

Parameterskindsourcewindow

account

Account (tier / quota / balance / usage / tiers) [grouped]

Your mf_ key's account view, grouped by `kind`. kind='account' (default)=tier/product, weighted daily quota, used/remaining today, billing, prepaid balance (/v1/account); kind='usage'=today's count + cap AND the endpoint_weights map (exact per-call cost units, /v1/usage); kind='tiers'=the Flow data-product tier ladder, delivered-now vs roadmap (/v1/tiers). Read account/usage to self-throttle by your remaining quota. Empty/unknown kind → a menu of kinds.

Parameterskind

backtest

[LAB] Backtest a setup (historical P(TP1 before SL) + EV)

LAB / RESEARCH tool — replay an arbitrary {symbol, entry, tp, sl} setup over MidasFlow's 1m candle history and get its historical P(TP1-before-SL) + EV, in the canonical first-touch TP1 frame (same frame as get_accuracy). Historical market DATA, NOT a prediction or advice. Low-sample setups return a directional band (normal, not an error). NOTE: live results are gated behind ff:backtest_live — until that flips, EVERY tier gets a coming-soon envelope (no live numbers). Routes: POST /v1/backtest.

Parametersslrequiredtprequiredentryrequiredsymbolrequiredmax_hold_minlookback_days

analyze

[LAB] Analyze symbol (AI-Analyst report — heaviest)

LAB / RESEARCH tool — the full MidasFlow AI-Analyst report for a symbol: a synthesized narrative fusing flow, derivatives, levels, regime and signal context into a human-readable read RIGHT NOW. This is the HEAVIEST call (composes many sub-feeds) so it costs MORE units and requires a TOP tier; call it sparingly, AFTER cheaper context tools. Market DATA / AI-generated analytics, NOT financial advice. Routes: /v1/analyze/{symbol}.

Parameterslangsymbolrequired

calc_ev

[LAB] Calculate expected value (local analytics, no network)

LAB tool — pure local expected-value calculator over a win-rate and average win/loss percentages. No network, no advice, 0 units. Feed a get_accuracy bucket win-rate (or a score_symbol band) to reason about expectation per trade.

Parametersstake_usdavg_win_pctrequiredavg_loss_pctrequiredwin_rate_pctrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% 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 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts