@fre4x/yahoo-finance 1.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 AlexYoung (Original Author)
+Copyright (c) 2026 SKTelecom (Fork Maintainer - Pagination & Caching Enhancements)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# yahoo-finance — The Market Claw
+
+> *Markets are not fair. They are fast. The agent that reads prices, filings, and options chains in milliseconds does not lose. It waits.*
+
+Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.
+
+Price history, balance sheets, insider moves, analyst upgrades, options flow — the full operational picture of any publicly traded entity. No API key. No subscription. No delay that matters. This B1TE bites through the noisiest market on earth.
+
+## Tools
+
+### Price & Market Data
+
+| Tool | What it tracks |
+|------|---------------|
+| `yfin_get_historical_prices` | OHLCV bars — any ticker, any period, any interval |
+| `yfin_get_stock_info` | Price, company profile, key statistics, financial health |
+| `yfin_get_news` | Latest news articles for a ticker |
+| `yfin_get_stock_actions` | Dividend payments and stock splits |
+
+### Financial Statements
+
+| Tool | What it exposes |
+|------|----------------|
+| `yfin_get_financial_statement` | Income statement, balance sheet, cash flow (annual or quarterly) |
+| `yfin_get_holder_info` | Major holders, institutions, mutual funds, insider transactions |
+
+### Options Intelligence
+
+| Tool | What it maps |
+|------|-------------|
+| `yfin_get_option_dates` | Available expiration dates for a ticker |
+| `yfin_get_option_chain` | Full calls or puts chain for a given expiration |
+
+### Analyst Signal
+
+| Tool | What it surfaces |
+|------|----------------|
+| `yfin_get_recommendations` | Consensus recommendations or firm upgrade/downgrade history |
+
+All list tools support pagination via `limit` / `offset`. No API key required.
+
+## Deploy
+
+```json
+{
+  "mcpServers": {
+    "yahoo-finance": {
+      "command": "npx",
+      "args": ["-y", "@fre4x/yahoo-finance"]
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+bun install
+bun run dev      # tsx, no build
+bun run build    # compile → dist/
+```
+
+## License
+
+MIT — **WE ARE THE FRE4X.**

package/dist/api.d.ts

@@ -0,0 +1,142 @@
+import type { HistoricalPeriod, HistoricalInterval, FinancialType, HolderType, OptionType } from "./types.js";
+/** Convert yfinance-style period string to a start Date */
+export declare function periodToStartDate(period: HistoricalPeriod): Date;
+export declare function getHistoricalPrices(ticker: string, period: HistoricalPeriod, interval: HistoricalInterval): Promise<{
+    events?: {
+        dividends?: {
+            date: Date;
+            amount: number;
+        }[] | undefined;
+        splits?: {
+            date: Date;
+            numerator: number;
+            denominator: number;
+            splitRatio: string;
+        }[] | undefined;
+    } | undefined;
+    meta: {
+        previousClose?: number | undefined;
+        chartPreviousClose?: number | undefined;
+        scale?: number | undefined;
+        tradingPeriods?: {
+            pre?: {
+                gmtoffset: number;
+                timezone: string;
+                start: Date;
+                end: Date;
+            }[][] | undefined;
+            regular?: {
+                gmtoffset: number;
+                timezone: string;
+                start: Date;
+                end: Date;
+            }[][] | undefined;
+            post?: {
+                gmtoffset: number;
+                timezone: string;
+                start: Date;
+                end: Date;
+            }[][] | undefined;
+        } | {
+            gmtoffset: number;
+            timezone: string;
+            start: Date;
+            end: Date;
+        }[][] | undefined;
+        symbol: string;
+        priceHint: number;
+        exchangeName: string;
+        regularMarketTime: Date;
+        regularMarketPrice: number;
+        currency: string;
+        instrumentType: string;
+        firstTradeDate: Date | null;
+        gmtoffset: number;
+        timezone: string;
+        exchangeTimezoneName: string;
+        currentTradingPeriod: {
+            pre: {
+                gmtoffset: number;
+                timezone: string;
+                start: Date;
+                end: Date;
+            };
+            regular: {
+                gmtoffset: number;
+                timezone: string;
+                start: Date;
+                end: Date;
+            };
+            post: {
+                gmtoffset: number;
+                timezone: string;
+                start: Date;
+                end: Date;
+            };
+        };
+        dataGranularity: string;
+        range: string;
+        validRanges: string[];
+    };
+    quotes: {
+        adjclose?: number | null | undefined;
+        open: number | null;
+        volume: number | null;
+        date: Date;
+        high: number | null;
+        low: number | null;
+        close: number | null;
+    }[];
+}>;
+export declare function getStockInfo(ticker: string): Promise<Record<string, unknown>>;
+export declare function getNews(ticker: string): Promise<{
+    thumbnail?: {
+        resolutions: {
+            url: string;
+            width: number;
+            height: number;
+            tag: string;
+        }[];
+    } | undefined;
+    relatedTickers?: string[] | undefined;
+    type: string;
+    link: string;
+    uuid: string;
+    title: string;
+    publisher: string;
+    providerPublishTime: Date;
+}[]>;
+export declare function getStockActions(ticker: string): Promise<{
+    dividends: {
+        date: Date;
+        amount: number;
+    }[];
+    splits: {
+        date: Date;
+        numerator: number;
+        denominator: number;
+        splitRatio: string;
+    }[];
+}>;
+export declare function getFinancialStatement(ticker: string, financialType: FinancialType): Promise<unknown[]>;
+export declare function getHolderInfo(ticker: string, holderType: HolderType): Promise<unknown>;
+export declare function getOptionDates(ticker: string): Promise<string[]>;
+export declare function getOptionChain(ticker: string, expirationDate: string, optionType: OptionType): Promise<{
+    currency?: string | undefined;
+    openInterest?: number | undefined;
+    volume?: number | undefined;
+    bid?: number | undefined;
+    ask?: number | undefined;
+    percentChange?: number | undefined;
+    strike: number;
+    contractSymbol: string;
+    lastPrice: number;
+    change: number;
+    contractSize: "REGULAR";
+    expiration: Date;
+    lastTradeDate: Date;
+    impliedVolatility: number;
+    inTheMoney: boolean;
+}[]>;
+export declare function getRecommendations(ticker: string, recommendationType: string): Promise<unknown[]>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,UAAU,EACX,MAAM,YAAY,CAAC;AAKpB,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAmBhE;AAwBD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAO7B;AAID,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAQlC;AAID,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;KAG3C;AAID,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;GAQnD;AAsBD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,OAAO,EAAE,CAAC,CAOpB;AAsBD,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,OAAO,CAAC,CASlB;AAID,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKtE;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,UAAU;;;;;;;;;;;;;;;;KAQvB;AAID,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,OAAO,EAAE,CAAC,CAYpB"}

package/dist/api.js

@@ -0,0 +1,148 @@
+import yahooFinance from "yahoo-finance2";
+// Suppress noisy console validation warnings from yahoo-finance2
+yahooFinance.setGlobalConfig({ validation: { logErrors: false } });
+/** Convert yfinance-style period string to a start Date */
+export function periodToStartDate(period) {
+    const now = new Date();
+    const y = now.getFullYear();
+    const m = now.getMonth();
+    const d = now.getDate();
+    switch (period) {
+        case "1d": return new Date(y, m, d - 1);
+        case "5d": return new Date(y, m, d - 5);
+        case "1mo": return new Date(y, m - 1, d);
+        case "3mo": return new Date(y, m - 3, d);
+        case "6mo": return new Date(y, m - 6, d);
+        case "1y": return new Date(y - 1, m, d);
+        case "2y": return new Date(y - 2, m, d);
+        case "5y": return new Date(y - 5, m, d);
+        case "10y": return new Date(y - 10, m, d);
+        case "ytd": return new Date(y, 0, 1);
+        case "max": return new Date(1970, 0, 1);
+        default: return new Date(y, m - 1, d);
+    }
+}
+/** Wrapper that returns Record<string,unknown> to avoid unexportable-type errors (TS4058) */
+async function callQuoteSummary(ticker, modules) {
+    const result = await yahooFinance.quoteSummary(ticker, { modules });
+    return result;
+}
+// --- Historical Prices ---
+export async function getHistoricalPrices(ticker, period, interval) {
+    const period1 = periodToStartDate(period);
+    return yahooFinance.chart(ticker, {
+        period1,
+        interval: interval,
+    });
+}
+// --- Stock Info ---
+export async function getStockInfo(ticker) {
+    return callQuoteSummary(ticker, [
+        "price",
+        "summaryProfile",
+        "defaultKeyStatistics",
+        "financialData",
+        "summaryDetail",
+    ]);
+}
+// --- News ---
+export async function getNews(ticker) {
+    const result = await yahooFinance.search(ticker, { newsCount: 20 });
+    return result.news ?? [];
+}
+// --- Stock Actions (dividends + splits) ---
+export async function getStockActions(ticker) {
+    const result = await yahooFinance.chart(ticker, {
+        period1: new Date(1970, 0, 1),
+        interval: "1d",
+    });
+    const dividends = Object.values(result.events?.dividends ?? {});
+    const splits = Object.values(result.events?.splits ?? {});
+    return { dividends, splits };
+}
+// --- Financial Statement ---
+const financialModuleMap = {
+    income_stmt: "incomeStatementHistory",
+    quarterly_income_stmt: "incomeStatementHistoryQuarterly",
+    balance_sheet: "balanceSheetHistory",
+    quarterly_balance_sheet: "balanceSheetHistoryQuarterly",
+    cashflow: "cashflowStatementHistory",
+    quarterly_cashflow: "cashflowStatementHistoryQuarterly",
+};
+const financialDataKey = {
+    income_stmt: "incomeStatementHistory",
+    quarterly_income_stmt: "incomeStatementHistory",
+    balance_sheet: "balanceSheetStatements",
+    quarterly_balance_sheet: "balanceSheetStatements",
+    cashflow: "cashflowStatements",
+    quarterly_cashflow: "cashflowStatements",
+};
+export async function getFinancialStatement(ticker, financialType) {
+    const module = financialModuleMap[financialType];
+    const summary = await callQuoteSummary(ticker, [module]);
+    const moduleData = summary[module];
+    if (!moduleData || typeof moduleData !== "object")
+        return [];
+    const statements = moduleData[financialDataKey[financialType]];
+    return Array.isArray(statements) ? statements : [];
+}
+// --- Holder Info ---
+const holderModuleMap = {
+    major_holders: "majorHoldersBreakdown",
+    institutional_holders: "institutionOwnership",
+    mutualfund_holders: "fundOwnership",
+    insider_transactions: "insiderTransactions",
+    insider_purchases: "netSharePurchaseActivity",
+    insider_roster_holders: "insiderHolders",
+};
+const holderDataKey = {
+    major_holders: null,
+    institutional_holders: "ownershipList",
+    mutualfund_holders: "ownershipList",
+    insider_transactions: "transactions",
+    insider_purchases: null,
+    insider_roster_holders: "holders",
+};
+export async function getHolderInfo(ticker, holderType) {
+    const module = holderModuleMap[holderType];
+    const summary = await callQuoteSummary(ticker, [module]);
+    const moduleData = summary[module];
+    if (!moduleData)
+        return null;
+    const dataKey = holderDataKey[holderType];
+    if (!dataKey)
+        return moduleData;
+    return moduleData[dataKey] ?? moduleData;
+}
+// --- Options ---
+export async function getOptionDates(ticker) {
+    const result = await yahooFinance.options(ticker, {});
+    return (result.expirationDates ?? []).map((d) => d instanceof Date ? d.toISOString().split("T")[0] : String(d));
+}
+export async function getOptionChain(ticker, expirationDate, optionType) {
+    const result = await yahooFinance.options(ticker, {
+        date: new Date(expirationDate),
+    });
+    const chain = result.options?.[0];
+    if (!chain)
+        return [];
+    return optionType === "calls" ? chain.calls : chain.puts;
+}
+// --- Recommendations ---
+export async function getRecommendations(ticker, recommendationType) {
+    if (recommendationType === "recommendations") {
+        const summary = await callQuoteSummary(ticker, ["recommendationTrend"]);
+        const trend = summary["recommendationTrend"];
+        if (!trend || typeof trend !== "object")
+            return [];
+        return trend["trend"] ?? [];
+    }
+    else {
+        const summary = await callQuoteSummary(ticker, ["upgradeDowngradeHistory"]);
+        const hist = summary["upgradeDowngradeHistory"];
+        if (!hist || typeof hist !== "object")
+            return [];
+        return hist["history"] ?? [];
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,410 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { createApiError, createNotFoundError, truncateToLimit, paginationSchema, applyPagination, } from "@fre4x/mcp-shared";
+import { getHistoricalPrices, getStockInfo, getNews, getStockActions, getFinancialStatement, getHolderInfo, getOptionDates, getOptionChain, getRecommendations, } from "./api.js";
+const server = new McpServer({
+    name: "yahoo-finance-mcp-server",
+    version: "1.0.0",
+});
+// --- Formatters ---
+function formatTable(rows, title) {
+    if (!rows || rows.length === 0)
+        return "No data available.";
+    const keys = Object.keys(rows[0]);
+    const header = `| ${keys.join(" | ")} |`;
+    const divider = `| ${keys.map(() => "---").join(" | ")} |`;
+    const body = rows.map((row) => `| ${keys.map((k) => String(row[k] ?? "")).join(" | ")} |`);
+    return (title ? `## ${title}\n\n` : "") + [header, divider, ...body].join("\n");
+}
+function formatObject(obj, title) {
+    const lines = Object.entries(obj)
+        .filter(([, v]) => v !== null && v !== undefined)
+        .map(([k, v]) => {
+        const val = typeof v === "object" ? JSON.stringify(v) : String(v);
+        return `- **${k}**: ${val}`;
+    });
+    return (title ? `## ${title}\n\n` : "") + lines.join("\n");
+}
+function extractRaw(v) {
+    if (v !== null && typeof v === "object" && "raw" in v) {
+        return v.raw;
+    }
+    return v;
+}
+function flattenFinancialItem(item) {
+    if (!item || typeof item !== "object")
+        return {};
+    const result = {};
+    for (const [k, v] of Object.entries(item)) {
+        if (v instanceof Date) {
+            result[k] = v.toISOString().split("T")[0];
+        }
+        else if (v !== null && typeof v === "object" && "raw" in v) {
+            result[k] = v.raw;
+        }
+        else if (v !== null && typeof v !== "object") {
+            result[k] = v;
+        }
+    }
+    return result;
+}
+// --- Tools ---
+server.registerTool("yfin_get_historical_prices", {
+    title: "Get Historical Stock Prices",
+    description: "Get historical OHLCV stock price data for a ticker.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+        period: z
+            .enum(["1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max"])
+            .default("1mo")
+            .describe("Time period"),
+        interval: z
+            .enum(["1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo"])
+            .default("1d")
+            .describe("Bar interval"),
+        ...paginationSchema.shape,
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker, period, interval, limit, offset }) => {
+    try {
+        const result = await getHistoricalPrices(ticker, period, interval);
+        const quotes = result.quotes ?? [];
+        if (quotes.length === 0) {
+            return createNotFoundError(`No historical data for '${ticker}'.`);
+        }
+        const { items, total, hasMore } = applyPagination(quotes, { limit, offset });
+        const rows = items.map((q) => ({
+            date: q.date instanceof Date ? q.date.toISOString().split("T")[0] : String(q.date),
+            open: q.open?.toFixed(2) ?? "",
+            high: q.high?.toFixed(2) ?? "",
+            low: q.low?.toFixed(2) ?? "",
+            close: q.close?.toFixed(2) ?? "",
+            volume: q.volume ?? "",
+            adjclose: q.adjclose?.toFixed(2) ?? "",
+        }));
+        const text = formatTable(rows, `Historical Prices — ${ticker} (${period}, ${interval})`) +
+            `\n\n*Showing ${items.length}/${total} bars${hasMore ? " · more available" : ""}*`;
+        return { content: [{ type: "text", text: truncateToLimit(text) }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("yfin_get_stock_info", {
+    title: "Get Stock Info",
+    description: "Get comprehensive stock info including price, profile, and financials.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker }) => {
+    try {
+        const rawSummary = await getStockInfo(ticker);
+        const summary = rawSummary;
+        const sections = [];
+        const price = summary.price;
+        if (price) {
+            sections.push(`## ${price.longName ?? ticker} (${ticker})\n` +
+                `- **Price**: ${price.regularMarketPrice ?? "N/A"} ${price.currency ?? ""}\n` +
+                `- **Change**: ${typeof price.regularMarketChange === "number" ? price.regularMarketChange.toFixed(2) : "N/A"} ` +
+                `(${typeof price.regularMarketChangePercent === "number" ? price.regularMarketChangePercent.toFixed(2) : "N/A"}%)\n` +
+                `- **Market Cap**: ${price.marketCap ?? "N/A"}\n` +
+                `- **Exchange**: ${price.exchangeName ?? "N/A"}`);
+        }
+        const profile = summary.summaryProfile;
+        if (profile) {
+            sections.push(`## Company Profile\n` +
+                `- **Sector**: ${profile.sector ?? "N/A"}\n` +
+                `- **Industry**: ${profile.industry ?? "N/A"}\n` +
+                `- **Country**: ${profile.country ?? "N/A"}\n` +
+                `- **Employees**: ${profile.fullTimeEmployees ?? "N/A"}\n` +
+                (profile.longBusinessSummary
+                    ? `\n${profile.longBusinessSummary.substring(0, 500)}...`
+                    : ""));
+        }
+        const fin = summary.financialData;
+        if (fin) {
+            sections.push(`## Financial Data\n` +
+                `- **Revenue**: ${fin.totalRevenue ?? "N/A"}\n` +
+                `- **Gross Profit**: ${fin.grossProfits ?? "N/A"}\n` +
+                `- **EBITDA**: ${fin.ebitda ?? "N/A"}\n` +
+                `- **Free Cashflow**: ${fin.freeCashflow ?? "N/A"}\n` +
+                `- **Return on Equity**: ${fin.returnOnEquity ?? "N/A"}\n` +
+                `- **Recommendation**: ${fin.recommendationKey ?? "N/A"}`);
+        }
+        const stats = summary.defaultKeyStatistics;
+        const detail = summary.summaryDetail;
+        if (stats) {
+            sections.push(`## Key Statistics\n` +
+                `- **Beta**: ${stats.beta ?? "N/A"}\n` +
+                `- **PE Ratio (Forward)**: ${stats.forwardPE ?? "N/A"}\n` +
+                `- **EPS (Forward)**: ${stats.forwardEps ?? "N/A"}\n` +
+                `- **52w High**: ${detail?.fiftyTwoWeekHigh ?? "N/A"}\n` +
+                `- **52w Low**: ${detail?.fiftyTwoWeekLow ?? "N/A"}\n` +
+                `- **Shares Outstanding**: ${stats.sharesOutstanding ?? "N/A"}\n` +
+                `- **Float Shares**: ${stats.floatShares ?? "N/A"}`);
+        }
+        const text = sections.join("\n\n");
+        return { content: [{ type: "text", text: truncateToLimit(text) }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("yfin_get_news", {
+    title: "Get Yahoo Finance News",
+    description: "Get latest news articles for a ticker symbol.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+        ...paginationSchema.shape,
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker, limit, offset }) => {
+    try {
+        const news = await getNews(ticker);
+        if (!news || news.length === 0) {
+            return createNotFoundError(`No news found for '${ticker}'.`);
+        }
+        const { items, total } = applyPagination(news, { limit, offset });
+        const rows = items.map((n) => ({
+            title: n.title ?? "",
+            publisher: n.publisher ?? "",
+            link: n.link ?? "",
+            published: n.providerPublishTime instanceof Date
+                ? n.providerPublishTime.toISOString().split("T")[0]
+                : String(n.providerPublishTime ?? ""),
+        }));
+        const text = formatTable(rows, `News — ${ticker}`) +
+            `\n\n*Showing ${items.length}/${total} articles*`;
+        return { content: [{ type: "text", text: truncateToLimit(text) }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("yfin_get_stock_actions", {
+    title: "Get Stock Actions",
+    description: "Get stock dividend and split history.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker }) => {
+    try {
+        const { dividends, splits } = await getStockActions(ticker);
+        const sections = [];
+        if (dividends.length > 0) {
+            const divRows = dividends.map((d) => ({
+                date: d.date instanceof Date ? d.date.toISOString().split("T")[0] : String(d.date),
+                amount: String(d.amount),
+            }));
+            sections.push(formatTable(divRows, "Dividends"));
+        }
+        else {
+            sections.push("## Dividends\nNo dividend history.");
+        }
+        if (splits.length > 0) {
+            const splitRows = splits.map((s) => ({
+                date: s.date instanceof Date ? s.date.toISOString().split("T")[0] : String(s.date),
+                ratio: s.splitRatio ?? `${s.numerator}:${s.denominator}`,
+            }));
+            sections.push(formatTable(splitRows, "Stock Splits"));
+        }
+        else {
+            sections.push("## Stock Splits\nNo split history.");
+        }
+        return { content: [{ type: "text", text: truncateToLimit(sections.join("\n\n")) }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("yfin_get_financial_statement", {
+    title: "Get Financial Statement",
+    description: "Get income statement, balance sheet, or cashflow for a ticker.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+        financial_type: z
+            .enum([
+            "income_stmt",
+            "quarterly_income_stmt",
+            "balance_sheet",
+            "quarterly_balance_sheet",
+            "cashflow",
+            "quarterly_cashflow",
+        ])
+            .describe("Type of financial statement"),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker, financial_type }) => {
+    try {
+        const statements = await getFinancialStatement(ticker, financial_type);
+        if (!statements || statements.length === 0) {
+            return createNotFoundError(`No ${financial_type} data for '${ticker}'.`);
+        }
+        const rows = statements.map((s) => flattenFinancialItem(s));
+        const text = formatTable(rows, `${financial_type.replace(/_/g, " ").toUpperCase()} — ${ticker}`);
+        return { content: [{ type: "text", text: truncateToLimit(text) }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("yfin_get_holder_info", {
+    title: "Get Holder Info",
+    description: "Get major, institutional, mutual fund, or insider holder data.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+        holder_type: z
+            .enum([
+            "major_holders",
+            "institutional_holders",
+            "mutualfund_holders",
+            "insider_transactions",
+            "insider_purchases",
+            "insider_roster_holders",
+        ])
+            .describe("Type of holder information"),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker, holder_type }) => {
+    try {
+        const data = await getHolderInfo(ticker, holder_type);
+        if (!data) {
+            return createNotFoundError(`No ${holder_type} data for '${ticker}'.`);
+        }
+        let text;
+        if (Array.isArray(data)) {
+            const rows = data.map((item) => flattenFinancialItem(item));
+            text = formatTable(rows, `${holder_type.replace(/_/g, " ").toUpperCase()} — ${ticker}`);
+        }
+        else {
+            const flat = {};
+            for (const [k, v] of Object.entries(data)) {
+                flat[k] = extractRaw(v);
+            }
+            text = formatObject(flat, `${holder_type.replace(/_/g, " ").toUpperCase()} — ${ticker}`);
+        }
+        return { content: [{ type: "text", text: truncateToLimit(text) }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("yfin_get_option_dates", {
+    title: "Get Option Expiration Dates",
+    description: "Get available option expiration dates for a ticker.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker }) => {
+    try {
+        const dates = await getOptionDates(ticker);
+        if (!dates || dates.length === 0) {
+            return createNotFoundError(`No option dates for '${ticker}'.`);
+        }
+        const text = `## Option Expiration Dates — ${ticker}\n\n` + dates.map((d) => `- ${d}`).join("\n");
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("yfin_get_option_chain", {
+    title: "Get Option Chain",
+    description: "Get calls or puts option chain for a ticker and expiration date.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+        expiration_date: z.string().describe("Expiration date YYYY-MM-DD"),
+        option_type: z.enum(["calls", "puts"]).describe("Option type"),
+        ...paginationSchema.shape,
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker, expiration_date, option_type, limit, offset }) => {
+    try {
+        const chain = await getOptionChain(ticker, expiration_date, option_type);
+        if (!chain || chain.length === 0) {
+            return createNotFoundError(`No ${option_type} options for '${ticker}' expiring ${expiration_date}.`);
+        }
+        const { items, total } = applyPagination(chain, { limit, offset });
+        const rows = items.map((o) => ({
+            contractSymbol: o.contractSymbol ?? "",
+            strike: o.strike ?? "",
+            lastPrice: o.lastPrice ?? "",
+            bid: o.bid ?? "",
+            ask: o.ask ?? "",
+            volume: o.volume ?? "",
+            openInterest: o.openInterest ?? "",
+            impliedVolatility: typeof o.impliedVolatility === "number"
+                ? o.impliedVolatility.toFixed(4)
+                : "",
+        }));
+        const text = formatTable(rows, `${option_type.toUpperCase()} — ${ticker} (${expiration_date})`) +
+            `\n\n*Showing ${items.length}/${total} contracts*`;
+        return { content: [{ type: "text", text: truncateToLimit(text) }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+server.registerTool("yfin_get_recommendations", {
+    title: "Get Analyst Recommendations",
+    description: "Get analyst recommendations or upgrade/downgrade history.",
+    inputSchema: z.object({
+        ticker: z.string().describe("Ticker symbol e.g. 'AAPL'"),
+        recommendation_type: z
+            .enum(["recommendations", "upgrades_downgrades"])
+            .default("recommendations")
+            .describe("Type of recommendation data"),
+        months_back: z
+            .number()
+            .int()
+            .min(1)
+            .max(120)
+            .default(12)
+            .describe("Months back for upgrades/downgrades"),
+        ...paginationSchema.shape,
+    }),
+    annotations: { readOnlyHint: true, openWorldHint: true },
+}, async ({ ticker, recommendation_type, months_back, limit, offset }) => {
+    try {
+        let data = await getRecommendations(ticker, recommendation_type);
+        if (!data || data.length === 0) {
+            return createNotFoundError(`No ${recommendation_type} data for '${ticker}'.`);
+        }
+        // Filter upgrades_downgrades by months_back
+        if (recommendation_type === "upgrades_downgrades") {
+            const cutoff = new Date();
+            cutoff.setMonth(cutoff.getMonth() - months_back);
+            data = data.filter((item) => {
+                const d = item.epochGradeDate;
+                if (d instanceof Date)
+                    return d >= cutoff;
+                if (typeof d === "number")
+                    return new Date(d * 1000) >= cutoff;
+                return true;
+            });
+        }
+        const { items, total } = applyPagination(data, { limit, offset });
+        const rows = items.map((item) => flattenFinancialItem(item));
+        const text = formatTable(rows, `${recommendation_type.replace(/_/g, " ").toUpperCase()} — ${ticker}`) +
+            `\n\n*Showing ${items.length}/${total} items*`;
+        return { content: [{ type: "text", text: truncateToLimit(text) }] };
+    }
+    catch (err) {
+        return createApiError(err instanceof Error ? err.message : String(err));
+    }
+});
+// --- Start Server ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+export type HistoricalInterval = "1m" | "2m" | "5m" | "15m" | "30m" | "60m" | "90m" | "1h" | "1d" | "5d" | "1wk" | "1mo" | "3mo";
+export type HistoricalPeriod = "1d" | "5d" | "1mo" | "3mo" | "6mo" | "1y" | "2y" | "5y" | "10y" | "ytd" | "max";
+export type FinancialType = "income_stmt" | "quarterly_income_stmt" | "balance_sheet" | "quarterly_balance_sheet" | "cashflow" | "quarterly_cashflow";
+export type HolderType = "major_holders" | "institutional_holders" | "mutualfund_holders" | "insider_transactions" | "insider_purchases" | "insider_roster_holders";
+export type RecommendationType = "recommendations" | "upgrades_downgrades";
+export type OptionType = "calls" | "puts";
+export interface HistoricalQuote {
+    date: Date;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    adjclose?: number;
+}
+export interface NewsItem {
+    title: string;
+    publisher: string;
+    link: string;
+    providerPublishTime?: Date;
+    type?: string;
+    uuid?: string;
+    relatedTickers?: string[];
+}
+export interface DividendEvent {
+    date: Date;
+    amount: number;
+}
+export interface SplitEvent {
+    date: Date;
+    numerator: number;
+    denominator: number;
+    splitRatio: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAC1B,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAClD,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GACxB,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GACnC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE/C,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,uBAAuB,GACvB,eAAe,GACf,yBAAyB,GACzB,UAAU,GACV,oBAAoB,CAAC;AAEzB,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,uBAAuB,GACvB,oBAAoB,GACpB,sBAAsB,GACtB,mBAAmB,GACnB,wBAAwB,CAAC;AAE7B,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,qBAAqB,CAAC;AAE3E,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,CAAC,EAAE,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Yahoo Finance TypeScript types
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iCAAiC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@fre4x/yahoo-finance",
+  "version": "1.0.1",
+  "description": "A Yahoo Finance MCP server for LLMs.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "yahoo-finance": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "watch": "tsc -w"
+  },
+  "keywords": [
+    "mcp",
+    "yahoo-finance",
+    "stocks",
+    "mcp-server",
+    "ai"
+  ],
+  "author": "fritzprix",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "yahoo-finance2": "^2.13.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}