Spaces:
Sleeping
Sleeping
docs: Fix field names in mcp_data_structure.md to match implementation
Browse files- macro-basket: cpi_yoy → cpi_inflation, unemployment_rate → unemployment,
fed_funds_rate → interest_rate
- valuation-basket: price_to_book → pb_ratio, price_to_sales → ps_ratio
- Added notes explaining field meanings and fallback behavior
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- docs/mcp_data_structure.md +24 -15
docs/mcp_data_structure.md
CHANGED
|
@@ -60,19 +60,26 @@ Output schemas for all MCP basket servers.
|
|
| 60 |
"yahoo_finance": {
|
| 61 |
"current_price": {"value": 175.50, "as_of": "2024-10-31"},
|
| 62 |
"trailing_pe": {"value": 28.5, "as_of": "2024-10-31"},
|
| 63 |
-
"forward_pe": {
|
| 64 |
-
"peg_ratio": {
|
| 65 |
-
"
|
| 66 |
-
"
|
| 67 |
-
"dividend_yield": {
|
| 68 |
-
"52_week_high": {...},
|
| 69 |
-
"52_week_low": {...}
|
| 70 |
},
|
| 71 |
"alpha_vantage": {
|
|
|
|
|
|
|
|
|
|
|
|
|
| 72 |
"ev_ebitda": {"value": 22.3, "as_of": "2024-10-31"}
|
| 73 |
}
|
| 74 |
```
|
| 75 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 76 |
---
|
| 77 |
|
| 78 |
## volatility-basket
|
|
@@ -95,21 +102,23 @@ Output schemas for all MCP basket servers.
|
|
| 95 |
|
| 96 |
```python
|
| 97 |
"bea": {
|
| 98 |
-
"gdp_growth": {"value": 2.8, "
|
| 99 |
},
|
| 100 |
"bls": {
|
| 101 |
-
"
|
| 102 |
-
"
|
| 103 |
-
"nonfarm_payrolls": {...}
|
| 104 |
},
|
| 105 |
"fred": {
|
| 106 |
-
"
|
| 107 |
-
"treasury_10y": {"value": 4.25, "as_of": "2024-10-31"},
|
| 108 |
-
"treasury_2y": {...},
|
| 109 |
-
"yield_curve_spread": {...}
|
| 110 |
}
|
| 111 |
```
|
| 112 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 113 |
---
|
| 114 |
|
| 115 |
## news-basket
|
|
|
|
| 60 |
"yahoo_finance": {
|
| 61 |
"current_price": {"value": 175.50, "as_of": "2024-10-31"},
|
| 62 |
"trailing_pe": {"value": 28.5, "as_of": "2024-10-31"},
|
| 63 |
+
"forward_pe": {"value": 25.2, "as_of": "2024-10-31"},
|
| 64 |
+
"peg_ratio": {"value": 1.8, "as_of": "2024-10-31"},
|
| 65 |
+
"pb_ratio": {"value": 45.3, "as_of": "2024-10-31"},
|
| 66 |
+
"ps_ratio": {"value": 7.5, "as_of": "2024-10-31"},
|
| 67 |
+
"dividend_yield": {"value": 0.5, "as_of": "2024-10-31"}
|
|
|
|
|
|
|
| 68 |
},
|
| 69 |
"alpha_vantage": {
|
| 70 |
+
"trailing_pe": {"value": 28.5, "as_of": "2024-10-31"},
|
| 71 |
+
"forward_pe": {"value": 25.0, "as_of": "2024-10-31"},
|
| 72 |
+
"pb_ratio": {"value": 45.0, "as_of": "2024-10-31"},
|
| 73 |
+
"ps_ratio": {"value": 7.4, "as_of": "2024-10-31"},
|
| 74 |
"ev_ebitda": {"value": 22.3, "as_of": "2024-10-31"}
|
| 75 |
}
|
| 76 |
```
|
| 77 |
|
| 78 |
+
**Notes:**
|
| 79 |
+
- `pb_ratio` = Price-to-Book ratio
|
| 80 |
+
- `ps_ratio` = Price-to-Sales ratio (TTM)
|
| 81 |
+
- Alpha Vantage provides fallback for all metrics if Yahoo fails
|
| 82 |
+
|
| 83 |
---
|
| 84 |
|
| 85 |
## volatility-basket
|
|
|
|
| 102 |
|
| 103 |
```python
|
| 104 |
"bea": {
|
| 105 |
+
"gdp_growth": {"value": 2.8, "data_type": "Quarterly", "as_of": "2024-09-30"}
|
| 106 |
},
|
| 107 |
"bls": {
|
| 108 |
+
"cpi_inflation": {"value": 3.2, "data_type": "Monthly", "as_of": "2024-10-31"},
|
| 109 |
+
"unemployment": {"value": 3.8, "data_type": "Monthly", "as_of": "2024-10-31"}
|
|
|
|
| 110 |
},
|
| 111 |
"fred": {
|
| 112 |
+
"interest_rate": {"value": 5.33, "data_type": "Monthly", "as_of": "2024-10-31"}
|
|
|
|
|
|
|
|
|
|
| 113 |
}
|
| 114 |
```
|
| 115 |
|
| 116 |
+
**Notes:**
|
| 117 |
+
- `cpi_inflation` = Year-over-year CPI inflation rate (%)
|
| 118 |
+
- `unemployment` = Unemployment rate (%)
|
| 119 |
+
- `interest_rate` = Federal Funds Effective Rate (%)
|
| 120 |
+
- FRED provides fallbacks for GDP, CPI, unemployment if BEA/BLS fail
|
| 121 |
+
|
| 122 |
---
|
| 123 |
|
| 124 |
## news-basket
|