Local-first investment judgment companion for A-share, US, Korean, and cross-asset research with MCP tool interface
14 tools with complete JSON schemas and descriptions, but quality is uneven. All tools are READ_ONLY and follow verb_noun naming (get_*, search_*). Descriptions average ~80 chars, below the 194-char baseline for A+ tools. Parameters have types but many lack depth, e.g., 'as_of' appears in 13 tools with identical minimal description. No output schemas documented. Error handling and recovery guidance absent. Tool composition is sound (each does one thing), but descriptions don't explain WHEN to use each tool vs. similar ones (e.g., a_share_get_snapshot vs. a_share_get_capital_snapshot). No tool annotations (readOnlyHint, idempotentHint) despite all being read-only.
Get A-share capital snapshot with configurable metrics including daily flow, margin, shareholder count, chip distribution, unlock, and dividend
Get A-share company operating metrics with configurable lookback, document limit, and metric codes
Get A-share ETF option snapshot with required options data
Get A-share financial statements with configurable statement types, periods, and metric codes
Get A-share industry cycle analysis with configurable lookback, view, metrics, and pagination
Get A-share limit-up context with optional sentiment data
Get A-share market structure data including instrument bars, book ticks, and market industry context
No output schemas documented. LLMs cannot plan downstream calls or extract fields without knowing response structure. All 14 tools lack return type documentation.
Descriptions lack differentiation and WHEN-to-use guidance. 13 tools share identical 'as_of' parameter description. No guidance on when to call a_share_get_snapshot vs. a_share_get_capital_snapshot vs. a_share_get_sentiment_snapshot.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Get A-share sentiment snapshot with optional interactive QA and news data
Get A-share composite snapshot including market quote, fundamentals, announcements, news, and corporate actions
Get cross-asset market bars with configurable interval, adjustment method, and offer side
Get cross-asset market context including US market, futures curve, and spot/future basis
Get cross-asset market snapshot for US equity/index/futures, CME contracts, OTC commodity spot/CFD
Get batch market snapshots for multiple instruments with per-instrument typed results
Search research reports with optional research report data
No error handling or recovery guidance. Tools provide no documentation of failure modes, retryability, or what to do if a lookup fails (e.g., instrument_id not found).
No tool annotations despite all tools being read-only. Missing readOnlyHint and idempotentHint annotations that would help agents understand retry safety and side-effect profile.
Parameter descriptions are minimal (avg ~20 chars). 'Pagination offset' and 'Pagination limit' lack context on valid ranges, defaults, or behavior when out of bounds.