io.github.midasflowai-lab/midasflow-mcp-quickstart
Agent-native crypto market-data over MCP+REST: order flow, whales, liquidations, calibrated scores
Open source Repository Open in the app JSON README (API)
About
Agent-native crypto market-data over MCP+REST: order flow, whales, liquidations, calibrated scores
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- midasflowai-lab
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-06-29T12:59:16Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:00:47
- Updated
- 2026-08-29 04:00:47
- Origin id
io.github.midasflowai-lab/midasflow-mcp-quickstart
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. - **MCP server:** `https://mcp.midasflow.ai/mcp` - **REST base:** `https://mcp.midasflow.ai/v1` - **Keyless schema (self-describing, no auth):** `https://mcp.midasflow.ai/v1/schema` - **Docs:** https://midasflow.ai/docs/api - **Get a key:** https://midasflow.ai/app/ (free tier — 200 units/day) --- ## 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`](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`](examples/rest_quickstart.sh): ```bash # whole-market context (cheap), then a per-symbol calibrated score curl -s -H "Authorization: Bearer mf_live_YOUR_KEY" https://mcp.midasflow.ai/v1/market curl -s -H "Authorization: Bearer mf_live_YOUR_KEY" https://mcp.midasflow.ai/v1/score/BTCUSDT ``` --- ## Tiers (agent / API — daily weighted units) | Tier | Price | Units/day | Notes | |---|---|---|---| | Free | $0 | 200 | feed ~15 min lagged; great for poking the schema | | PRO | $49/mo | 750 | real-time | | VIP | $99/mo | 1,500 | real-time + raw PUMP + per-signal edge band | | Prime | $199/mo | 8,500 | model scores + MFBreakout | | Apex | $399/mo | 16,600 | everything + 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`](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.*