MCP Server for calculating WorldQuant 101 Alpha factors using Tushare data
The server provides a single well-defined tool with a clear verb-based name and comprehensive input schema. The tool description is detailed and domain-specific, explaining what WorldQuant Alpha factors are calculated and when to use them. The input schema includes all required parameters with proper type definitions and descriptions. However, the output schema is not formally documented in the tool registration, it is inferred from the AlphaResult interface in the implementation code. This gap prevents a higher score. The tool is READ_ONLY and domain-focused, which is appropriate for a quantitative finance tool. No error handling guidance is visible in the tool definition itself.
Calculate WorldQuant Alpha factors (Alpha3, Alpha13, Alpha15, Alpha16, Alpha44, Alpha50, Alpha55) for a given stock and date range. Returns factor values and trading signals based on percentile analysis.
Output schema not formally documented in tool definition. The AlphaResult interface exists in code, but the tool registration does not specify the structure of returned data (dates, values, currentValue, mean, std, percentile). LLMs cannot plan downstream operations without knowing what fields to extract.
No error handling or recovery guidance in tool description. The description does not explain what happens if the stock code is invalid, the date range is empty, or Tushare API is unavailable. LLMs need actionable error strategies.
No pagination or result limiting mentioned. If historical data for a single stock over 10 years is requested, the response could be extremely large. No guidance on data volume limits or how to handle large result sets.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 9 | <=2025-11-25 | v2 |
| 2026-03-09 | C | 65 | 2024-11-05+ | v1 |
Date format constraint (YYYYMMDD) is mentioned in parameter description, but no regex pattern or formal length constraint is present in the schema itself. The description text is the only guide for LLMs.