Model Context Protocol · live

SoSoFlows MCP Server

Bring the SoSoFlows agentic ETF-flow analyst into any MCP client · Claude Desktop, Cursor, Claude Code, or your own agent. Seven tools that turn SoSoValue spot-ETF data into a composite conviction signal, a cross-asset regime read, and a ready-to-sign SoDEX order envelope.

View source on GitHub → README

Seven tools

Each is a typed MCP tool over stdio transport. Smoke-tested 7/7 against a real MCP client.

get_etf_flows

Recent daily spot-ETF net inflow rows for an asset (BTC, ETH, SOL, XRP, ...). US or HK.

get_etf_signal

The SoSoFlows composite conviction score 0-100, LONG/SHORT/HOLD verdict, 5-factor breakdown, streak, z-score anomaly.

get_cohort_regime

Classifies the cross-asset regime risk-on / risk-off / mixed with a confidence score across BTC, ETH, SOL, XRP.

compare_etf_signals

Side-by-side conviction signals for 2 to 6 assets, ranked.

list_indices

SoSoValue SSI on-chain index tickers.

build_sodex_order_envelope

Prepares a SoDEX order as a complete EIP-712 typed-data envelope (ValueChain chainId 138565) for you to sign in your own wallet. Never signs or submits.

about

Server info, key status, and the live SoSoFlows surfaces.

The signal model

A 0-100 composite from five weighted factors · the same engine that powers the dashboard, reimplemented as pure functions.

direction 30% momentum 25% consistency 20% magnitude 15% cumulative trend 10%

Plus streak detection and a z-score anomaly flag (more than 2 sigma from the 14-day mean).

Wire into Claude Desktop

BYOK · set your SoSoValue OpenAPI key to hit live data. Without a key it runs in demo mode against a bundled snapshot, so every tool still returns a sensible result.

{
  "mcpServers": {
    "sosoflows": {
      "command": "node",
      "args": ["/absolute/path/to/sosoflows/mcp/src/index.js"],
      "env": { "SOSO_API_KEY": "SOSO-xxxx" }
    }
  }
}

Then ask your assistant:

"What is the BTC ETF signal right now?"
"Is the crypto cohort risk-on or risk-off?"
"Compare the ETF signals for BTC, ETH, SOL and XRP."
"Build a SoDEX buy envelope for 250 dollars of ETH."

Live API verified. The server hits openapi.sosovalue.com live with a key (verified working, real flow data) and falls back to a cached snapshot when no key is set, respecting the SoSoValue Demo plan rate limit with a 6-hour cache. Built on the official @modelcontextprotocol/sdk v1, stdio transport.