superkit-mcp-server 1.0.2 → 1.1.0

package/skills/tech/alpha-vantage/references/technical-indicators.md

@@ -0,0 +1,374 @@
+# Technical Indicators APIs
+
+All technical indicators work with equities, forex pairs, and crypto. Calculated from adjusted time series data.
+
+## Common Parameters
+
+| Parameter | Required | Values |
+|-----------|----------|--------|
+| `symbol` | Yes | Ticker (e.g., `IBM`), forex pair (`USDEUR`), or crypto pair (`BTCUSD`) |
+| `interval` | Yes | `1min`, `5min`, `15min`, `30min`, `60min`, `daily`, `weekly`, `monthly` |
+| `time_period` | Most | Number of periods (e.g., `14`, `20`, `50`, `200`) |
+| `series_type` | Most | `close`, `open`, `high`, `low` |
+| `month` | No | `YYYY-MM` for specific historical month |
+| `datatype` | No | `json` or `csv` |
+
+## Response Format
+
+All indicators return a metadata object and a time series dictionary:
+
+```python
+data = av_get("SMA", symbol="IBM", interval="daily", time_period=20, series_type="close")
+ts = data["Technical Analysis: SMA"]
+# Key: "2024-01-15" → {"SMA": "185.4200"}
+```
+
+## Moving Averages
+
+### SMA — Simple Moving Average
+
+```python
+data = av_get("SMA", symbol="AAPL", interval="daily", time_period=20, series_type="close")
+ts = data["Technical Analysis: SMA"]
+print(sorted(ts.keys())[-1], ts[sorted(ts.keys())[-1]]["SMA"])
+```
+
+### EMA — Exponential Moving Average
+
+```python
+data = av_get("EMA", symbol="AAPL", interval="daily", time_period=20, series_type="close")
+ts = data["Technical Analysis: EMA"]  # → {"EMA": "..."}
+```
+
+### WMA — Weighted Moving Average
+
+```python
+data = av_get("WMA", symbol="IBM", interval="daily", time_period=20, series_type="close")
+ts = data["Technical Analysis: WMA"]  # → {"WMA": "..."}
+```
+
+### DEMA — Double Exponential Moving Average
+
+```python
+data = av_get("DEMA", symbol="IBM", interval="daily", time_period=20, series_type="close")
+ts = data["Technical Analysis: DEMA"]
+```
+
+### TEMA — Triple Exponential Moving Average
+
+```python
+data = av_get("TEMA", symbol="IBM", interval="daily", time_period=20, series_type="close")
+ts = data["Technical Analysis: TEMA"]
+```
+
+### KAMA — Kaufman Adaptive Moving Average
+
+```python
+data = av_get("KAMA", symbol="IBM", interval="daily", time_period=20, series_type="close")
+ts = data["Technical Analysis: KAMA"]
+```
+
+### T3 — Triple Smooth Exponential Moving Average
+
+```python
+data = av_get("T3", symbol="IBM", interval="daily", time_period=5, series_type="close")
+ts = data["Technical Analysis: T3"]
+```
+
+### VWAP — Volume Weighted Average Price (Premium, intraday only)
+
+**Required:** `symbol`, `interval` (intraday only: `1min`–`60min`)
+
+```python
+data = av_get("VWAP", symbol="AAPL", interval="5min")
+ts = data["Technical Analysis: VWAP"]  # → {"VWAP": "..."}
+```
+
+---
+
+## Momentum Indicators
+
+### MACD — Moving Average Convergence/Divergence (Premium)
+
+**Optional:** `fastperiod` (default 12), `slowperiod` (default 26), `signalperiod` (default 9), `series_type`
+
+```python
+data = av_get("MACD", symbol="AAPL", interval="daily", series_type="close",
+              fastperiod=12, slowperiod=26, signalperiod=9)
+ts = data["Technical Analysis: MACD"]
+latest_date = sorted(ts.keys())[-1]
+print(ts[latest_date])  # {"MACD": "...", "MACD_Signal": "...", "MACD_Hist": "..."}
+```
+
+### RSI — Relative Strength Index
+
+```python
+data = av_get("RSI", symbol="AAPL", interval="daily", time_period=14, series_type="close")
+ts = data["Technical Analysis: RSI"]  # → {"RSI": "..."}
+# Overbought >70, Oversold <30
+latest_date = sorted(ts.keys())[-1]
+print(f"RSI: {ts[latest_date]['RSI']}")
+```
+
+### STOCH — Stochastic Oscillator
+
+**Optional:** `fastkperiod` (default 5), `slowkperiod` (default 3), `slowdperiod` (default 3), `slowkmatype`, `slowdmatype`
+
+```python
+data = av_get("STOCH", symbol="IBM", interval="daily")
+ts = data["Technical Analysis: STOCH"]  # → {"SlowK": "...", "SlowD": "..."}
+```
+
+### STOCHF — Stochastic Fast
+
+```python
+data = av_get("STOCHF", symbol="IBM", interval="daily")
+ts = data["Technical Analysis: STOCHF"]  # → {"FastK": "...", "FastD": "..."}
+```
+
+### STOCHRSI — Stochastic Relative Strength Index
+
+```python
+data = av_get("STOCHRSI", symbol="IBM", interval="daily", time_period=14, series_type="close")
+ts = data["Technical Analysis: STOCHRSI"]  # → {"FastK": "...", "FastD": "..."}
+```
+
+### WILLR — Williams %R
+
+```python
+data = av_get("WILLR", symbol="IBM", interval="daily", time_period=14)
+ts = data["Technical Analysis: WILLR"]  # → {"WILLR": "..."}
+```
+
+### MOM — Momentum
+
+```python
+data = av_get("MOM", symbol="IBM", interval="daily", time_period=10, series_type="close")
+ts = data["Technical Analysis: MOM"]
+```
+
+### ROC — Rate of Change
+
+```python
+data = av_get("ROC", symbol="IBM", interval="daily", time_period=10, series_type="close")
+ts = data["Technical Analysis: ROC"]
+```
+
+### CCI — Commodity Channel Index
+
+**Required:** `symbol`, `interval`, `time_period` (no `series_type`)
+
+```python
+data = av_get("CCI", symbol="IBM", interval="daily", time_period=20)
+ts = data["Technical Analysis: CCI"]
+```
+
+### CMO — Chande Momentum Oscillator
+
+```python
+data = av_get("CMO", symbol="IBM", interval="daily", time_period=14, series_type="close")
+ts = data["Technical Analysis: CMO"]
+```
+
+### PPO — Percentage Price Oscillator
+
+**Optional:** `fastperiod`, `slowperiod`, `matype`
+
+```python
+data = av_get("PPO", symbol="IBM", interval="daily", series_type="close")
+ts = data["Technical Analysis: PPO"]
+```
+
+### BOP — Balance of Power
+
+**Required:** `symbol`, `interval` (no `time_period` or `series_type`)
+
+```python
+data = av_get("BOP", symbol="IBM", interval="daily")
+ts = data["Technical Analysis: BOP"]
+```
+
+---
+
+## Trend Indicators
+
+### ADX — Average Directional Movement Index
+
+**Required:** `symbol`, `interval`, `time_period` (no `series_type`)
+
+```python
+data = av_get("ADX", symbol="IBM", interval="daily", time_period=14)
+ts = data["Technical Analysis: ADX"]  # → {"ADX": "..."}
+# ADX > 25 = strong trend
+```
+
+### AROON — Aroon
+
+**Required:** `symbol`, `interval`, `time_period` (no `series_type`)
+
+```python
+data = av_get("AROON", symbol="IBM", interval="daily", time_period=25)
+ts = data["Technical Analysis: AROON"]  # → {"Aroon Down": "...", "Aroon Up": "..."}
+```
+
+### BBANDS — Bollinger Bands
+
+**Optional:** `nbdevup` (default 2), `nbdevdn` (default 2), `matype` (default 0=SMA)
+
+```python
+data = av_get("BBANDS", symbol="AAPL", interval="daily", time_period=20,
+              series_type="close", nbdevup=2, nbdevdn=2)
+ts = data["Technical Analysis: BBANDS"]
+latest = ts[sorted(ts.keys())[-1]]
+print(latest["Real Upper Band"], latest["Real Middle Band"], latest["Real Lower Band"])
+```
+
+### SAR — Parabolic SAR
+
+**Optional:** `acceleration` (default 0.01), `maximum` (default 0.20)
+
+```python
+data = av_get("SAR", symbol="IBM", interval="daily")
+ts = data["Technical Analysis: SAR"]
+```
+
+---
+
+## Volume Indicators
+
+### OBV — On Balance Volume
+
+**Required:** `symbol`, `interval` (no `time_period` or `series_type`)
+
+```python
+data = av_get("OBV", symbol="IBM", interval="daily")
+ts = data["Technical Analysis: OBV"]
+```
+
+### VWAP — See Moving Averages section above
+
+### MFI — Money Flow Index
+
+**Required:** `symbol`, `interval`, `time_period` (no `series_type`)
+
+```python
+data = av_get("MFI", symbol="IBM", interval="daily", time_period=14)
+ts = data["Technical Analysis: MFI"]
+```
+
+---
+
+## Volatility Indicators
+
+### ATR — Average True Range
+
+**Required:** `symbol`, `interval`, `time_period` (no `series_type`)
+
+```python
+data = av_get("ATR", symbol="IBM", interval="daily", time_period=14)
+ts = data["Technical Analysis: ATR"]
+```
+
+### NATR — Normalized Average True Range
+
+```python
+data = av_get("NATR", symbol="IBM", interval="daily", time_period=14)
+ts = data["Technical Analysis: NATR"]
+```
+
+### TRANGE — True Range
+
+**Required:** `symbol`, `interval` (no `time_period` or `series_type`)
+
+```python
+data = av_get("TRANGE", symbol="IBM", interval="daily")
+ts = data["Technical Analysis: TRANGE"]
+```
+
+---
+
+## Full Indicator Reference
+
+| Function | Description | Required Params |
+|----------|-------------|-----------------|
+| SMA | Simple Moving Average | symbol, interval, time_period, series_type |
+| EMA | Exponential Moving Average | symbol, interval, time_period, series_type |
+| WMA | Weighted Moving Average | symbol, interval, time_period, series_type |
+| DEMA | Double EMA | symbol, interval, time_period, series_type |
+| TEMA | Triple EMA | symbol, interval, time_period, series_type |
+| TRIMA | Triangular MA | symbol, interval, time_period, series_type |
+| KAMA | Kaufman Adaptive MA | symbol, interval, time_period, series_type |
+| MAMA | MESA Adaptive MA | symbol, interval, series_type |
+| VWAP | Vol Weighted Avg Price | symbol, interval (intraday only) |
+| T3 | Triple Smooth EMA | symbol, interval, time_period, series_type |
+| MACD | MACD | symbol, interval, series_type |
+| MACDEXT | MACD with Controllable MA | symbol, interval, series_type |
+| STOCH | Stochastic | symbol, interval |
+| STOCHF | Stochastic Fast | symbol, interval |
+| RSI | Relative Strength Index | symbol, interval, time_period, series_type |
+| STOCHRSI | Stochastic RSI | symbol, interval, time_period, series_type |
+| WILLR | Williams %R | symbol, interval, time_period |
+| ADX | Avg Directional Index | symbol, interval, time_period |
+| ADXR | ADX Rating | symbol, interval, time_period |
+| APO | Absolute Price Oscillator | symbol, interval, series_type |
+| PPO | Percentage Price Oscillator | symbol, interval, series_type |
+| MOM | Momentum | symbol, interval, time_period, series_type |
+| BOP | Balance of Power | symbol, interval |
+| CCI | Commodity Channel Index | symbol, interval, time_period |
+| CMO | Chande Momentum Oscillator | symbol, interval, time_period, series_type |
+| ROC | Rate of Change | symbol, interval, time_period, series_type |
+| ROCR | Rate of Change Ratio | symbol, interval, time_period, series_type |
+| AROON | Aroon | symbol, interval, time_period |
+| AROONOSC | Aroon Oscillator | symbol, interval, time_period |
+| MFI | Money Flow Index | symbol, interval, time_period |
+| TRIX | 1-day Rate of Change of Triple EMA | symbol, interval, time_period, series_type |
+| ULTOSC | Ultimate Oscillator | symbol, interval |
+| DX | Directional Movement Index | symbol, interval, time_period |
+| MINUS_DI | Minus Directional Indicator | symbol, interval, time_period |
+| PLUS_DI | Plus Directional Indicator | symbol, interval, time_period |
+| MINUS_DM | Minus Directional Movement | symbol, interval, time_period |
+| PLUS_DM | Plus Directional Movement | symbol, interval, time_period |
+| BBANDS | Bollinger Bands | symbol, interval, time_period, series_type |
+| MIDPOINT | MidPoint | symbol, interval, time_period, series_type |
+| MIDPRICE | MidPoint Price | symbol, interval, time_period |
+| SAR | Parabolic SAR | symbol, interval |
+| TRANGE | True Range | symbol, interval |
+| ATR | Average True Range | symbol, interval, time_period |
+| NATR | Normalized ATR | symbol, interval, time_period |
+| AD | Chaikin A/D Line | symbol, interval |
+| ADOSC | Chaikin A/D Oscillator | symbol, interval |
+| OBV | On Balance Volume | symbol, interval |
+| HT_TRENDLINE | Hilbert Transform - Trendline | symbol, interval, series_type |
+| HT_SINE | Hilbert Transform - SineWave | symbol, interval, series_type |
+| HT_TRENDMODE | Hilbert Transform - Trend vs Cycle | symbol, interval, series_type |
+| HT_DCPERIOD | Hilbert Transform - DC Period | symbol, interval, series_type |
+| HT_DCPHASE | Hilbert Transform - DC Phase | symbol, interval, series_type |
+| HT_PHASOR | Hilbert Transform - Phasor Components | symbol, interval, series_type |
+
+## Multi-Indicator Analysis Example
+
+```python
+import pandas as pd
+
+def get_indicator_series(function, symbol, interval="daily", **kwargs):
+    data = av_get(function, symbol=symbol, interval=interval, **kwargs)
+    key = f"Technical Analysis: {function}"
+    ts = data[key]
+    rows = []
+    for date, values in ts.items():
+        row = {"date": date}
+        row.update(values)
+        rows.append(row)
+    df = pd.DataFrame(rows)
+    df["date"] = pd.to_datetime(df["date"])
+    df = df.set_index("date").sort_index()
+    return df.astype(float)
+
+# Get RSI and BBANDS for signal generation
+rsi = get_indicator_series("RSI", "AAPL", time_period=14, series_type="close")
+bbands = get_indicator_series("BBANDS", "AAPL", time_period=20, series_type="close")
+
+# Oversold condition: RSI < 30 AND price near lower band
+print("Recent RSI values:")
+print(rsi["RSI"].tail(5))
+```

package/skills/tech/alpha-vantage/references/time-series.md

@@ -0,0 +1,157 @@
+# Time Series Stock Data APIs
+
+Base URL: `https://www.alphavantage.co/query`
+
+## GLOBAL_QUOTE — Latest Price
+
+Returns the latest price and volume for a ticker.
+
+**Required:** `symbol`
+
+```python
+data = av_get("GLOBAL_QUOTE", symbol="IBM")
+q = data["Global Quote"]
+# q keys: "01. symbol", "02. open", "03. high", "04. low", "05. price",
+#          "06. volume", "07. latest trading day", "08. previous close",
+#          "09. change", "10. change percent"
+print(q["05. price"])  # "217.51"
+```
+
+## TIME_SERIES_INTRADAY — Intraday OHLCV (Premium)
+
+Returns intraday candles with 20+ years of history.
+
+**Required:** `symbol`, `interval` (`1min`, `5min`, `15min`, `30min`, `60min`)
+
+**Optional:**
+- `adjusted` — default `true` (split/dividend adjusted)
+- `extended_hours` — default `true` (pre/post market included)
+- `month` — format `YYYY-MM` (query specific historical month)
+- `outputsize` — `compact` (100 points) or `full` (30 days / full month)
+- `entitlement` — `realtime` or `delayed` (15-min delayed)
+- `datatype` — `json` or `csv`
+
+```python
+data = av_get("TIME_SERIES_INTRADAY", symbol="IBM", interval="5min", outputsize="compact")
+ts = data["Time Series (5min)"]
+# Key: "2024-01-15 16:00:00" → {"1. open": "...", "2. high": ..., "3. low": ..., "4. close": ..., "5. volume": ...}
+
+# Get specific historical month
+data = av_get("TIME_SERIES_INTRADAY", symbol="IBM", interval="5min", month="2023-06", outputsize="full")
+```
+
+## TIME_SERIES_DAILY — Daily OHLCV
+
+**Required:** `symbol`
+
+**Optional:** `outputsize` (`compact`=100 points, `full`=20+ years), `datatype`
+
+```python
+data = av_get("TIME_SERIES_DAILY", symbol="IBM", outputsize="full")
+ts = data["Time Series (Daily)"]
+# Key: "2024-01-15" → {"1. open", "2. high", "3. low", "4. close", "5. volume"}
+```
+
+## TIME_SERIES_DAILY_ADJUSTED — Daily OHLCV with Adjustments (Premium)
+
+Includes split coefficient and dividend amount.
+
+**Required:** `symbol`
+
+**Optional:** `outputsize`, `datatype`
+
+```python
+data = av_get("TIME_SERIES_DAILY_ADJUSTED", symbol="IBM")
+ts = data["Time Series (Daily)"]
+# Extra keys: "6. adjusted close", "7. dividend amount", "8. split coefficient"
+```
+
+## TIME_SERIES_WEEKLY — Weekly OHLCV
+
+**Required:** `symbol`
+
+**Optional:** `datatype`
+
+```python
+data = av_get("TIME_SERIES_WEEKLY", symbol="IBM")
+ts = data["Weekly Time Series"]
+```
+
+## TIME_SERIES_WEEKLY_ADJUSTED — Weekly OHLCV with Adjustments
+
+```python
+data = av_get("TIME_SERIES_WEEKLY_ADJUSTED", symbol="IBM")
+ts = data["Weekly Adjusted Time Series"]
+```
+
+## TIME_SERIES_MONTHLY — Monthly OHLCV
+
+```python
+data = av_get("TIME_SERIES_MONTHLY", symbol="IBM")
+ts = data["Monthly Time Series"]
+```
+
+## TIME_SERIES_MONTHLY_ADJUSTED — Monthly with Adjustments
+
+```python
+data = av_get("TIME_SERIES_MONTHLY_ADJUSTED", symbol="IBM")
+ts = data["Monthly Adjusted Time Series"]
+```
+
+## REALTIME_BULK_QUOTES — Multiple Tickers (Premium)
+
+Get quotes for up to 100 symbols in one request.
+
+**Required:** `symbol` — comma-separated list (e.g., `IBM,AAPL,MSFT`)
+
+```python
+data = av_get("REALTIME_BULK_QUOTES", symbol="IBM,AAPL,MSFT,GOOGL")
+quotes = data["data"]  # list of quote objects
+for q in quotes:
+    print(q["symbol"], q["price"])
+```
+
+## SYMBOL_SEARCH — Ticker Search
+
+Search for ticker symbols by keyword.
+
+**Required:** `keywords`
+
+**Optional:** `datatype`
+
+```python
+data = av_get("SYMBOL_SEARCH", keywords="Microsoft")
+matches = data["bestMatches"]
+for m in matches:
+    print(m["1. symbol"], m["2. name"], m["4. region"])
+# Fields: "1. symbol", "2. name", "3. type", "4. region",
+#         "5. marketOpen", "6. marketClose", "7. timezone",
+#         "8. currency", "9. matchScore"
+```
+
+## MARKET_STATUS — Global Market Hours
+
+Returns open/closed status for major global exchanges.
+
+```python
+data = av_get("MARKET_STATUS")
+markets = data["markets"]
+for m in markets:
+    print(m["market_type"], m["region"], m["current_status"])
+# Fields: "market_type", "region", "primary_exchanges",
+#         "local_open", "local_close", "current_status", "notes"
+```
+
+## Convert to DataFrame
+
+```python
+import pandas as pd
+
+data = av_get("TIME_SERIES_DAILY", symbol="AAPL", outputsize="full")
+ts = data["Time Series (Daily)"]
+df = pd.DataFrame.from_dict(ts, orient="index")
+df.columns = ["open", "high", "low", "close", "volume"]
+df.index = pd.to_datetime(df.index)
+df = df.astype(float).sort_index()
+print(df.tail())
+```

package/skills/tech/financial-modeling/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: financial-modeling
+description: Consolidated financial modeling skill aggregating Discounted Cash Flow (DCF), Leveraged Buyout (LBO), Merger Modeling, and 3-Statement financial projections.
+---
+
+# Financial Modeling Knowledge Base
+
+This parent skill aggregates rigorous qualitative and quantitative modeling instructions for the `quant-developer` agent. By integrating the sub-skills below, the agent can structure complex, multi-statement forecasts and perform advanced valuation tasks.
+
+## Available Sub-Skills
+
+- **[DCF Model](skills/dcf-model/SKILL.md):** Instruction sets and templates for building intrinsic valuations using Discounted Cash Flows.
+- **[LBO Model](skills/lbo-model/SKILL.md):** Private equity leveraged buyout modeling covering debt schedules, IRR, and MoM return analysis.
+- **[Merger Model](skills/merger-model/SKILL.md):** M&A accretion/dilution analysis, purchase price allocation, and pro-forma balance sheets.
+- **[3-Statements](skills/3-statements/SKILL.md):** Standard income statement, balance sheet, and cash flow historical extraction and projection protocols.
+
+## Integration Notice
+These sub-skills were ported from the specialized `financial-services-plugins` repository to fortify the baseline reasoning capabilities of the `quant-developer` agent. Ensure that assumptions (e.g., WACC, tax rates) are properly isolated when running backtests or algorithmic models based on these fundamental outputs.