📊 BDE Score™ — MCP Server

AI-Powered Multi-Market Stock Analysis via Model Context Protocol

🤖 What is BDE Score™?

BDE Score™ is an MCP (Model Context Protocol) Server that gives AI agents direct access to transparent, multi-factor quantitative stock scoring across US, HK, and A-share markets.

It is not a REST API wrapper — it is a native MCP server built with the MCP SDK that exposes structured tools, each returning explainable 7-factor scores.

73 stocks · 3 markets · 6 MCP tools · One comparable score per stock.

🔧 MCP Tools

BDE Score exposes 6 MCP tools that AI agents can call directly:

Tool Input/Output Example

Tool: get_bde_score Input: { "market": "US" } Output:

{
  "AAPL": { "bde_score": 72, "signal": "BULLISH", "factors": { "momentum": 85, "volatility": 68, ... } },
  "NVDA": { "bde_score": 81, "signal": "BULLISH", "factors": { ... } }
}

🚀 Quick Setup

Claude Desktop

Add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bde-score": {
      "url": "https://enjoying-wide-boat-stan.trycloudflare.com.trycloudflare.com/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop. BDE Score tools will appear in the tool list.

Cursor IDE

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "bde-score": {
      "url": "https://enjoying-wide-boat-stan.trycloudflare.com.trycloudflare.com/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

Any MCP Client (Streamable HTTP)

BDE Score uses the Streamable HTTP transport (MCP protocol). Connect from any MCP-compatible client:

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("https://enjoying-wide-boat-stan.trycloudflare.com.trycloudflare.com/mcp") as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        result = await session.call_tool("get_bde_score", {"market": "US"})
        print(result)

Local (stdio transport)

For local development without network:

pip install mcp httpx
cd mcp/
python mcp_http_server.py

Then configure your MCP client to use stdio:

{
  "mcpServers": {
    "bde-score": {
      "command": "python",
      "args": ["mcp/mcp_http_server.py"]
    }
  }
}

💰 Pricing

Payment: USDC on Base chain (x402 payment protocol supported)

🌏 Coverage

US Market (25 stocks)

AAPL, MSFT, GOOG, AMZN, META, NVDA, AMD, AVGO, ARM, INTC, V, MA, JNJ, UNH, LLY, PFE, PG, KO, WMT, MCD, TSLA, NFLX, BABA, SPY, QQQ

HK Market (26 stocks)

00700 (Tencent), 09988 (Alibaba), 09888 (Baidu), 03690 (Meituan), 01024 (Kuaishou), 01810 (Xiaomi), 09618 (JD), 09999 (NetEase), 02015 (Li Auto), 09868 (XPeng), 01211 (BYD), 09863 (Leapmotor), 02318 (Ping An), 01398 (ICBC), 00939 (CCB), 03988 (BOC), 02628 (China Life), 02899 (Zijin Mining), 00883 (CNOOC), 00857 (PetroChina), 01088 (China Shenhua), 00941 (China Mobile), 00728 (China Telecom), 00762 (China Unicom), 01833 (Ping An Good Doctor), 02269 (WuXi Biologics)

A-Share Market (23 stocks, CN prefix)

SH600519 (Moutai), SZ000858 (Wuliangye), SZ000568 (Luzhou Laojiao), SH600887 (Yili), SZ002714 (Muyuan), SH601318 (Ping An), SH600036 (CMB), SH601398 (ICBC), SH601288 (ABC), SZ300750 (CATL), SH601012 (LONGi), SZ002594 (BYD-A), SH600900 (Yangtze Power), SH688981 (SMIC), SZ002475 (Luxshare), SZ002230 (iFlytek), SH603501 (Will Semi), SH601899 (Zijin-A), SH601088 (China Shenhua), SH600585 (Conch Cement), SZ000333 (Midea), SH600690 (Haier), SZ000651 (Gree)

🔒 EU AI Act Art.50 Compliance

BDE Score™ is compliance-first by design. When Art.50 takes effect on August 2, 2026, our MCP server is already ready:

• ✅ AGL Receipt Schema v2.0 — every MCP tool call generates an immutable, drift-aware receipt
• ✅ Full audit trails — every score decision logged with factor weights and timestamps
• ✅ Explainable methodology — transparent 7-factor breakdown per stock, embedded in every tool response
• ✅ Machine-readable metadata — JSON compliance data in .well-known/ai-trust.txt and receipt responses
• ✅ Identity disclosure — AGL identity markers in all MCP response headers

78% of AI system operators have NOT taken Art.50 compliance measures yet (April 2026 data). BDE Score™ closes this gap — the only open-source MCP server with built-in regulatory compliance.

📡 Discovery Endpoints

BDE Score implements standard agent discovery protocols:

🛠 Tech Stack

• MCP Protocol: Streamable HTTP transport via Cloudflare Tunnel
• MCP SDK: Python mcp package (FastMCP) + @modelcontextprotocol/sdk (TypeScript)
• Scoring Engine: 7-factor model (VIX, Volume Profile, RSI, MACD, Bollinger, OBV, ATR)
• Data: FutuOpenD (primary) + Sina Finance (fallback) + Yahoo Finance (JS plugin)
• Security: API Key auth, rate limiting, x402 payment protocol, AGL Receipt Schema v2.0
• Governance: EU AI Act Art.50 compliant, AGL identity markers

📦 Claude Code Plugin (Local)

For Claude Code users who prefer a local, self-contained MCP plugin:

cd claude-code-plugin/plugins/mcp/bde-score
npm install
npm start

This runs the BDE scoring engine locally via stdio transport — no network required, no API keys needed for the local plugin.

Local tools:

⚠️ Disclaimer

BDE Score™ is a technical analysis tool, NOT financial advice. All investment decisions should be made independently. Past performance does not guarantee future results. This service does not provide investment suitability assessments.

📄 License

Dual License — AGPL-3.0 / Commercial

• Open Source: Licensed under AGPL-3.0. Network use requires source disclosure.
• Commercial License: For proprietary deployment (SaaS, enterprise, embedded), contact nnhbh@foxmail.com.
• EU AI Act Compliance: BDE Score™ includes native Article 50 transparency markers — the only open-source MCP server with built-in regulatory compliance.

BDE Score™ — MCP-Native. Multi-Market. Compliance-Ready.
Dashboard · GitHub · MCP Registry