superkit-mcp-server 1.1.4 → 1.2.0

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

@@ -1,158 +1,158 @@
-# Economic Indicators APIs
-
-All economic indicators return US data and follow the same response structure:
-
-```json
-{
-  "name": "Real Gross Domestic Product",
-  "interval": "annual",
-  "unit": "billions of chained 2012 dollars",
-  "data": [{"date": "2023-01-01", "value": "22067.1"}, ...]
-}
-```
-
-## GDP
-
-### REAL_GDP — Real Gross Domestic Product
-
-Source: US Bureau of Economic Analysis via FRED.
-
-**Optional:** `interval` (`annual`, `quarterly`) — default: `annual`
-
-```python
-data = av_get("REAL_GDP", interval="quarterly")
-latest = data["data"][0]
-print(latest["date"], latest["value"])
-# unit: billions of chained 2012 dollars
-```
-
-### REAL_GDP_PER_CAPITA — Real GDP Per Capita
-
-**No interval parameter** — quarterly data only.
-
-```python
-data = av_get("REAL_GDP_PER_CAPITA")
-# unit: chained 2012 dollars
-```
-
-## Interest Rates
-
-### TREASURY_YIELD — US Treasury Yield
-
-**Optional:**
-- `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
-- `maturity` (`3month`, `2year`, `5year`, `7year`, `10year`, `30year`) — default: `10year`
-
-```python
-# 10-year treasury yield (daily)
-data = av_get("TREASURY_YIELD", interval="daily", maturity="10year")
-for obs in data["data"][:5]:
-    print(obs["date"], obs["value"])
-# unit: percent
-
-# 2-year vs 10-year spread (yield curve)
-two_yr = av_get("TREASURY_YIELD", interval="monthly", maturity="2year")
-ten_yr = av_get("TREASURY_YIELD", interval="monthly", maturity="10year")
-```
-
-### FEDERAL_FUNDS_RATE — Federal Funds Rate
-
-**Optional:** `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
-
-```python
-data = av_get("FEDERAL_FUNDS_RATE", interval="monthly")
-# unit: percent
-```
-
-## Inflation
-
-### CPI — Consumer Price Index
-
-**Optional:** `interval` (`monthly`, `semiannual`) — default: `monthly`
-
-```python
-data = av_get("CPI", interval="monthly")
-# unit: index 1982-1984 = 100
-```
-
-### INFLATION — Annual Inflation Rate
-
-**No parameters** — annual data only.
-
-```python
-data = av_get("INFLATION")
-# unit: percent (YoY change in CPI)
-```
-
-## Labor Market
-
-### UNEMPLOYMENT — Unemployment Rate
-
-**No parameters** — monthly data only.
-
-```python
-data = av_get("UNEMPLOYMENT")
-latest = data["data"][0]
-print(latest["date"], latest["value"])
-# unit: percent
-```
-
-### NONFARM_PAYROLL — Nonfarm Payroll
-
-**No parameters** — monthly data only.
-
-```python
-data = av_get("NONFARM_PAYROLL")
-# unit: thousands of persons
-```
-
-## Consumer Spending
-
-### RETAIL_SALES — Monthly Retail Sales
-
-**No parameters** — monthly data only.
-
-```python
-data = av_get("RETAIL_SALES")
-# unit: millions of dollars
-```
-
-### DURABLES — Durable Goods Orders
-
-**No parameters** — monthly data only.
-
-```python
-data = av_get("DURABLES")
-# unit: millions of dollars
-```
-
-## Macro Dashboard Example
-
-```python
-import pandas as pd
-
-def econ_to_series(function, **kwargs):
-    data = av_get(function, **kwargs)
-    df = pd.DataFrame(data["data"])
-    df["date"] = pd.to_datetime(df["date"])
-    df["value"] = pd.to_numeric(df["value"], errors="coerce")
-    return df.set_index("date")["value"].sort_index()
-
-# Build economic snapshot
-gdp = econ_to_series("REAL_GDP", interval="quarterly")
-fed_funds = econ_to_series("FEDERAL_FUNDS_RATE", interval="monthly")
-unemployment = econ_to_series("UNEMPLOYMENT")
-cpi = econ_to_series("CPI", interval="monthly")
-ten_yr = econ_to_series("TREASURY_YIELD", interval="monthly", maturity="10year")
-
-print(f"Latest GDP: {gdp.iloc[-1]:.1f} billion (chained 2012$)")
-print(f"Fed Funds Rate: {fed_funds.iloc[-1]:.2f}%")
-print(f"Unemployment: {unemployment.iloc[-1]:.1f}%")
-print(f"CPI: {cpi.iloc[-1]:.1f}")
-print(f"10-Year Treasury: {ten_yr.iloc[-1]:.2f}%")
-
-# Yield curve inversion check
-two_yr = econ_to_series("TREASURY_YIELD", interval="monthly", maturity="2year")
-spread = ten_yr - two_yr
-print(f"Yield curve spread (10yr - 2yr): {spread.iloc[-1]:.2f}% ({'inverted' if spread.iloc[-1] < 0 else 'normal'})")
-```
+# Economic Indicators APIs
+
+All economic indicators return US data and follow the same response structure:
+
+```json
+{
+  "name": "Real Gross Domestic Product",
+  "interval": "annual",
+  "unit": "billions of chained 2012 dollars",
+  "data": [{"date": "2023-01-01", "value": "22067.1"}, ...]
+}
+```
+
+## GDP
+
+### REAL_GDP — Real Gross Domestic Product
+
+Source: US Bureau of Economic Analysis via FRED.
+
+**Optional:** `interval` (`annual`, `quarterly`) — default: `annual`
+
+```python
+data = av_get("REAL_GDP", interval="quarterly")
+latest = data["data"][0]
+print(latest["date"], latest["value"])
+# unit: billions of chained 2012 dollars
+```
+
+### REAL_GDP_PER_CAPITA — Real GDP Per Capita
+
+**No interval parameter** — quarterly data only.
+
+```python
+data = av_get("REAL_GDP_PER_CAPITA")
+# unit: chained 2012 dollars
+```
+
+## Interest Rates
+
+### TREASURY_YIELD — US Treasury Yield
+
+**Optional:**
+- `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
+- `maturity` (`3month`, `2year`, `5year`, `7year`, `10year`, `30year`) — default: `10year`
+
+```python
+# 10-year treasury yield (daily)
+data = av_get("TREASURY_YIELD", interval="daily", maturity="10year")
+for obs in data["data"][:5]:
+    print(obs["date"], obs["value"])
+# unit: percent
+
+# 2-year vs 10-year spread (yield curve)
+two_yr = av_get("TREASURY_YIELD", interval="monthly", maturity="2year")
+ten_yr = av_get("TREASURY_YIELD", interval="monthly", maturity="10year")
+```
+
+### FEDERAL_FUNDS_RATE — Federal Funds Rate
+
+**Optional:** `interval` (`daily`, `weekly`, `monthly`) — default: `monthly`
+
+```python
+data = av_get("FEDERAL_FUNDS_RATE", interval="monthly")
+# unit: percent
+```
+
+## Inflation
+
+### CPI — Consumer Price Index
+
+**Optional:** `interval` (`monthly`, `semiannual`) — default: `monthly`
+
+```python
+data = av_get("CPI", interval="monthly")
+# unit: index 1982-1984 = 100
+```
+
+### INFLATION — Annual Inflation Rate
+
+**No parameters** — annual data only.
+
+```python
+data = av_get("INFLATION")
+# unit: percent (YoY change in CPI)
+```
+
+## Labor Market
+
+### UNEMPLOYMENT — Unemployment Rate
+
+**No parameters** — monthly data only.
+
+```python
+data = av_get("UNEMPLOYMENT")
+latest = data["data"][0]
+print(latest["date"], latest["value"])
+# unit: percent
+```
+
+### NONFARM_PAYROLL — Nonfarm Payroll
+
+**No parameters** — monthly data only.
+
+```python
+data = av_get("NONFARM_PAYROLL")
+# unit: thousands of persons
+```
+
+## Consumer Spending
+
+### RETAIL_SALES — Monthly Retail Sales
+
+**No parameters** — monthly data only.
+
+```python
+data = av_get("RETAIL_SALES")
+# unit: millions of dollars
+```
+
+### DURABLES — Durable Goods Orders
+
+**No parameters** — monthly data only.
+
+```python
+data = av_get("DURABLES")
+# unit: millions of dollars
+```
+
+## Macro Dashboard Example
+
+```python
+import pandas as pd
+
+def econ_to_series(function, **kwargs):
+    data = av_get(function, **kwargs)
+    df = pd.DataFrame(data["data"])
+    df["date"] = pd.to_datetime(df["date"])
+    df["value"] = pd.to_numeric(df["value"], errors="coerce")
+    return df.set_index("date")["value"].sort_index()
+
+# Build economic snapshot
+gdp = econ_to_series("REAL_GDP", interval="quarterly")
+fed_funds = econ_to_series("FEDERAL_FUNDS_RATE", interval="monthly")
+unemployment = econ_to_series("UNEMPLOYMENT")
+cpi = econ_to_series("CPI", interval="monthly")
+ten_yr = econ_to_series("TREASURY_YIELD", interval="monthly", maturity="10year")
+
+print(f"Latest GDP: {gdp.iloc[-1]:.1f} billion (chained 2012$)")
+print(f"Fed Funds Rate: {fed_funds.iloc[-1]:.2f}%")
+print(f"Unemployment: {unemployment.iloc[-1]:.1f}%")
+print(f"CPI: {cpi.iloc[-1]:.1f}")
+print(f"10-Year Treasury: {ten_yr.iloc[-1]:.2f}%")
+
+# Yield curve inversion check
+two_yr = econ_to_series("TREASURY_YIELD", interval="monthly", maturity="2year")
+spread = ten_yr - two_yr
+print(f"Yield curve spread (10yr - 2yr): {spread.iloc[-1]:.2f}% ({'inverted' if spread.iloc[-1] < 0 else 'normal'})")
+```

package/skills/tech/alpha-vantage/references/forex-crypto.md

@@ -1,154 +1,154 @@
-# Forex (FX) & Cryptocurrency APIs
-
-## Foreign Exchange Rates
-
-### CURRENCY_EXCHANGE_RATE — Realtime Exchange Rate
-
-Returns the realtime exchange rate for any currency pair (fiat or crypto).
-
-**Required:** `from_currency`, `to_currency`
-
-```python
-# Fiat to fiat
-data = av_get("CURRENCY_EXCHANGE_RATE", from_currency="USD", to_currency="EUR")
-rate_info = data["Realtime Currency Exchange Rate"]
-print(rate_info["5. Exchange Rate"])   # e.g., "0.92"
-print(rate_info["6. Last Refreshed"])
-print(rate_info["8. Bid Price"])
-print(rate_info["9. Ask Price"])
-# Full fields: "1. From_Currency Code", "2. From_Currency Name",
-#              "3. To_Currency Code", "4. To_Currency Name",
-#              "5. Exchange Rate", "6. Last Refreshed",
-#              "7. Time Zone", "8. Bid Price", "9. Ask Price"
-
-# Crypto to fiat
-data = av_get("CURRENCY_EXCHANGE_RATE", from_currency="BTC", to_currency="USD")
-print(data["Realtime Currency Exchange Rate"]["5. Exchange Rate"])
-```
-
-### FX_INTRADAY — Intraday Forex OHLCV (Premium)
-
-**Required:** `from_symbol`, `to_symbol`, `interval` (`1min`, `5min`, `15min`, `30min`, `60min`)
-
-**Optional:** `outputsize` (`compact`/`full`), `datatype`
-
-```python
-data = av_get("FX_INTRADAY", from_symbol="EUR", to_symbol="USD", interval="5min")
-ts = data["Time Series FX (5min)"]
-# Key: "2024-01-15 16:00:00" → {"1. open", "2. high", "3. low", "4. close"}
-```
-
-### FX_DAILY — Daily Forex OHLCV
-
-**Required:** `from_symbol`, `to_symbol`
-
-**Optional:** `outputsize` (`compact`/`full`), `datatype`
-
-```python
-data = av_get("FX_DAILY", from_symbol="EUR", to_symbol="USD", outputsize="full")
-ts = data["Time Series FX (Daily)"]
-# Key: "2024-01-15" → {"1. open", "2. high", "3. low", "4. close"}
-```
-
-### FX_WEEKLY — Weekly Forex OHLCV
-
-```python
-data = av_get("FX_WEEKLY", from_symbol="EUR", to_symbol="USD")
-ts = data["Time Series FX (Weekly)"]
-```
-
-### FX_MONTHLY — Monthly Forex OHLCV
-
-```python
-data = av_get("FX_MONTHLY", from_symbol="EUR", to_symbol="USD")
-ts = data["Time Series FX (Monthly)"]
-```
-
-## Common Currency Codes
-
-| Code | Currency |
-|------|---------|
-| USD | US Dollar |
-| EUR | Euro |
-| GBP | British Pound |
-| JPY | Japanese Yen |
-| CHF | Swiss Franc |
-| CAD | Canadian Dollar |
-| AUD | Australian Dollar |
-| CNY | Chinese Yuan |
-| HKD | Hong Kong Dollar |
-| BTC | Bitcoin |
-| ETH | Ethereum |
-
----
-
-## Cryptocurrency
-
-### CRYPTO_INTRADAY — Crypto Intraday OHLCV (Premium)
-
-**Required:** `symbol`, `market`, `interval` (`1min`, `5min`, `15min`, `30min`, `60min`)
-
-**Optional:** `outputsize` (`compact`/`full`), `datatype`
-
-```python
-data = av_get("CRYPTO_INTRADAY", symbol="ETH", market="USD", interval="5min")
-ts = data["Time Series Crypto (5min)"]
-# Key: "2024-01-15 16:00:00" → {"1. open", "2. high", "3. low", "4. close", "5. volume"}
-```
-
-### DIGITAL_CURRENCY_DAILY — Daily Crypto OHLCV
-
-**Required:** `symbol`, `market`
-
-```python
-data = av_get("DIGITAL_CURRENCY_DAILY", symbol="BTC", market="USD")
-ts = data["Time Series (Digital Currency Daily)"]
-# Key: "2024-01-15" → {
-#   "1a. open (USD)", "1b. open (USD)",
-#   "2a. high (USD)", "2b. high (USD)",
-#   "3a. low (USD)",  "3b. low (USD)",
-#   "4a. close (USD)", "4b. close (USD)",
-#   "5. volume", "6. market cap (USD)"
-# }
-
-# Convert to DataFrame
-import pandas as pd
-df = pd.DataFrame.from_dict(ts, orient="index")
-df.index = pd.to_datetime(df.index)
-df = df.sort_index()
-# Extract close price
-df["close"] = pd.to_numeric(df["4a. close (USD)"])
-```
-
-### DIGITAL_CURRENCY_WEEKLY — Weekly Crypto OHLCV
-
-**Required:** `symbol`, `market`
-
-```python
-data = av_get("DIGITAL_CURRENCY_WEEKLY", symbol="BTC", market="USD")
-ts = data["Time Series (Digital Currency Weekly)"]
-```
-
-### DIGITAL_CURRENCY_MONTHLY — Monthly Crypto OHLCV
-
-**Required:** `symbol`, `market`
-
-```python
-data = av_get("DIGITAL_CURRENCY_MONTHLY", symbol="ETH", market="USD")
-ts = data["Time Series (Digital Currency Monthly)"]
-```
-
-## Common Crypto Symbols
-
-| Symbol | Name |
-|--------|------|
-| BTC | Bitcoin |
-| ETH | Ethereum |
-| BNB | Binance Coin |
-| XRP | Ripple |
-| ADA | Cardano |
-| SOL | Solana |
-| DOGE | Dogecoin |
-| AVAX | Avalanche |
-| DOT | Polkadot |
-| MATIC | Polygon |
+# Forex (FX) & Cryptocurrency APIs
+
+## Foreign Exchange Rates
+
+### CURRENCY_EXCHANGE_RATE — Realtime Exchange Rate
+
+Returns the realtime exchange rate for any currency pair (fiat or crypto).
+
+**Required:** `from_currency`, `to_currency`
+
+```python
+# Fiat to fiat
+data = av_get("CURRENCY_EXCHANGE_RATE", from_currency="USD", to_currency="EUR")
+rate_info = data["Realtime Currency Exchange Rate"]
+print(rate_info["5. Exchange Rate"])   # e.g., "0.92"
+print(rate_info["6. Last Refreshed"])
+print(rate_info["8. Bid Price"])
+print(rate_info["9. Ask Price"])
+# Full fields: "1. From_Currency Code", "2. From_Currency Name",
+#              "3. To_Currency Code", "4. To_Currency Name",
+#              "5. Exchange Rate", "6. Last Refreshed",
+#              "7. Time Zone", "8. Bid Price", "9. Ask Price"
+
+# Crypto to fiat
+data = av_get("CURRENCY_EXCHANGE_RATE", from_currency="BTC", to_currency="USD")
+print(data["Realtime Currency Exchange Rate"]["5. Exchange Rate"])
+```
+
+### FX_INTRADAY — Intraday Forex OHLCV (Premium)
+
+**Required:** `from_symbol`, `to_symbol`, `interval` (`1min`, `5min`, `15min`, `30min`, `60min`)
+
+**Optional:** `outputsize` (`compact`/`full`), `datatype`
+
+```python
+data = av_get("FX_INTRADAY", from_symbol="EUR", to_symbol="USD", interval="5min")
+ts = data["Time Series FX (5min)"]
+# Key: "2024-01-15 16:00:00" → {"1. open", "2. high", "3. low", "4. close"}
+```
+
+### FX_DAILY — Daily Forex OHLCV
+
+**Required:** `from_symbol`, `to_symbol`
+
+**Optional:** `outputsize` (`compact`/`full`), `datatype`
+
+```python
+data = av_get("FX_DAILY", from_symbol="EUR", to_symbol="USD", outputsize="full")
+ts = data["Time Series FX (Daily)"]
+# Key: "2024-01-15" → {"1. open", "2. high", "3. low", "4. close"}
+```
+
+### FX_WEEKLY — Weekly Forex OHLCV
+
+```python
+data = av_get("FX_WEEKLY", from_symbol="EUR", to_symbol="USD")
+ts = data["Time Series FX (Weekly)"]
+```
+
+### FX_MONTHLY — Monthly Forex OHLCV
+
+```python
+data = av_get("FX_MONTHLY", from_symbol="EUR", to_symbol="USD")
+ts = data["Time Series FX (Monthly)"]
+```
+
+## Common Currency Codes
+
+| Code | Currency |
+|------|---------|
+| USD | US Dollar |
+| EUR | Euro |
+| GBP | British Pound |
+| JPY | Japanese Yen |
+| CHF | Swiss Franc |
+| CAD | Canadian Dollar |
+| AUD | Australian Dollar |
+| CNY | Chinese Yuan |
+| HKD | Hong Kong Dollar |
+| BTC | Bitcoin |
+| ETH | Ethereum |
+
+---
+
+## Cryptocurrency
+
+### CRYPTO_INTRADAY — Crypto Intraday OHLCV (Premium)
+
+**Required:** `symbol`, `market`, `interval` (`1min`, `5min`, `15min`, `30min`, `60min`)
+
+**Optional:** `outputsize` (`compact`/`full`), `datatype`
+
+```python
+data = av_get("CRYPTO_INTRADAY", symbol="ETH", market="USD", interval="5min")
+ts = data["Time Series Crypto (5min)"]
+# Key: "2024-01-15 16:00:00" → {"1. open", "2. high", "3. low", "4. close", "5. volume"}
+```
+
+### DIGITAL_CURRENCY_DAILY — Daily Crypto OHLCV
+
+**Required:** `symbol`, `market`
+
+```python
+data = av_get("DIGITAL_CURRENCY_DAILY", symbol="BTC", market="USD")
+ts = data["Time Series (Digital Currency Daily)"]
+# Key: "2024-01-15" → {
+#   "1a. open (USD)", "1b. open (USD)",
+#   "2a. high (USD)", "2b. high (USD)",
+#   "3a. low (USD)",  "3b. low (USD)",
+#   "4a. close (USD)", "4b. close (USD)",
+#   "5. volume", "6. market cap (USD)"
+# }
+
+# Convert to DataFrame
+import pandas as pd
+df = pd.DataFrame.from_dict(ts, orient="index")
+df.index = pd.to_datetime(df.index)
+df = df.sort_index()
+# Extract close price
+df["close"] = pd.to_numeric(df["4a. close (USD)"])
+```
+
+### DIGITAL_CURRENCY_WEEKLY — Weekly Crypto OHLCV
+
+**Required:** `symbol`, `market`
+
+```python
+data = av_get("DIGITAL_CURRENCY_WEEKLY", symbol="BTC", market="USD")
+ts = data["Time Series (Digital Currency Weekly)"]
+```
+
+### DIGITAL_CURRENCY_MONTHLY — Monthly Crypto OHLCV
+
+**Required:** `symbol`, `market`
+
+```python
+data = av_get("DIGITAL_CURRENCY_MONTHLY", symbol="ETH", market="USD")
+ts = data["Time Series (Digital Currency Monthly)"]
+```
+
+## Common Crypto Symbols
+
+| Symbol | Name |
+|--------|------|
+| BTC | Bitcoin |
+| ETH | Ethereum |
+| BNB | Binance Coin |
+| XRP | Ripple |
+| ADA | Cardano |
+| SOL | Solana |
+| DOGE | Dogecoin |
+| AVAX | Avalanche |
+| DOT | Polkadot |
+| MATIC | Polygon |