superkit-mcp-server 1.0.2 → 1.0.3

package/skills/tech/alpha-vantage/references/intelligence.md

@@ -0,0 +1,138 @@
+# Alpha Intelligence™ APIs
+
+## NEWS_SENTIMENT — Market News & Sentiment
+
+Returns live/historical news articles with sentiment scores for tickers, sectors, and topics.
+
+**Optional:**
+- `tickers` — comma-separated ticker symbols (e.g., `IBM,AAPL`)
+- `topics` — comma-separated topics: `blockchain`, `earnings`, `ipo`, `mergers_and_acquisitions`, `financial_markets`, `economy_fiscal`, `economy_monetary`, `economy_macro`, `energy_transportation`, `finance`, `life_sciences`, `manufacturing`, `real_estate`, `retail_wholesale`, `technology`
+- `time_from` / `time_to` — format `YYYYMMDDTHHMM`
+- `sort` — `LATEST`, `EARLIEST`, or `RELEVANCE`
+- `limit` — max articles returned (default 50, max 1000)
+
+```python
+# Get news for specific ticker
+data = av_get("NEWS_SENTIMENT", tickers="AAPL", sort="LATEST", limit=10)
+articles = data["feed"]
+
+for a in articles[:3]:
+    print(a["title"])
+    print(a["url"])
+    print(a["time_published"])
+    print(a["overall_sentiment_label"])   # "Bullish", "Bearish", "Neutral", etc.
+    print(a["overall_sentiment_score"])   # -1.0 to 1.0
+    for ts in a["ticker_sentiment"]:
+        if ts["ticker"] == "AAPL":
+            print(f"  AAPL sentiment: {ts['ticker_sentiment_label']} ({ts['ticker_sentiment_score']})")
+            print(f"  Relevance: {ts['relevance_score']}")
+
+# Article fields: "title", "url", "time_published", "authors", "summary",
+#                 "source", "source_domain", "topics", "overall_sentiment_score",
+#                 "overall_sentiment_label", "ticker_sentiment"
+# Sentiment labels: "Bearish", "Somewhat-Bearish", "Neutral", "Somewhat-Bullish", "Bullish"
+
+# Get news by topic
+data = av_get("NEWS_SENTIMENT", topics="earnings,technology", time_from="20240101T0000", limit=50)
+```
+
+## EARNINGS_CALL_TRANSCRIPT — Earnings Call Transcript
+
+Returns full earnings call transcripts (requires premium).
+
+**Required:** `symbol`, `quarter` (format `YYYYQN`, e.g., `2023Q4`)
+
+```python
+data = av_get("EARNINGS_CALL_TRANSCRIPT", symbol="AAPL", quarter="2023Q4")
+transcript = data["transcript"]
+
+for segment in transcript[:5]:
+    print(f"[{segment['speaker']}]: {segment['content'][:200]}")
+# Fields: "symbol", "quarter", "transcript" (list of {speaker, title, content})
+```
+
+## TOP_GAINERS_LOSERS — Top Market Movers
+
+Returns top 20 gainers, losers, and most actively traded US stocks for the current/most recent trading day.
+
+```python
+data = av_get("TOP_GAINERS_LOSERS")
+
+for g in data["top_gainers"][:5]:
+    print(g["ticker"], g["price"], g["change_amount"], g["change_percentage"], g["volume"])
+
+for l in data["top_losers"][:5]:
+    print(l["ticker"], l["price"], l["change_amount"], l["change_percentage"])
+
+# Fields: "ticker", "price", "change_amount", "change_percentage", "volume"
+# Also: data["most_actively_traded"]
+```
+
+## INSIDER_TRANSACTIONS — Insider Trading Data
+
+Returns insider transactions (Form 4) for a given company (requires premium).
+
+**Required:** `symbol`
+
+```python
+data = av_get("INSIDER_TRANSACTIONS", symbol="AAPL")
+transactions = data["data"]
+
+for t in transactions[:5]:
+    print(
+        t["transaction_date"],
+        t["executive"],         # insider name
+        t["executive_title"],   # e.g., "CEO"
+        t["action"],            # "Buy" or "Sell"
+        t["shares"],
+        t["share_price"],
+        t["total_value"]
+    )
+```
+
+## ANALYTICS_FIXED_WINDOW — Portfolio Analytics (Fixed Window)
+
+Returns mean return, variance, covariance, correlation, and alpha/beta for a set of tickers over a fixed historical window.
+
+**Required:**
+- `SYMBOLS` — comma-separated tickers (e.g., `AAPL,MSFT,IBM`)
+- `RANGE` — date range format: `2year`, `6month`, `30day`, or `YYYY-MM-DD&YYYY-MM-DD`
+- `INTERVAL` — `DAILY`, `WEEKLY`, or `MONTHLY`
+- `OHLC` — `close`, `open`, `high`, or `low`
+- `CALCULATIONS` — comma-separated: `MEAN`, `STDDEV`, `MAX_DRAWDOWN`, `CORRELATION`, `COVARIANCE`, `VARIANCE`, `CUMULATIVE_RETURN`, `MIN`, `MAX`, `MEDIAN`, `HISTOGRAM`
+
+```python
+data = av_get(
+    "ANALYTICS_FIXED_WINDOW",
+    SYMBOLS="AAPL,MSFT,IBM",
+    RANGE="1year",
+    INTERVAL="DAILY",
+    OHLC="close",
+    CALCULATIONS="MEAN,STDDEV,CORRELATION,MAX_DRAWDOWN"
+)
+payload = data["payload"]
+print(payload["MEAN"])        # {"AAPL": 0.0012, "MSFT": 0.0009, ...}
+print(payload["STDDEV"])
+print(payload["CORRELATION"])  # correlation matrix
+print(payload["MAX_DRAWDOWN"])
+```
+
+## ANALYTICS_SLIDING_WINDOW — Portfolio Analytics (Sliding Window)
+
+Same as fixed window but with rolling calculations over time.
+
+**Required:** Same as fixed window, plus:
+- `WINDOW_SIZE` — number of periods (e.g., `20` for 20-day rolling window)
+
+```python
+data = av_get(
+    "ANALYTICS_SLIDING_WINDOW",
+    SYMBOLS="AAPL,MSFT",
+    RANGE="1year",
+    INTERVAL="DAILY",
+    OHLC="close",
+    CALCULATIONS="MEAN,STDDEV",
+    WINDOW_SIZE=20
+)
+# Returns time series of rolling calculations
+```

package/skills/tech/alpha-vantage/references/options.md

@@ -0,0 +1,93 @@
+# Options Data APIs (Premium)
+
+Both options endpoints require a premium Alpha Vantage subscription.
+
+## REALTIME_OPTIONS — Real-time Options Chain
+
+Returns real-time options contracts for a given symbol.
+
+**Required:** `symbol`
+
+**Optional:**
+- `contract` — specific contract ID (e.g., `AAPL240119C00150000`) to get a single contract
+- `datatype` — `json` or `csv`
+
+```python
+data = av_get("REALTIME_OPTIONS", symbol="AAPL")
+options = data["data"]
+
+for contract in options[:5]:
+    print(
+        contract["contractID"],    # e.g., "AAPL240119C00150000"
+        contract["strike"],        # "150.00"
+        contract["expiration"],    # "2024-01-19"
+        contract["type"],          # "call" or "put"
+        contract["last"],          # last price
+        contract["bid"],
+        contract["ask"],
+        contract["volume"],
+        contract["open_interest"],
+        contract["implied_volatility"],
+        contract["delta"],
+        contract["gamma"],
+        contract["theta"],
+        contract["vega"],
+        contract["rho"]
+    )
+
+# Get a specific contract
+data = av_get("REALTIME_OPTIONS", symbol="AAPL", contract="AAPL240119C00150000")
+```
+
+## HISTORICAL_OPTIONS — Historical Options Chain
+
+Returns historical end-of-day options data for a specific date.
+
+**Required:** `symbol`
+
+**Optional:**
+- `date` — format `YYYY-MM-DD` (up to 2 years of history)
+- `datatype` — `json` or `csv`
+
+```python
+# Get options chain for a specific historical date
+data = av_get("HISTORICAL_OPTIONS", symbol="AAPL", date="2023-12-15")
+options = data["data"]
+
+for contract in options[:5]:
+    print(
+        contract["contractID"],
+        contract["strike"],
+        contract["expiration"],
+        contract["type"],           # "call" or "put"
+        contract["last"],
+        contract["mark"],           # mark price
+        contract["bid"],
+        contract["ask"],
+        contract["volume"],
+        contract["open_interest"],
+        contract["date"],           # the date of this snapshot
+        contract["implied_volatility"],
+        contract["delta"],
+        contract["gamma"],
+        contract["theta"],
+        contract["vega"],
+        contract["rho"]
+    )
+```
+
+## Filter Options by Expiration/Type
+
+```python
+import pandas as pd
+
+data = av_get("HISTORICAL_OPTIONS", symbol="AAPL", date="2023-12-15")
+df = pd.DataFrame(data["data"])
+df["strike"] = pd.to_numeric(df["strike"])
+df["expiration"] = pd.to_datetime(df["expiration"])
+
+# Filter calls expiring in January 2024
+calls_jan = df[(df["type"] == "call") & (df["expiration"].dt.month == 1) & (df["expiration"].dt.year == 2024)]
+calls_jan = calls_jan.sort_values("strike")
+print(calls_jan[["contractID", "strike", "bid", "ask", "implied_volatility", "delta"]].head(10))
+```

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))
+```