@cyanheads/secedgar-mcp-server 0.1.9

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

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Fetch a specific filing's metadata and document content by accession number.
+ * @module mcp-server/tools/definitions/get-filing
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const getFilingTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    accession_number: z.ZodString;
+    cik: z.ZodOptional<z.ZodString>;
+    content_limit: z.ZodDefault<z.ZodNumber>;
+    document: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    accession_number: z.ZodString;
+    form: z.ZodString;
+    filing_date: z.ZodString;
+    company_name: z.ZodString;
+    cik: z.ZodString;
+    period_ending: z.ZodOptional<z.ZodString>;
+    primary_document: z.ZodString;
+    documents: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    content: z.ZodString;
+    content_truncated: z.ZodBoolean;
+    content_total_length: z.ZodNumber;
+    filing_url: z.ZodString;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-filing.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-filing.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-filing.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;kBA8JxB,CAAC"}

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

@@ -0,0 +1,157 @@
+/**
+ * @fileoverview Fetch a specific filing's metadata and document content by accession number.
+ * @module mcp-server/tools/definitions/get-filing
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getEdgarApiService } from '../../../services/edgar/edgar-api-service.js';
+import { filingToText } from '../../../services/edgar/filing-to-text.js';
+export const getFilingTool = tool('secedgar_get_filing', {
+    description: "Fetch a specific filing's metadata and document content by accession number. " +
+        'Returns the primary document as readable text, with option to fetch specific exhibits.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        accession_number: z
+            .string()
+            .describe('Filing accession number in either format: "0000320193-23-000106" (dashes) or "000032019323000106" (no dashes). Obtained from secedgar_company_search or secedgar_search_filings results.'),
+        cik: z
+            .string()
+            .optional()
+            .describe('Company CIK. Optional but recommended — speeds up URL construction. If omitted, derived from the accession number prefix.'),
+        content_limit: z
+            .number()
+            .int()
+            .min(1000)
+            .max(200000)
+            .default(50000)
+            .describe('Maximum characters of document text to return. 10-K filings can exceed 500,000 characters. ' +
+            'Default 50,000 captures ~12,000 words (typically business overview, risk factors, and MD&A). ' +
+            'Increase to 200,000 for full financial statements, or decrease for quick summaries.'),
+        document: z
+            .string()
+            .optional()
+            .describe('Specific document filename within the filing (e.g., "ex-21.htm" for subsidiaries list). Default: the primary document. Available documents listed in the response metadata.'),
+    }),
+    output: z.object({
+        accession_number: z.string().describe('Filing accession number.'),
+        form: z.string().describe('Form type.'),
+        filing_date: z.string().describe('Date filed.'),
+        company_name: z.string().describe('Filing entity name.'),
+        cik: z.string().describe('Company CIK.'),
+        period_ending: z.string().optional().describe('Period of report.'),
+        primary_document: z.string().describe('Primary document filename.'),
+        documents: z
+            .array(z.object({
+            name: z.string().describe('Document filename.'),
+            type: z.string().describe('Document type.'),
+            size: z.number().optional().describe('File size in bytes.'),
+        }))
+            .describe('All documents in this filing. Use the name field with the document input param to fetch exhibits.'),
+        content: z.string().describe('Document text content, truncated to content_limit.'),
+        content_truncated: z.boolean().describe('True if content was truncated.'),
+        content_total_length: z.number().describe('Full document length before truncation.'),
+        filing_url: z.string().describe('Direct URL to the filing on SEC.gov.'),
+    }),
+    async handler(input, ctx) {
+        const api = getEdgarApiService();
+        // Normalize accession number to dash format
+        const accn = normalizeAccessionNumber(input.accession_number);
+        const accnNoDashes = accn.replace(/-/g, '');
+        // Derive CIK from accession number prefix if not provided
+        const cik = input.cik ?? accn.split('-')[0] ?? accn.slice(0, 10);
+        const paddedCik = cik.padStart(10, '0');
+        // Fetch filing index
+        let index;
+        try {
+            index = await api.getFilingIndex(paddedCik, accn);
+        }
+        catch (err) {
+            const is404 = err instanceof Error && /404|not found/i.test(err.message);
+            if (is404) {
+                throw notFound(`Filing '${accn}' not found (CIK ${paddedCik}). Verify the accession number and CIK are correct.`);
+            }
+            throw err;
+        }
+        const items = index.directory.item;
+        const documents = items.map((item) => ({
+            name: item.name,
+            type: item.type,
+            size: item.size ? Number.parseInt(item.size, 10) : undefined,
+        }));
+        // Find the target document
+        const targetName = input.document || findPrimaryDocument(items);
+        if (!targetName) {
+            throw notFound(`No document found in filing ${accn}. Available documents: ${items.map((i) => i.name).join(', ')}`);
+        }
+        const docExists = items.some((i) => i.name === targetName);
+        if (!docExists) {
+            throw notFound(`Document '${targetName}' not found in this filing. Available documents: ${items.map((i) => i.name).join(', ')}. Use one of these names.`);
+        }
+        // Fetch and convert document
+        const html = await api.getFilingDocument(paddedCik, accn, targetName);
+        const { text, truncated, totalLength } = filingToText(html, input.content_limit);
+        // Get filing metadata from submissions
+        let form = '';
+        let filingDate = '';
+        let companyName = '';
+        let periodEnding;
+        // Try to get metadata from the index page or a quick submissions lookup
+        const submissions = await api.getSubmissions(paddedCik);
+        companyName = submissions.name;
+        const recentAccns = submissions.filings.recent.accessionNumber;
+        const idx = recentAccns.indexOf(accn);
+        if (idx >= 0) {
+            form = submissions.filings.recent.form[idx] ?? '';
+            filingDate = submissions.filings.recent.filingDate[idx] ?? '';
+            periodEnding = submissions.filings.recent.reportDate[idx] || undefined;
+        }
+        ctx.log.info('Filing retrieved', {
+            accessionNumber: accn,
+            cik: paddedCik,
+            contentLength: totalLength,
+        });
+        return {
+            accession_number: accn,
+            form,
+            filing_date: filingDate,
+            company_name: companyName,
+            cik: paddedCik,
+            period_ending: periodEnding,
+            primary_document: targetName,
+            documents,
+            content: text,
+            content_truncated: truncated,
+            content_total_length: totalLength,
+            filing_url: `https://www.sec.gov/Archives/edgar/data/${paddedCik}/${accnNoDashes}/${targetName}`,
+        };
+    },
+    format: (result) => {
+        const header = `**${result.form}** — ${result.company_name} (${result.filing_date})`;
+        const meta = `Accession: ${result.accession_number} | ${result.content_total_length.toLocaleString()} chars${result.content_truncated ? ' (truncated)' : ''}`;
+        return [{ type: 'text', text: `${header}\n${meta}\n\n${result.content}` }];
+    },
+});
+/** Normalize accession number to dash format (0000320193-23-000106). */
+function normalizeAccessionNumber(input) {
+    const cleaned = input.replace(/[^0-9-]/g, '');
+    if (cleaned.includes('-'))
+        return cleaned;
+    // Convert 18-digit no-dash format to dash format
+    if (cleaned.length === 18) {
+        return `${cleaned.slice(0, 10)}-${cleaned.slice(10, 12)}-${cleaned.slice(12)}`;
+    }
+    return cleaned;
+}
+/** Find the primary document in a filing index (typically the largest .htm file). */
+function findPrimaryDocument(items) {
+    // Prefer .htm/.html files, skip index files
+    const htmlDocs = items.filter((i) => (i.name.endsWith('.htm') || i.name.endsWith('.html')) &&
+        !i.name.includes('index') &&
+        !i.name.startsWith('R'));
+    if (htmlDocs.length === 0)
+        return items[0]?.name;
+    // Return the largest HTML file (likely the primary document)
+    const sorted = htmlDocs.sort((a, b) => (Number.parseInt(b.size, 10) || 0) - (Number.parseInt(a.size, 10) || 0));
+    return sorted[0]?.name;
+}
+//# sourceMappingURL=get-filing.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-filing.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-filing.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,qBAAqB,EAAE;IACvD,WAAW,EACT,+EAA+E;QAC/E,wFAAwF;IAC1F,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAE9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,gBAAgB,EAAE,CAAC;aAChB,MAAM,EAAE;aACR,QAAQ,CACP,0LAA0L,CAC3L;QACH,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,2HAA2H,CAC5H;QACH,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,IAAI,CAAC;aACT,GAAG,CAAC,MAAM,CAAC;aACX,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CACP,6FAA6F;YAC3F,+FAA+F;YAC/F,qFAAqF,CACxF;QACH,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6KAA6K,CAC9K;KACJ,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC/C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACxD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAClE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACnE,SAAS,EAAE,CAAC;aACT,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SAC5D,CAAC,CACH;aACA,QAAQ,CACP,mGAAmG,CACpG;QACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QAClF,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QACzE,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACpF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACxE,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QAEjC,4CAA4C;QAC5C,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAE5C,0DAA0D;QAC1D,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAExC,qBAAqB;QACrB,IAAI,KAAqD,CAAC;QAC1D,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzE,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,QAAQ,CACZ,WAAW,IAAI,oBAAoB,SAAS,qDAAqD,CAClG,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;QACnC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACrC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;SAC7D,CAAC,CAAC,CAAC;QAEJ,2BAA2B;QAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,QAAQ,CACZ,+BAA+B,IAAI,0BAA0B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnG,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,QAAQ,CACZ,aAAa,UAAU,oDAAoD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAC1I,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACtE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAEjF,uCAAuC;QACvC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,YAAgC,CAAC;QAErC,wEAAwE;QACxE,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACxD,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC;QAE/B,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;QAC/D,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAClD,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9D,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;QACzE,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAC/B,eAAe,EAAE,IAAI;YACrB,GAAG,EAAE,SAAS;YACd,aAAa,EAAE,WAAW;SAC3B,CAAC,CAAC;QAEH,OAAO;YACL,gBAAgB,EAAE,IAAI;YACtB,IAAI;YACJ,WAAW,EAAE,UAAU;YACvB,YAAY,EAAE,WAAW;YACzB,GAAG,EAAE,SAAS;YACd,aAAa,EAAE,YAAY;YAC3B,gBAAgB,EAAE,UAAU;YAC5B,SAAS;YACT,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,SAAS;YAC5B,oBAAoB,EAAE,WAAW;YACjC,UAAU,EAAE,2CAA2C,SAAS,IAAI,YAAY,IAAI,UAAU,EAAE;SACjG,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,KAAK,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,WAAW,GAAG,CAAC;QACrF,MAAM,IAAI,GAAG,cAAc,MAAM,CAAC,gBAAgB,MAAM,MAAM,CAAC,oBAAoB,CAAC,cAAc,EAAE,SAAS,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC9J,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,IAAI,OAAO,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF,CAAC,CAAC;AAEH,wEAAwE;AACxE,SAAS,wBAAwB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1C,iDAAiD;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACjF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qFAAqF;AACrF,SAAS,mBAAmB,CAC1B,KAA0D;IAE1D,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAC1B,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IAEjD,6DAA6D;IAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAClF,CAAC;IACF,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Get historical XBRL financial data for a company.
+ * Handles friendly concept name resolution, multi-tag lookup, and automatic deduplication.
+ * @module mcp-server/tools/definitions/get-financials
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const getFinancialsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    company: z.ZodString;
+    concept: z.ZodString;
+    taxonomy: z.ZodDefault<z.ZodEnum<{
+        "us-gaap": "us-gaap";
+        dei: "dei";
+        "ifrs-full": "ifrs-full";
+    }>>;
+    period_type: z.ZodDefault<z.ZodEnum<{
+        annual: "annual";
+        quarterly: "quarterly";
+        all: "all";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    company: z.ZodString;
+    cik: z.ZodString;
+    concept: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    unit: z.ZodString;
+    data: z.ZodArray<z.ZodObject<{
+        period: z.ZodString;
+        value: z.ZodNumber;
+        start: z.ZodOptional<z.ZodString>;
+        end: z.ZodString;
+        fiscal_year: z.ZodNullable<z.ZodNumber>;
+        fiscal_period: z.ZodNullable<z.ZodString>;
+        form: z.ZodString;
+        filed: z.ZodString;
+        accession_number: z.ZodString;
+    }, z.core.$strip>>;
+    tags_tried: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=get-financials.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-financials.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-financials.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAMjD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0N5B,CAAC"}

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

@@ -0,0 +1,191 @@
+/**
+ * @fileoverview Get historical XBRL financial data for a company.
+ * Handles friendly concept name resolution, multi-tag lookup, and automatic deduplication.
+ * @module mcp-server/tools/definitions/get-financials
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { resolveConcept } from '../../../services/edgar/concept-map.js';
+import { getEdgarApiService } from '../../../services/edgar/edgar-api-service.js';
+export const getFinancialsTool = tool('secedgar_get_financials', {
+    description: 'Get historical XBRL financial data for a company. Accepts friendly concept names ' +
+        '(e.g., "revenue", "net_income", "assets") or raw XBRL tags. Automatically handles ' +
+        'historical tag changes and deduplicates data. See secedgar://concepts for available names.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        company: z
+            .string()
+            .describe('Ticker symbol (e.g., "AAPL") or CIK number. Ticker is preferred.'),
+        concept: z
+            .string()
+            .describe('Financial concept — friendly name (e.g., "revenue", "net_income", "assets", "eps_diluted") ' +
+            'or raw XBRL tag (e.g., "AccountsPayableCurrent"). ' +
+            'Friendly names auto-resolve to the correct XBRL tags and handle historical tag changes. ' +
+            'See secedgar://concepts for the full list of supported names and mappings.'),
+        taxonomy: z
+            .enum(['us-gaap', 'ifrs-full', 'dei'])
+            .default('us-gaap')
+            .describe('XBRL taxonomy. us-gaap for US companies, ifrs-full for foreign filers, dei for entity info (shares outstanding).'),
+        period_type: z
+            .enum(['annual', 'quarterly', 'all'])
+            .default('annual')
+            .describe('Filter to annual (FY) or quarterly (Q1-Q4) data. "all" returns both.'),
+    }),
+    output: z.object({
+        company: z.string().describe('Company name.'),
+        cik: z.string().describe('Company CIK.'),
+        concept: z.string().describe('XBRL tag name used.'),
+        label: z.string().describe('Human-readable label for the concept.'),
+        description: z.string().optional().describe('XBRL taxonomy description.'),
+        unit: z.string().describe('Unit of measure (e.g., "USD", "shares", "USD/shares").'),
+        data: z
+            .array(z.object({
+            period: z.string().describe('Calendar period label (e.g., "CY2023", "CY2023Q3").'),
+            value: z.number().describe('Reported value.'),
+            start: z.string().optional().describe('Period start date (duration items only).'),
+            end: z.string().describe('Period end date.'),
+            fiscal_year: z.number().nullable().describe('Fiscal year.'),
+            fiscal_period: z.string().nullable().describe('Fiscal period (FY, Q1, Q2, Q3, Q4).'),
+            form: z.string().describe('Source filing type (10-K, 10-Q, etc.).'),
+            filed: z.string().describe('Date the source filing was submitted.'),
+            accession_number: z
+                .string()
+                .describe('Source filing accession number for secedgar_get_filing.'),
+        }))
+            .describe('Deduplicated time series, newest first.'),
+        tags_tried: z
+            .array(z.string())
+            .optional()
+            .describe('XBRL tags that were attempted (shown when using friendly names that map to multiple tags).'),
+    }),
+    async handler(input, ctx) {
+        const api = getEdgarApiService();
+        // Resolve company to CIK
+        const resolved = await api.resolveCik(input.company);
+        const match = Array.isArray(resolved) ? resolved[0] : resolved;
+        if (!match || (Array.isArray(resolved) && resolved.length === 0)) {
+            throw notFound(`Company '${input.company}' not found. Try a ticker symbol or CIK number.`);
+        }
+        // Resolve concept to XBRL tag(s)
+        const mapping = resolveConcept(input.concept);
+        const tags = mapping ? mapping.tags : [input.concept];
+        const taxonomy = mapping
+            ? input.taxonomy !== 'us-gaap'
+                ? input.taxonomy
+                : mapping.taxonomy
+            : input.taxonomy;
+        const label = mapping?.label ?? input.concept;
+        // Try each tag until we get data
+        let conceptResponse;
+        const tagsTried = [];
+        const allUnits = [];
+        for (const tag of tags) {
+            tagsTried.push(tag);
+            try {
+                const resp = await api.getCompanyConcept(match.cik, taxonomy, tag);
+                if (!conceptResponse) {
+                    conceptResponse = {
+                        units: resp.units,
+                        label: resp.label,
+                        description: resp.description ?? undefined,
+                        tag: resp.tag,
+                    };
+                }
+                // Merge units from all matching tags
+                for (const units of Object.values(resp.units)) {
+                    allUnits.push(...units);
+                }
+            }
+            catch (err) {
+                // Only swallow 404s (tag not reported by this company); re-throw real errors
+                const is404 = err instanceof Error && /404|not found/i.test(err.message);
+                if (!is404)
+                    throw err;
+            }
+        }
+        if (!conceptResponse || allUnits.length === 0) {
+            const hint = taxonomy === 'ifrs-full'
+                ? 'Try a raw XBRL tag instead of a friendly name, or check the company uses IFRS.'
+                : "This company may use a different tag or taxonomy. Try 'ifrs-full' for foreign filers.";
+            throw notFound(`No XBRL data for '${input.concept}' under ${taxonomy} for this company. ${hint}`);
+        }
+        // Deduplicate: keep only entries with frame field (one per standard calendar period)
+        const deduped = allUnits.filter((u) => !!u.frame);
+        // If deduplication removed everything, the concept exists but has no frame-aligned entries
+        if (deduped.length === 0) {
+            throw notFound(`'${conceptResponse.tag}' exists for this company but has no standard-period data. ` +
+                'This typically means the company reports this item in a non-standard period or ' +
+                'the data lacks frame alignment. Try a related concept or check secedgar://concepts.');
+        }
+        // Remove duplicates by frame value (keep latest filed)
+        const byFrame = new Map();
+        for (const unit of deduped) {
+            const existing = byFrame.get(unit.frame);
+            if (!existing || unit.filed > existing.filed) {
+                byFrame.set(unit.frame, unit);
+            }
+        }
+        // Filter by period type using frame pattern (fp reflects the filing, not the data point)
+        let filtered = Array.from(byFrame.values());
+        if (input.period_type === 'annual') {
+            filtered = filtered.filter((u) => /^CY\d{4}$/.test(u.frame));
+        }
+        else if (input.period_type === 'quarterly') {
+            filtered = filtered.filter((u) => /^CY\d{4}Q\d/.test(u.frame));
+        }
+        // If period_type filter removed everything, suggest the right period type
+        if (filtered.length === 0 && byFrame.size > 0) {
+            const sample = byFrame.values().next().value;
+            const hasInstant = sample && /I$/.test(sample.frame);
+            const hint = hasInstant
+                ? 'This is a balance sheet (instant) item — try period_type: "quarterly" or "all".'
+                : input.period_type === 'annual'
+                    ? 'No annual data found — try period_type: "quarterly" or "all".'
+                    : 'No quarterly data found — try period_type: "annual" or "all".';
+            throw notFound(`No ${input.period_type} data for '${conceptResponse.tag}'. ${hint}`);
+        }
+        // Sort newest first
+        filtered.sort((a, b) => b.end.localeCompare(a.end));
+        // Determine unit string
+        const unitKey = Object.keys(conceptResponse.units)[0] ?? mapping?.unit ?? 'USD';
+        const data = filtered.map((u) => ({
+            period: u.frame,
+            value: u.val,
+            start: u.start || undefined,
+            end: u.end,
+            fiscal_year: u.fy,
+            fiscal_period: u.fp,
+            form: u.form,
+            filed: u.filed,
+            accession_number: u.accn,
+        }));
+        ctx.log.info('Financials retrieved', {
+            company: match.cik,
+            concept: conceptResponse.tag,
+            dataPoints: data.length,
+        });
+        return {
+            company: match.name || input.company,
+            cik: match.cik,
+            concept: conceptResponse.tag,
+            label: conceptResponse.label || label,
+            description: conceptResponse.description || undefined,
+            unit: unitKey,
+            data,
+            tags_tried: tagsTried.length > 1 ? tagsTried : undefined,
+        };
+    },
+    format: (result) => {
+        const lines = [`**${result.label}** — ${result.company} (${result.unit})`];
+        for (const d of result.data) {
+            const formatted = result.unit === 'USD'
+                ? `$${(d.value / 1_000_000).toFixed(1)}M`
+                : result.unit === 'USD/shares'
+                    ? `$${d.value.toFixed(2)}`
+                    : d.value.toLocaleString();
+            lines.push(`${d.period}: ${formatted} (${d.form} filed ${d.filed})`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-financials.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Full-text search across all EDGAR filing documents since 1993.
+ * @module mcp-server/tools/definitions/search-filings
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchFilingsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    forms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    start_date: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    total: z.ZodNumber;
+    total_is_exact: z.ZodBoolean;
+    results: z.ZodArray<z.ZodObject<{
+        accession_number: z.ZodString;
+        form: z.ZodOptional<z.ZodString>;
+        filing_date: z.ZodString;
+        period_ending: z.ZodOptional<z.ZodString>;
+        company_name: z.ZodString;
+        cik: z.ZodString;
+        file_description: z.ZodOptional<z.ZodString>;
+        sic: z.ZodOptional<z.ZodString>;
+        location: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    form_distribution: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-filings.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-filings.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-filings.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAgDjD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;kBAoK5B,CAAC"}