@cyanheads/secedgar-mcp-server 0.6.3 → 0.7.0

package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.js

@@ -0,0 +1,258 @@
+/**
+ * @fileoverview Fetch Form 4 insider transactions (purchases, sales, awards, exercises)
+ * for a company by parsing ownership XML from SEC EDGAR.
+ * @module mcp-server/tools/definitions/get-insider-transactions
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEdgarApiService } from '../../../services/edgar/edgar-api-service.js';
+import { parseForm4Xml, } from '../../../services/edgar/ownership-parser.js';
+/** Transaction type filter → SEC transaction codes. */
+const PURCHASE_CODES = new Set(['P']);
+const SALE_CODES = new Set(['S']);
+function matchesFilter(tx, filter) {
+    if (filter === 'all')
+        return true;
+    if (filter === 'purchase')
+        return PURCHASE_CODES.has(tx.transaction_code);
+    if (filter === 'sale')
+        return SALE_CODES.has(tx.transaction_code);
+    return true;
+}
+/** Build a human-readable relationship string from reporting owner flags. */
+function ownerRelationship(owner) {
+    const parts = [];
+    if (owner.is_director)
+        parts.push('Director');
+    if (owner.is_officer) {
+        parts.push(owner.officer_title ? `Officer (${owner.officer_title})` : 'Officer');
+    }
+    if (owner.is_ten_percent_owner)
+        parts.push('10% Owner');
+    if (owner.is_other)
+        parts.push('Other');
+    return parts.join(', ') || 'Unknown';
+}
+export const getInsiderTransactionsTool = tool('secedgar_get_insider_transactions', {
+    title: 'Get Insider Transactions',
+    description: 'Fetch Form 4 insider transactions (purchases, sales, grants, exercises) for a company by parsing SEC EDGAR ownership XML. Returns the reporting person, their relationship to the issuer, transaction date, type, shares traded, price per share, and shares owned after the transaction. Covers nonDerivative transactions (open-market buys/sells, gifts) and derivative transactions (option exercises, RSU vests). Use secedgar_search_filings with forms=["4"] for broader date-range queries or to search across all companies.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    errors: [
+        {
+            reason: 'company_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The ticker or CIK does not resolve to a known company',
+            recovery: 'Use secedgar_company_search to find the correct ticker or CIK.',
+        },
+        {
+            reason: 'no_filings_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No Form 4 filings exist for this company in the recent submissions window',
+            recovery: 'Use secedgar_search_filings with forms=["4"] for broader historical coverage.',
+        },
+    ],
+    input: z.object({
+        ticker_or_cik: z
+            .string()
+            .min(1)
+            .describe('Company ticker symbol (e.g., "AAPL") or 10-digit CIK number (e.g., "0000320193"). The issuer, not the reporting person.'),
+        transaction_type: z
+            .enum(['purchase', 'sale', 'all'])
+            .default('all')
+            .describe('Filter by direction. "purchase" = open-market buys (code P). "sale" = open-market sells (code S). "all" includes grants, awards, exercises, gifts, and other coded transaction types as well.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(20)
+            .describe('Maximum number of transactions to return across all Form 4 filings fetched. Filings are scanned newest-first. Default 20.'),
+    }),
+    output: z.object({
+        issuer_name: z.string().describe('Issuer entity name (SEC-conformed).'),
+        issuer_cik: z.string().describe('Issuer CIK, zero-padded to 10 digits.'),
+        issuer_ticker: z.string().optional().describe('Issuer ticker symbol when available.'),
+        transactions: z
+            .array(z
+            .object({
+            filing_date: z.string().describe('Date the Form 4 was filed (YYYY-MM-DD).'),
+            period_of_report: z
+                .string()
+                .optional()
+                .describe('Transaction date per the filing period (YYYY-MM-DD).'),
+            accession_number: z
+                .string()
+                .describe('Form 4 accession number — pass to secedgar_get_filing for the raw XML.'),
+            reporting_person: z.string().describe('Name of the insider who filed the Form 4.'),
+            relationship: z
+                .string()
+                .describe('Relationship to issuer (e.g., "Director", "Officer (CEO)", "10% Owner").'),
+            security_title: z.string().describe('Security type (e.g., "Common Stock").'),
+            transaction_date: z
+                .string()
+                .optional()
+                .describe('Date the transaction occurred (YYYY-MM-DD). Absent on some filings.'),
+            transaction_code: z
+                .string()
+                .describe('Single-letter SEC transaction code: P = purchase, S = sale, M = exercise, A = award, G = gift, F = tax withholding, C = conversion, others exist.'),
+            transaction_type: z
+                .string()
+                .describe('Human-readable description of the transaction code (e.g., "purchase", "sale", "conversion_of_derivative").'),
+            is_derivative: z
+                .boolean()
+                .describe('True for derivative security transactions (options, RSUs, convertible notes). False for direct equity transactions.'),
+            shares_traded: z
+                .number()
+                .optional()
+                .describe('Shares involved. Negative = disposal (sale, return, gift), positive = acquisition. Absent when the filing omits this field.'),
+            price_per_share: z
+                .number()
+                .optional()
+                .describe('Price per share in USD. 0 for gifts and RSU awards (no cash consideration). Absent when not reported.'),
+            shares_owned_after: z
+                .number()
+                .optional()
+                .describe('Total shares owned after this transaction, as reported. Absent when omitted by the filer.'),
+            ownership_type: z
+                .enum(['direct', 'indirect'])
+                .optional()
+                .describe('D = direct ownership, I = indirect (through a trust, family member, etc.). Absent when not reported.'),
+            ownership_nature: z
+                .string()
+                .optional()
+                .describe('Nature of indirect ownership (e.g., "By Trust", "By Spouse"). Only present when ownership_type is indirect.'),
+        })
+            .describe('One insider transaction parsed from a Form 4 filing.'))
+            .describe('Insider transactions, newest filing first.'),
+        filings_scanned: z.number().describe('Number of Form 4 filings scanned to produce the result.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance when results are empty after filtering — explains the filter applied and suggests alternatives.'),
+    },
+    async handler(input, ctx) {
+        const api = getEdgarApiService();
+        // Resolve company to CIK
+        const resolved = await api.resolveCik(input.ticker_or_cik);
+        const match = Array.isArray(resolved) ? resolved[0] : resolved;
+        if (!match || (Array.isArray(resolved) && resolved.length === 0)) {
+            throw ctx.fail('company_not_found', `Company '${input.ticker_or_cik}' not found.`, {
+                ...ctx.recoveryFor('company_not_found'),
+            });
+        }
+        // Fetch recent Form 4 filing metadata from submissions API
+        // We over-fetch by 5x to account for multi-transaction filings and filter losses.
+        const filingBatch = await api.getRecentFilingsByForm(match.cik, ['4', '4/A'], Math.min(input.limit * 5, 100));
+        if (filingBatch.length === 0) {
+            throw ctx.fail('no_filings_found', `No Form 4 filings found for '${input.ticker_or_cik}'.`, {
+                ...ctx.recoveryFor('no_filings_found'),
+            });
+        }
+        const transactions = [];
+        let filingsScanned = 0;
+        for (const filing of filingBatch) {
+            if (transactions.length >= input.limit)
+                break;
+            // primaryDocument may be prefixed with xslF345X06/ — strip to get the bare filename
+            const docName = filing.primaryDocument.replace(/^xsl[^/]+\//, '');
+            const xmlText = await api.tryGetFilingDocument(match.cik, filing.accessionNumber, docName);
+            if (!xmlText)
+                continue;
+            filingsScanned++;
+            let parsed;
+            try {
+                parsed = parseForm4Xml(xmlText);
+            }
+            catch {
+                // Malformed XML in edge cases — skip and continue
+                ctx.log.warning('Failed to parse Form 4 XML', {
+                    accessionNumber: filing.accessionNumber,
+                });
+                continue;
+            }
+            // Build a single primary owner label from the first reporting owner
+            const primaryOwner = parsed.reporting_owners[0];
+            const personName = primaryOwner?.name ?? 'Unknown';
+            const relationship = primaryOwner ? ownerRelationship(primaryOwner) : 'Unknown';
+            for (const tx of parsed.transactions) {
+                if (!matchesFilter(tx, input.transaction_type))
+                    continue;
+                if (transactions.length >= input.limit)
+                    break;
+                transactions.push({
+                    filing_date: filing.filingDate,
+                    period_of_report: parsed.period_of_report,
+                    accession_number: filing.accessionNumber,
+                    reporting_person: personName,
+                    relationship,
+                    security_title: tx.security_title,
+                    transaction_date: tx.transaction_date,
+                    transaction_code: tx.transaction_code,
+                    transaction_type: tx.transaction_type,
+                    is_derivative: tx.is_derivative,
+                    shares_traded: tx.shares_traded,
+                    price_per_share: tx.price_per_share,
+                    shares_owned_after: tx.shares_owned_after,
+                    ownership_type: tx.ownership_type,
+                    ownership_nature: tx.ownership_nature,
+                });
+            }
+        }
+        if (transactions.length === 0) {
+            const filterNote = input.transaction_type !== 'all'
+                ? ` with transaction_type="${input.transaction_type}"`
+                : '';
+            ctx.enrich.notice(`No insider transactions found for '${input.ticker_or_cik}'${filterNote} in the ${filingsScanned} most recent Form 4 filings. ` +
+                `Try transaction_type="all" or use secedgar_search_filings with forms=["4"] for broader coverage.`);
+        }
+        ctx.log.info('Insider transactions retrieved', {
+            cik: match.cik,
+            filingsScanned,
+            transactionCount: transactions.length,
+            filter: input.transaction_type,
+        });
+        // Use issuer data from the first successfully parsed filing when available
+        // (the submissions API may not always surface ticker in the same place)
+        const issuerTicker = match.ticker ?? undefined;
+        return {
+            issuer_name: match.name ?? input.ticker_or_cik,
+            issuer_cik: match.cik,
+            issuer_ticker: issuerTicker,
+            transactions,
+            filings_scanned: filingsScanned,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Insider Transactions** — ${result.issuer_name} (CIK ${result.issuer_cik}${result.issuer_ticker ? `, ${result.issuer_ticker}` : ''})`,
+            `${result.transactions.length} transaction(s) from ${result.filings_scanned} Form 4 filing(s) scanned`,
+        ];
+        for (const tx of result.transactions) {
+            lines.push('');
+            const sharesStr = tx.shares_traded !== undefined
+                ? tx.shares_traded < 0
+                    ? `${Math.abs(tx.shares_traded).toLocaleString()} shares disposed`
+                    : `${tx.shares_traded.toLocaleString()} shares acquired`
+                : 'shares not reported';
+            const priceStr = tx.price_per_share !== undefined ? `@ $${tx.price_per_share.toFixed(2)}` : '';
+            const ownedStr = tx.shares_owned_after !== undefined
+                ? ` | owns ${tx.shares_owned_after.toLocaleString()} after`
+                : '';
+            const derivStr = tx.is_derivative ? ' [derivative]' : '';
+            const ownershipStr = tx.ownership_nature
+                ? ` (${tx.ownership_type ?? 'indirect'}: ${tx.ownership_nature})`
+                : tx.ownership_type
+                    ? ` (${tx.ownership_type})`
+                    : '';
+            lines.push(`**${tx.reporting_person}** (${tx.relationship}) — ${tx.transaction_type}${derivStr}`);
+            const txDate = tx.transaction_date ?? tx.filing_date;
+            const periodStr = tx.period_of_report ? ` | report period: ${tx.period_of_report}` : '';
+            lines.push(`${txDate} | ${tx.security_title} | ${sharesStr} ${priceStr}${ownedStr}${ownershipStr}${periodStr}`);
+            lines.push(`Code: ${tx.transaction_code} | Filed: ${tx.filing_date} [${tx.accession_number}]`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-insider-transactions.tool.js.map

package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-insider-transactions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-insider-transactions.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Fetch 13F-HR quarterly institutional holdings by parsing the SEC EDGAR
+ * information table XML. Works for both issuer lookup (which institutions hold a stock)
+ * and institution lookup (what a specific institution holds).
+ * @module mcp-server/tools/definitions/get-institutional-holdings
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getInstitutionalHoldingsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    ticker_or_cik: z.ZodString;
+    quarter: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    filer_name: z.ZodString;
+    filer_cik: z.ZodString;
+    reporting_period: z.ZodOptional<z.ZodString>;
+    filing_date: z.ZodString;
+    accession_number: z.ZodString;
+    total_holdings_in_filing: z.ZodNumber;
+    holdings: z.ZodArray<z.ZodObject<{
+        issuer_name: z.ZodString;
+        title_of_class: z.ZodOptional<z.ZodString>;
+        cusip: z.ZodOptional<z.ZodString>;
+        value_in_thousands: z.ZodOptional<z.ZodNumber>;
+        shares_or_principal_amount: z.ZodOptional<z.ZodNumber>;
+        shares_or_principal_type: z.ZodOptional<z.ZodEnum<{
+            SH: "SH";
+            PRN: "PRN";
+        }>>;
+        put_call: z.ZodOptional<z.ZodEnum<{
+            Put: "Put";
+            Call: "Call";
+        }>>;
+        investment_discretion: z.ZodOptional<z.ZodEnum<{
+            SOLE: "SOLE";
+            DFND: "DFND";
+            OTR: "OTR";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "company_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The ticker or CIK does not resolve to a known company or institution";
+    readonly recovery: "Use secedgar_company_search to find the correct CIK or full entity name.";
+}, {
+    readonly reason: "no_filings_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No 13F-HR filings found for this entity in the recent submissions window";
+    readonly recovery: "Use secedgar_search_filings with forms=[\"13F-HR\"] for broader search, or check that the entity is an institutional investment manager.";
+}, {
+    readonly reason: "no_info_table";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The 13F-HR filing was found but the information table XML document could not be located";
+    readonly recovery: "Use secedgar_get_filing with the accession number to inspect the filing documents directly.";
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=get-institutional-holdings.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-institutional-holdings.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-institutional-holdings.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA6CjE,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmUvC,CAAC"}

package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.js

@@ -0,0 +1,284 @@
+/**
+ * @fileoverview Fetch 13F-HR quarterly institutional holdings by parsing the SEC EDGAR
+ * information table XML. Works for both issuer lookup (which institutions hold a stock)
+ * and institution lookup (what a specific institution holds).
+ * @module mcp-server/tools/definitions/get-institutional-holdings
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEdgarApiService } from '../../../services/edgar/edgar-api-service.js';
+import { parseInfoTableXml } from '../../../services/edgar/ownership-parser.js';
+/**
+ * Parse a quarter string like "2025-Q3" into startDate/endDate for EFTS search.
+ * Returns undefined when the quarter string is absent or malformed.
+ */
+function quarterToDateRange(quarter) {
+    if (!quarter)
+        return;
+    const m = quarter.match(/^(\d{4})-Q([1-4])$/i);
+    if (!m)
+        return;
+    const year = Number(m[1]);
+    const q = Number(m[2]);
+    // 13F filing deadlines: 45 days after quarter end.
+    // Q1 ends Mar 31 → filed by May 15; Q2 ends Jun 30 → by Aug 15; etc.
+    const quarterEndMonth = q * 3; // 3, 6, 9, 12
+    const filingWindowStart = new Date(year, quarterEndMonth - 1, 1).toISOString().slice(0, 10);
+    // Window: from quarter end month to 3 months after (covers the 45-day lag)
+    const filingWindowEndDate = new Date(year, quarterEndMonth + 2, 28);
+    const filingWindowEnd = filingWindowEndDate.toISOString().slice(0, 10);
+    return { startDate: filingWindowStart, endDate: filingWindowEnd };
+}
+/**
+ * Locate the information table XML document in a 13F filing. The holdings table is the
+ * one XML document that is neither the cover page (`primary_doc.xml`) nor an index file —
+ * its name varies (infotable.xml, form13fInfoTable.xml, or a numeric name like 53405.xml),
+ * and the index `type` field carries only a display icon, so selection is name-based.
+ */
+function findInfoTableDocument(items) {
+    const candidates = items.filter((it) => /\.xml$/i.test(it.name) &&
+        it.name.toLowerCase() !== 'primary_doc.xml' &&
+        !it.name.toLowerCase().includes('index'));
+    return (candidates.find((it) => /informationtable|infotable|form13f/i.test(it.name))?.name ??
+        candidates[0]?.name);
+}
+export const getInstitutionalHoldingsTool = tool('secedgar_get_institutional_holdings', {
+    title: 'Get Institutional Holdings',
+    description: 'Fetch 13F-HR quarterly institutional holdings by parsing the SEC EDGAR information table XML. Use ticker_or_cik to look up an institution (e.g., "Vanguard Group" or its CIK) and see what it holds — or pass a company ticker/CIK to find which institutions filed 13Fs covering that period. The 13F information table lists each position: issuer name, CUSIP, shares held, market value (in thousands), and put/call designation for options. Institutions with less than $100M in 13(f) securities are exempt and may not file. Use secedgar_search_filings with forms=["13F-HR"] for broader search.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    errors: [
+        {
+            reason: 'company_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The ticker or CIK does not resolve to a known company or institution',
+            recovery: 'Use secedgar_company_search to find the correct CIK or full entity name.',
+        },
+        {
+            reason: 'no_filings_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No 13F-HR filings found for this entity in the recent submissions window',
+            recovery: 'Use secedgar_search_filings with forms=["13F-HR"] for broader search, or check that the entity is an institutional investment manager.',
+        },
+        {
+            reason: 'no_info_table',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The 13F-HR filing was found but the information table XML document could not be located',
+            recovery: 'Use secedgar_get_filing with the accession number to inspect the filing documents directly.',
+        },
+    ],
+    input: z.object({
+        ticker_or_cik: z
+            .string()
+            .min(1)
+            .describe('Ticker symbol or CIK of the institutional filer (e.g., "0000102909" for Vanguard) or a company name. For institution lookups, CIK or the full legal name resolves most reliably — tickers are typically for operating companies, not fund managers.'),
+        quarter: z
+            .string()
+            .optional()
+            .describe('Reporting quarter to target, in "YYYY-QN" format (e.g., "2025-Q4"). When omitted, returns the most recent 13F-HR available. Quarters map to the filing window: Q4 2025 = filings submitted roughly Jan–Mar 2026.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(500)
+            .default(20)
+            .describe('Maximum number of holdings rows to return. 13F filings from large institutions can contain thousands of positions. Default 20.'),
+    }),
+    output: z.object({
+        filer_name: z.string().describe('Name of the institutional filer (the 13F submitter).'),
+        filer_cik: z.string().describe('CIK of the 13F filer, zero-padded to 10 digits.'),
+        reporting_period: z
+            .string()
+            .optional()
+            .describe('The calendar-quarter end date this 13F covers (YYYY-MM-DD), from the filing cover page. Absent if not surfaced in the filing.'),
+        filing_date: z.string().describe('Date the 13F was submitted (YYYY-MM-DD).'),
+        accession_number: z
+            .string()
+            .describe('Accession number for this 13F-HR filing — pass to secedgar_get_filing for the full document.'),
+        total_holdings_in_filing: z
+            .number()
+            .describe('Total number of infoTable rows in this filing before the limit was applied.'),
+        holdings: z
+            .array(z
+            .object({
+            issuer_name: z.string().describe('Name of the issuer whose securities are held.'),
+            title_of_class: z
+                .string()
+                .optional()
+                .describe('Security class (e.g., "COM", "CL A", "ETF"). Absent when not reported.'),
+            cusip: z
+                .string()
+                .optional()
+                .describe('9-digit CUSIP identifier. Absent when omitted by the filer.'),
+            value_in_thousands: z
+                .number()
+                .optional()
+                .describe('Market value of the position in thousands of USD at the reporting date. Absent when not reported.'),
+            shares_or_principal_amount: z
+                .number()
+                .optional()
+                .describe('Number of shares (for equities) or principal amount (for debt securities). Absent when not reported.'),
+            shares_or_principal_type: z
+                .enum(['SH', 'PRN'])
+                .optional()
+                .describe('SH = share position, PRN = principal amount (bonds, notes). Absent when not reported.'),
+            put_call: z
+                .enum(['Put', 'Call'])
+                .optional()
+                .describe('Options designation. Present only when the row represents a put or call option position.'),
+            investment_discretion: z
+                .enum(['SOLE', 'DFND', 'OTR'])
+                .optional()
+                .describe('SOLE = sole investment discretion, DFND = defined (shared/advised), OTR = other. Absent when not reported.'),
+        })
+            .describe('One row from the 13F information table.'))
+            .describe('Holdings rows from the information table, truncated to limit.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance when no filings were found or the result set is empty — suggests alternatives.'),
+    },
+    async handler(input, ctx) {
+        const api = getEdgarApiService();
+        // Resolve entity to CIK
+        const resolved = await api.resolveCik(input.ticker_or_cik);
+        const match = Array.isArray(resolved) ? resolved[0] : resolved;
+        if (!match || (Array.isArray(resolved) && resolved.length === 0)) {
+            throw ctx.fail('company_not_found', `Entity '${input.ticker_or_cik}' not found.`, {
+                ...ctx.recoveryFor('company_not_found'),
+            });
+        }
+        // Use submissions API for recent 13F filings
+        let filingMeta;
+        if (input.quarter) {
+            // With a quarter filter, use EFTS to search for the filing in the right window
+            const dateRange = quarterToDateRange(input.quarter);
+            if (dateRange) {
+                const eftsResp = await api.searchFilings({
+                    query: `cik:${match.cik}`,
+                    forms: ['13F-HR'],
+                    startDate: dateRange.startDate,
+                    endDate: dateRange.endDate,
+                    from: 0,
+                    size: 5,
+                });
+                const hit = eftsResp.hits.hits.find((h) => h._source.ciks?.includes(match.cik));
+                if (hit) {
+                    filingMeta = {
+                        accessionNumber: hit._source.adsh,
+                        filingDate: hit._source.file_date,
+                        primaryDocument: 'primary_doc.xml',
+                    };
+                }
+            }
+        }
+        if (!filingMeta) {
+            // Fall back to submissions API most-recent
+            const recentFilings = await api.getRecentFilingsByForm(match.cik, ['13F-HR'], 3);
+            filingMeta = recentFilings[0];
+        }
+        if (!filingMeta) {
+            const quarterNote = input.quarter ? ` for quarter "${input.quarter}"` : '';
+            throw ctx.fail('no_filings_found', `No 13F-HR filings found for '${input.ticker_or_cik}'${quarterNote}.`, { ...ctx.recoveryFor('no_filings_found') });
+        }
+        // Get the filing index to find the information table document
+        const filingIndex = await api.tryGetFilingIndex(match.cik, filingMeta.accessionNumber);
+        if (!filingIndex) {
+            throw ctx.fail('no_info_table', `Filing ${filingMeta.accessionNumber} index could not be fetched.`, { ...ctx.recoveryFor('no_info_table') });
+        }
+        const infoTableDoc = findInfoTableDocument(filingIndex.directory.item);
+        if (!infoTableDoc) {
+            throw ctx.fail('no_info_table', `No information table XML found in filing ${filingMeta.accessionNumber}.`, {
+                accession_number: filingMeta.accessionNumber,
+                available_documents: filingIndex.directory.item.map((i) => i.name),
+                ...ctx.recoveryFor('no_info_table'),
+            });
+        }
+        const xmlText = await api.tryGetFilingDocument(match.cik, filingMeta.accessionNumber, infoTableDoc);
+        if (!xmlText) {
+            throw ctx.fail('no_info_table', `Information table document '${infoTableDoc}' could not be fetched.`, { ...ctx.recoveryFor('no_info_table') });
+        }
+        // Pull reporting period and filing-manager name from the primary_doc.xml cover page.
+        // The CIK resolver only knows names for ticker-listed entities, but most 13F filers
+        // are investment managers that aren't listed — the cover page is the reliable source.
+        let reportingPeriod;
+        let filerName;
+        const primaryXml = await api.tryGetFilingDocument(match.cik, filingMeta.accessionNumber, 'primary_doc.xml');
+        if (primaryXml) {
+            // <periodOfReport>12-31-2025</periodOfReport> or <reportCalendarOrQuarter>12-31-2025</reportCalendarOrQuarter>
+            const periodMatch = primaryXml.match(/<periodOfReport>(\d{2}-\d{2}-\d{4})<\/periodOfReport>/) ??
+                primaryXml.match(/<reportCalendarOrQuarter>(\d{2}-\d{2}-\d{4})<\/reportCalendarOrQuarter>/);
+            if (periodMatch?.[1]) {
+                // Convert MM-DD-YYYY to YYYY-MM-DD
+                const [mm, dd, yyyy] = periodMatch[1].split('-');
+                reportingPeriod = `${yyyy}-${mm}-${dd}`;
+            }
+            const nameMatch = primaryXml.match(/<(?:\w+:)?filingManager>[\s\S]*?<(?:\w+:)?name>([^<]+)<\/(?:\w+:)?name>/i);
+            if (nameMatch?.[1])
+                filerName = nameMatch[1].trim();
+        }
+        let parsed;
+        try {
+            parsed = parseInfoTableXml(xmlText);
+        }
+        catch {
+            throw ctx.fail('no_info_table', `Failed to parse information table XML for filing ${filingMeta.accessionNumber}.`, { ...ctx.recoveryFor('no_info_table') });
+        }
+        const totalHoldings = parsed.holdings.length;
+        const holdings = parsed.holdings.slice(0, input.limit);
+        if (holdings.length === 0) {
+            ctx.enrich.notice(`The information table for this filing contained no holdings rows. ` +
+                `This may be a 13F-NT (notice-only) filing or an amendment. ` +
+                `Use secedgar_search_filings with forms=["13F-HR"] to find the correct filing.`);
+        }
+        ctx.log.info('Institutional holdings retrieved', {
+            cik: match.cik,
+            accessionNumber: filingMeta.accessionNumber,
+            totalHoldings,
+            returned: holdings.length,
+        });
+        return {
+            filer_name: filerName ?? match.name ?? input.ticker_or_cik,
+            filer_cik: match.cik,
+            reporting_period: reportingPeriod,
+            filing_date: filingMeta.filingDate,
+            accession_number: filingMeta.accessionNumber,
+            total_holdings_in_filing: totalHoldings,
+            holdings: holdings.map((h) => ({
+                issuer_name: h.issuer_name,
+                title_of_class: h.title_of_class,
+                cusip: h.cusip,
+                value_in_thousands: h.value_in_thousands,
+                shares_or_principal_amount: h.shares_or_principal_amount,
+                shares_or_principal_type: h.shares_or_principal_type,
+                put_call: h.put_call,
+                investment_discretion: h.investment_discretion,
+            })),
+        };
+    },
+    format: (result) => {
+        const period = result.reporting_period ? ` (period: ${result.reporting_period})` : '';
+        const lines = [
+            `**13F-HR Holdings** — ${result.filer_name} (CIK ${result.filer_cik})`,
+            `Filed: ${result.filing_date}${period} | Accession: ${result.accession_number}`,
+            `Showing ${result.holdings.length} of ${result.total_holdings_in_filing} total positions`,
+        ];
+        for (const h of result.holdings) {
+            lines.push('');
+            const valueStr = h.value_in_thousands !== undefined
+                ? `$${(h.value_in_thousands / 1000).toFixed(2)}M (${h.value_in_thousands}K)`
+                : 'value N/A';
+            const sharesStr = h.shares_or_principal_amount !== undefined
+                ? `${h.shares_or_principal_amount.toLocaleString()} ${h.shares_or_principal_type ?? 'shares'}`
+                : 'shares N/A';
+            const putCallStr = h.put_call ? ` [${h.put_call}]` : '';
+            const cusipStr = h.cusip ? ` CUSIP ${h.cusip}` : '';
+            const classStr = h.title_of_class ? ` (${h.title_of_class})` : '';
+            lines.push(`**${h.issuer_name}**${classStr}${cusipStr}${putCallStr}`);
+            lines.push(`${sharesStr} | ${valueStr} | discretion: ${h.investment_discretion ?? 'N/A'}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-institutional-holdings.tool.js.map

package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-institutional-holdings.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-institutional-holdings.tool.ts"],"names":[],"mappings":"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"}