Bde Score

io.github.hbhqq9Published by GitHub account hbhqq9v1.27.1Updated Oct 24, 2026

7-factor stock scoring MCP server. US/HK/CN, 74 stocks. Free + Premium (USDC/Base). x402 ready.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server that gives an assistant 7-factor quantitative stock scores, screening and sector/ESG analysis for 73 US, Hong Kong and A-share stocks.

What you can do
  • Score stocks: composite 0-100 BDE scores with a 7-factor breakdown for a whole market or a single stock, including signal classification and price context.
  • Compare and screen: compare one company's scores across US, HK and CN listings, and rank stocks by a minimum score threshold.
  • Aggregate by sector: average scores, sector rankings and relative strength.
  • Review ESG: per-stock environmental, social and governance analysis with compliance metadata.
When to use it
Useful when you want an assistant to pull comparable, explainable technical scores for a fixed universe of large-cap US, Hong Kong and mainland Chinese stocks, or to screen and rank that universe by score inside a chat.
Requirements
A remote Streamable HTTP endpoint; the README's client configuration also sends an X-API-Key header. The free tier allows 3 tool calls per day; higher tiers are paid. A local stdio variant is described that needs Python with the mcp and httpx packages, or Node.js for the plugin.
Before you install
The README's endpoint URL differs from the one in the manifest, so confirm which address is current. Paid tiers are billed in USDC on the Base chain via the x402 payment protocol, which involves a crypto wallet and real spending. An API key is passed in a header. Scores are technical analysis, not financial advice, and the universe is limited to the listed stocks.

Installation

In SourceWeft

  1. Open Bde Score 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.hbhqq9%2Fbde-score/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": {
    "bde-score": {
      "type": "http",
      "url": "https://fantasy-bald-shark-stereo.trycloudflare.com/mcp"
    }
  }
}

README

📊 BDE Score™ — MCP Server

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

[MCP Server] [MCP Registry] [EU AI Act] [License]

🤖 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:

ToolDescription
get_bde_scoreGet BDE composite scores (0-100) for all stocks in a market (US/HK/CN/ALL). Returns 7-factor breakdown: VIX, Volume Profile, Momentum, Mean Reversion, Volume, Volatility, Trend.
get_stock_analysisDetailed single-stock analysis with factor-by-factor breakdown, signal classification (Bullish/Neutral/Bearish), and price context.
get_multi_market_comparisonCompare the same company's scores across US, HK, and CN markets (e.g., compare BYD on NASDAQ vs HK vs Shenzhen).
get_stock_screenerScreen stocks by minimum BDE score threshold. Returns ranked list of stocks meeting criteria.
get_sector_analysisSector-level aggregation: average scores per sector, sector rankings, and relative strength.
get_esg_analysisESG (Environmental, Social, Governance) analysis per stock with compliance metadata.

Tool Input/Output Example

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

json
{  "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

json
{  "mcpServers": {    "bde-score": {      "url": "https://unnecessary-concert-gets-jose.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:

json
{  "mcpServers": {    "bde-score": {      "url": "https://unnecessary-concert-gets-jose.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:

python
from mcp import ClientSessionfrom mcp.client.streamable_http import streamablehttp_client
async with streamablehttp_client("https://unnecessary-concert-gets-jose.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:

bash
pip install mcp httpxcd mcp/python mcp_http_server.py

Then configure your MCP client to use stdio:

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

💰 Pricing

TierPriceAccess
Free$03 MCP tool calls/day
Premium$29/moUnlimited MCP calls + 365-day history
Institutional$199/moCustom universe + compliance reports + SLA

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:

EndpointURL
MCP Serverhttps://unnecessary-concert-gets-jose.trycloudflare.com/mcp
.well-known/mcp.jsonhttps://hbhqq9.github.io/bde-score/.well-known/mcp.json
.well-known/agent.jsonhttps://hbhqq9.github.io/bde-score/.well-known/agent.json
.well-known/agent-card.jsonhttps://hbhqq9.github.io/bde-score/.well-known/agent-card.json
.well-known/security.txthttps://hbhqq9.github.io/bde-score/.well-known/security.txt
.well-known/ai-trust.txthttps://hbhqq9.github.io/bde-score/.well-known/ai-trust.txt
Dashboardhttps://hbhqq9.github.io/bde-score/

🛠 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:

bash
cd claude-code-plugin/plugins/mcp/bde-scorenpm installnpm start

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

Local tools:

ToolDescription
score_stockScore a single stock using 7-factor composite model
batch_scoreScore multiple stocks in one call with ranked results
top_performersGet top N performing stocks from a watchlist
worst_performersGet worst N performing stocks from a watchlist
market_overviewGet overall market sentiment including VIX level

⚠️ 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 [email protected].
  • 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

Source: README.md at commit 3ca858f

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.27.1LatestSep 16, 2026

Score

40% 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

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 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

    Declare a license in the repository or the registry entry.