Skip to content

moomooopen/moomoo-mcp

v1.0.0MIT

moomoo MCP plugin — quotes, stock screening, news, and trading

moomoo MCP Plugin

All-in-one MCP plugin for moomoo — quotes, stock screening, news, and trading. Compatible with Claude Code, Cursor, Codex, and the Agent Plugins open standard.

Directory Structure

moomoo-agent-plugin/
├── plugin.json                        # Agent Plugins open standard manifest
├── mcp.json                           # Cursor MCP config
├── .mcp.json                          # Codex / Claude Code MCP config
├── assets/
│   └── moomoo.png                     # Plugin icon
├── .claude-plugin/
│   ├── plugin.json                    # Claude Code plugin manifest
│   └── marketplace.json               # Claude Code marketplace registration
├── .cursor-plugin/
│   ├── plugin.json                    # Cursor plugin manifest
│   └── marketplace.json               # Cursor Team Marketplace registration
├── .codex-plugin/
│   └── plugin.json                    # Codex plugin manifest
├── .agents/plugins/
│   └── marketplace.json               # Codex marketplace registration
└── skills/
    ├── moomoo-mcp-quote/
    │   ├── SKILL.md                   # Quotes: prices / K-lines / order book / time & sales / sectors / watchlist
    │   └── reference/
    │       ├── quote-realtime.md      # Real-time quote reference
    │       ├── quote-tick.md          # Tick-by-tick / time-sharing reference
    │       └── quote-watchlist.md     # Watchlist / sector reference
    ├── moomoo-mcp-screen/
    │   ├── SKILL.md                   # Screening: stocks / warrants / options / IPO
    │   └── reference/
    │       ├── quote-screening.md     # Stock screening reference
    │       ├── quote-options.md       # Option screening reference
    │       └── quote-futures-warrants.md  # Futures / warrant reference
    ├── moomoo-mcp-news/
    │   ├── SKILL.md                   # Research: news / financials / valuation / shareholders / capital flow
    │   └── reference/
    │       ├── quote-news.md          # News / community / feeds reference
    │       ├── quote-financials.md    # Financial statements reference
    │       ├── quote-research.md      # Research / ratings reference
    │       ├── quote-shareholders.md  # Shareholder holdings reference
    │       ├── quote-capital.md       # Capital flow reference
    │       ├── quote-corporate-actions.md  # Corporate actions reference
    │       └── quote-short-broker.md  # Short selling / broker reference
    └── moomoo-mcp-account/
        ├── SKILL.md                   # Trading: real / simulated orders / positions / funds
        └── reference/
            ├── trading-real.md        # Real trading reference
            ├── trading-real-order.md  # Real order placement reference
            └── trading-sim.md         # Simulated trading reference

Platform Compatibility

PlatformManifestMCP ConfigMarketplace
Claude Code.claude-plugin/plugin.json.mcp.json.claude-plugin/marketplace.json
Cursor.cursor-plugin/plugin.jsonmcp.json.cursor-plugin/marketplace.json
Codex.codex-plugin/plugin.json.mcp.json.agents/plugins/marketplace.json
Agent PluginsRoot plugin.jsonmcp.json—

Each platform reads its own manifest and MCP config independently — no conflicts. The skills/ directory is shared across all platforms with an identical format.

MCP Server

All platforms connect to the same remote MCP service:

https://mcp.moomoo.com/mcp

Protocol: Streamable HTTP (Claude Code / Cursor) / HTTP (Codex)

Installation

Claude Code

/plugin marketplace add MoomooOpen/moomoo-agent-plugin

Or submit via the plugin directory submission.

Cursor

In Dashboard → Plugins → Add Marketplace, enter the repository URL:

https://github.com/MoomooOpen/moomoo-agent-plugin.git

Cursor automatically reads .cursor-plugin/marketplace.json.

Codex

codex plugin marketplace add MoomooOpen/moomoo-agent-plugin

Agent Plugins

Any tool supporting the Agent Plugins standard can discover the plugin via the root plugin.json.

Features

Market Data (moomoo-mcp-quote)

  • Real-time quotes, market snapshots
  • Daily / weekly / monthly / minute K-lines
  • Order book depth (LV1 / LV2)
  • Time-sharing charts, tick-by-tick trades
  • Market state, trading calendar
  • Watchlist management, sector constituents

Stock Screening (moomoo-mcp-screen)

  • Multi-factor stock screening (valuation / price change / financials / technical patterns / holdings — 120+ dimensions)
  • Warrant / CBBC screening
  • Option screener
  • IPO listings for HK / US / A-share / SG / MY markets

Research & News (moomoo-mcp-news)

  • News / announcements / research report search
  • Economic calendar (hot events + search)
  • Financial statements, revenue breakdown
  • PE / PB / PS valuation analysis
  • Analyst ratings, Morningstar reports
  • Shareholder / institutional / insider holdings
  • Capital flow, short selling data
  • Option chain / volatility / exercise probability

Account & Trading (moomoo-mcp-account)

  • Real trading: place / modify / cancel orders with risk-control confirmation
  • Simulated trading: full simulated trading workflow
  • Account funds, position queries
  • Multi-market support (HK / US / A-share / SG / JP / CA / Futures / Options)

Supported Markets

CodeMarket
HKHong Kong
USUnited States
SH / SZChina A-shares
SGSingapore
JPJapan
CACanada
AUAustralia
MYMalaysia
KRSouth Korea

How It Works

  1. When the IDE / CLI starts, it scans the corresponding marketplace or plugin manifest
  2. Discovers the moomoo-mcp plugin and pulls it via git from https://github.com/MoomooOpen/moomoo-agent-plugin.git
  3. The user sees it in the plugin directory and can install / enable it
  4. Once installed, loads the MCP config, connects to https://mcp.moomoo.com/mcp, and loads skills

Marketplace Configuration

Claude Code (.claude-plugin/marketplace.json)

  • plugins[].source — Pulled via git URL: https://github.com/MoomooOpen/moomoo-agent-plugin.git
  • Plugin is enabled via /plugin install or settings.json

Codex (.agents/plugins/marketplace.json)

  • source: "git-subdir" — Pulls the repo via git; path: "./" points to the repo root; ref: "main" specifies the branch
  • installation: "AVAILABLE" — User can choose to install
  • authentication: "ON_INSTALL" — Triggers OAuth authentication on install

Cursor (.cursor-plugin/marketplace.json)

  • plugins[].source — Pulled via git URL: https://github.com/MoomooOpen/moomoo-agent-plugin.git
  • metadata.pluginRoot: "." — Plugin root is the repository root

License

MIT