@cyanheads/secedgar-mcp-server 0.14.0 → 0.15.1

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

@@ -0,0 +1,457 @@
+/**
+ * @fileoverview Blockholder ownership for one issuer, parsed from the structured
+ * SCHEDULE 13D / SCHEDULE 13G XML that SEC has required since 2024-12-18. Completes the
+ * ownership triangle alongside secedgar_get_insider_transactions (Form 4 officers and
+ * directors) and secedgar_get_institutional_holdings (13F portfolios): this tool covers the
+ * 5%-and-over stakes, activist and passive. Discovery runs off the issuer's own submissions
+ * feed — SEC cross-lists a 13D/G under every CIK party to it, so the issuer's history
+ * already carries the filings made about it and the archive document is reachable on the
+ * issuer's own path.
+ * @module mcp-server/tools/definitions/get-beneficial-owners
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCanvasBridge, toDatasetField } from '../../../services/canvas-bridge/canvas-bridge.js';
+import { formNameToSchedule, parseBeneficialOwnershipXml, } from '../../../services/edgar/beneficial-ownership-parser.js';
+import { getEdgarApiService, rawDocumentName } from '../../../services/edgar/edgar-api-service.js';
+/**
+ * First filing date on which every beneficial-ownership filing arrived in the structured
+ * format. The legacy `SC 13D` / `SC 13G` names stop dead here: EDGAR full-text search counts
+ * 37 legacy filings on 2024-12-17 and zero on 2024-12-18, against 44 structured ones the
+ * same day. Filings before it are text or HTML documents with no XML to parse.
+ */
+const STRUCTURED_FROM = '2024-12-18';
+/** Legacy form names that carry the same disclosure with no parseable XML. */
+const LEGACY_FORMS = ['SC 13D', 'SC 13D/A', 'SC 13G', 'SC 13G/A'];
+/**
+ * Character ceiling on the Item 4 purpose-of-transaction prose. It is free text and runs to
+ * several pages on a control filing, which would put one filing's narrative ahead of every
+ * other filing's ownership data in the caller's context. The full text stays one
+ * secedgar_get_filing call away on the accession number each row carries.
+ */
+const PURPOSE_MAX_CHARS = 1200;
+/** Character ceiling on a reporting person's cover-page footnote — same reasoning, per person. */
+const NOTES_MAX_CHARS = 240;
+/** Trim free text to a ceiling, reporting whether anything was cut. */
+function clip(text, max) {
+    if (text === undefined)
+        return { text: undefined, cut: false };
+    const collapsed = text.replace(/\s+/g, ' ').trim();
+    if (collapsed.length <= max)
+        return { text: collapsed, cut: false };
+    return { text: `${collapsed.slice(0, max)}…`, cut: true };
+}
+export const getBeneficialOwnersTool = tool('secedgar_get_beneficial_owners', {
+    title: 'Get Beneficial Owners',
+    description: "List the 5%-and-over beneficial owners of a public company, parsed from the structured SCHEDULE 13D and SCHEDULE 13G filings made about it. The input is the ISSUER — the company being held — which is the opposite direction from secedgar_get_institutional_holdings, where the input is the manager. 13D is the activist form and carries the filer's stated purpose of the transaction; 13G is the passive form and has no purpose field at all, which is the substantive difference between a stake that intends to influence control and one that does not. Every filing is returned with each reporting person listed separately, because voting power, dispositive power, and percent of class are reported per person even on a joint filing where several funds and their controlling principal report overlapping shares — summing those percentages double-counts the same position. Coverage starts at 2024-12-18, when SEC replaced the legacy SC 13D / SC 13G text filings with this XML format; earlier stakes are readable but not parseable, and the response reports how many of them the issuer has. The full parsed set is materialized as df_<id> when a canvas is available, one row per reporting person, so it joins against the insider and 13F dataframes on issuer CIK.",
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    errors: [
+        {
+            reason: 'issuer_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The issuer input does not resolve to a known EDGAR company',
+            recovery: 'Use secedgar_company_search to find the issuer ticker or 10-digit CIK.',
+        },
+        {
+            reason: 'ambiguous_issuer',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'The issuer name matches several EDGAR companies',
+            recovery: 'Retry with the ticker or the 10-digit CIK of the intended issuer from the matches list.',
+        },
+        {
+            reason: 'no_filings_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The issuer has no structured SCHEDULE 13D/13G filings matching the requested form kind',
+            recovery: 'Use secedgar_search_filings with forms ["SC 13D","SC 13G"] to reach the pre-2024-12-18 text filings, then read them with secedgar_get_filing.',
+        },
+    ],
+    input: z.object({
+        issuer: z
+            .string()
+            .trim()
+            .min(1, 'Issuer cannot be blank')
+            .describe('The company whose blockholders you want — a ticker ("AAPL"), a 10-digit CIK ("0000320193"), or a company name. This is the subject company of the schedule, not the investor filing it; passing an investment manager here returns the schedules filed about that manager, which is almost always empty.'),
+        form_kind: z
+            .enum(['all', '13D', '13G'])
+            .default('all')
+            .describe('Which schedule to return. "13D" is the activist form, filed by a holder that may seek to influence control and carrying a stated purpose of transaction. "13G" is the passive form, available to institutions and holders under 20% that certify no control intent. "all" (default) returns both, newest first.'),
+        include_amendments: z
+            .boolean()
+            .default(true)
+            .describe('Whether to include amendments (SCHEDULE 13D/A, SCHEDULE 13G/A). Amendments carry the current position and are how an ongoing stake is tracked, so they are included by default. Set false to see only filings that opened a new position.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .default(10)
+            .describe('Number of filings to fetch and parse, newest first. Each filing is a separate document fetch, so this is the cost of the call as well as its depth. Default 10; a widely-held company can have dozens of blockholder filings a year.'),
+    }),
+    output: z.object({
+        issuer: z.string().describe('The issuer input, echoed.'),
+        issuer_cik: z.string().describe('CIK of the resolved issuer, zero-padded to 10 digits.'),
+        issuer_name: z.string().describe('EDGAR-conformed name of the resolved issuer.'),
+        form_kind: z
+            .enum(['all', '13D', '13G'])
+            .describe('The schedule filter applied — the requested value, or the default "all".'),
+        total_structured_filings: z
+            .number()
+            .describe("Structured SCHEDULE 13D/13G filings matching the form filter in the issuer's recent submissions window, before the limit. The population the returned filings are the newest slice of."),
+        filings_parsed: z
+            .number()
+            .describe('Filings actually fetched and parsed — total_structured_filings capped by limit.'),
+        structured_coverage_from: z
+            .string()
+            .describe('First filing date on which SEC required this XML format (YYYY-MM-DD). Blockholder filings before it exist but are not parseable into this schema.'),
+        legacy_filings_before_coverage: z
+            .number()
+            .describe("Legacy SC 13D / SC 13G filings in the issuer's recent submissions window — pre-2024-12-18 stakes this tool cannot parse. Reach them with secedgar_search_filings and read them with secedgar_get_filing. A floor, not a lifetime count: the submissions window holds roughly the last thousand filings of every type."),
+        filings: z
+            .array(z
+            .object({
+            form: z.string().describe('EDGAR form name, e.g. "SCHEDULE 13D" or "SCHEDULE 13G/A".'),
+            schedule: z
+                .enum(['13D', '13G'])
+                .describe('Which schedule this is — 13D activist, 13G passive.'),
+            is_amendment: z.boolean().describe('True when the form name carries the /A suffix.'),
+            amendment_number: z
+                .string()
+                .optional()
+                .describe('Amendment sequence from the cover page. Absent on an original filing.'),
+            accession_number: z
+                .string()
+                .describe('Accession number — pass to secedgar_get_filing for the full document.'),
+            filing_date: z.string().describe('Date the schedule was submitted (YYYY-MM-DD).'),
+            event_date: z
+                .string()
+                .optional()
+                .describe('Date of the event that required the filing (YYYY-MM-DD) — when the position actually crossed or changed, which precedes filing_date. Absent when the cover page omits it.'),
+            security_class: z
+                .string()
+                .optional()
+                .describe('Title of the class of securities the schedule covers. A multi-class issuer has a separate schedule per class, so percentages are of this class only.'),
+            cusips: z
+                .array(z.string())
+                .describe('CUSIPs of the subject class from the cover page. Empty when none listed.'),
+            purpose_of_transaction: z
+                .string()
+                .optional()
+                .describe('Item 4 purpose-of-transaction prose — what the holder says it intends. Present on 13D filings only; 13G has no such field, which is what makes it the passive form. Absent on an amendment that restates no purpose.'),
+            purpose_truncated: z
+                .boolean()
+                .describe('True when purpose_of_transaction was clipped to fit — read the full item with secedgar_get_filing on this accession number.'),
+            reporting_persons: z
+                .array(z
+                .object({
+                name: z.string().describe('Reporting person as named on the cover page.'),
+                cik: z
+                    .string()
+                    .optional()
+                    .describe('Reporting person CIK, when the schedule carries one. SCHEDULE 13G never does — its cover page has no CIK field — so this is populated on 13D filings only.'),
+                citizenship: z
+                    .string()
+                    .optional()
+                    .describe('SEC citizenship or place-of-organization code — a US state ("DE"), or an SEC country code ("X1" United States, "E9" Cayman Islands).'),
+                percent_of_class: z
+                    .number()
+                    .optional()
+                    .describe('Percent of the class this person beneficially owns (0-100), as this person reports it. Per person, not per filing: joint filers report overlapping shares, so these do not sum to a group total.'),
+                aggregate_amount_owned: z
+                    .number()
+                    .optional()
+                    .describe('Shares beneficially owned by this person. Absent when the person reports no amount, which happens on an exit amendment reporting a zero position.'),
+                sole_voting_power: z
+                    .number()
+                    .optional()
+                    .describe('Shares this person alone may vote.'),
+                shared_voting_power: z
+                    .number()
+                    .optional()
+                    .describe('Shares this person votes jointly with another party.'),
+                sole_dispositive_power: z
+                    .number()
+                    .optional()
+                    .describe('Shares this person alone may sell or transfer.'),
+                shared_dispositive_power: z
+                    .number()
+                    .optional()
+                    .describe('Shares this person may sell or transfer jointly with another party.'),
+                person_types: z
+                    .array(z.string())
+                    .describe('SEC type-of-reporting-person codes — IN individual, CO corporation, PN partnership, IA investment adviser, HC holding company, OO other. One person can carry several.'),
+                excludes_certain_shares: z
+                    .boolean()
+                    .optional()
+                    .describe('True when the reported aggregate deliberately excludes shares this person disclaims beneficial ownership of. Absent when the filing does not answer.'),
+                notes: z
+                    .string()
+                    .optional()
+                    .describe("The filer's own cover-page footnote, usually the share count the percentage was computed against. Clipped when long — the full text is in the filing."),
+            })
+                .describe('One reporting person from the schedule cover page.'))
+                .describe('Every reporting person on this filing. A joint filing lists a fund, its adviser, and its controlling principal separately, each reporting the same underlying shares.'),
+        })
+            .describe('One SCHEDULE 13D or 13G filing made about this issuer.'))
+            .describe('Blockholder filings, newest first, capped at limit.'),
+        dataset: z
+            .object({
+            name: z
+                .string()
+                .describe('Dataframe handle (df_XXXXX_XXXXX) — pass to secedgar_dataframe_query.'),
+            row_count: z.number().describe('Rows materialized in the dataframe.'),
+            expires_at: z.string().describe('ISO 8601 expiry timestamp.'),
+            truncated: z
+                .boolean()
+                .describe('True when the issuer has more structured filings than limit fetched — the dataframe holds the parsed filings only, not the whole history.'),
+        })
+            .optional()
+            .describe("Canvas dataframe holding one row per reporting person across every parsed filing, each row carrying the issuer, form, accession, and dates alongside the person's powers. Joins against the insider and 13F dataframes on issuer_cik. Absent when canvas is unavailable or nothing parsed."),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance when no filings matched — names the coverage boundary and the fallback.'),
+        truncated: z.boolean().optional().describe('True when filings were capped by limit.'),
+        shown: z.number().optional().describe('Number of filings returned.'),
+        cap: z.number().optional().describe('The limit cap applied.'),
+    },
+    async handler(input, ctx) {
+        const api = getEdgarApiService();
+        const resolved = await api.resolveCik(input.issuer);
+        const candidates = Array.isArray(resolved) ? resolved : [resolved];
+        if (candidates.length > 1) {
+            const shown = candidates.slice(0, 10);
+            const list = shown.map((c) => `${c.ticker ?? c.cik} (${c.name ?? 'Unknown'})`).join(', ');
+            throw ctx.fail('ambiguous_issuer', `'${input.issuer}' matches multiple EDGAR companies: ${list}.`, {
+                ...ctx.recoveryFor('ambiguous_issuer'),
+                matches: shown.map((c) => ({ cik: c.cik, name: c.name, ticker: c.ticker })),
+            });
+        }
+        const match = candidates[0];
+        if (!match) {
+            throw ctx.fail('issuer_not_found', `Issuer '${input.issuer}' not found in EDGAR.`, {
+                ...ctx.recoveryFor('issuer_not_found'),
+            });
+        }
+        const submissions = await api.getSubmissions(match.cik);
+        const recent = submissions.filings.recent;
+        // SEC indexes a 13D/G under every CIK party to it, so the issuer's own feed already
+        // carries the schedules filed about it — no entity-scoped search needed.
+        const selected = [];
+        let totalMatching = 0;
+        let legacyCount = 0;
+        for (let i = 0; i < recent.form.length; i++) {
+            const form = recent.form[i] ?? '';
+            if (LEGACY_FORMS.includes(form)) {
+                legacyCount++;
+                continue;
+            }
+            const schedule = formNameToSchedule(form);
+            if (!schedule)
+                continue;
+            if (input.form_kind !== 'all' && schedule !== input.form_kind)
+                continue;
+            if (!input.include_amendments && form.endsWith('/A'))
+                continue;
+            totalMatching++;
+            if (selected.length < input.limit) {
+                selected.push({
+                    form,
+                    schedule,
+                    accessionNumber: recent.accessionNumber[i] ?? '',
+                    filingDate: recent.filingDate[i] ?? '',
+                    document: rawDocumentName(recent.primaryDocument[i]),
+                });
+            }
+        }
+        if (totalMatching === 0) {
+            const kindLabel = input.form_kind === 'all' ? 'SCHEDULE 13D/13G' : `SCHEDULE ${input.form_kind}`;
+            const legacyHint = legacyCount > 0
+                ? `Its submissions window does hold ${legacyCount} legacy SC 13D/SC 13G filings from before ${STRUCTURED_FROM}; those are text filings with no XML to parse — read them with secedgar_get_filing.`
+                : `Blockholder filings from before ${STRUCTURED_FROM} use the legacy SC 13D / SC 13G names and are not parseable into this schema — search for them with secedgar_search_filings.`;
+            throw ctx.fail('no_filings_found', `No structured ${kindLabel} filings found for ${submissions.name} (CIK ${match.cik}). ${legacyHint}`, {
+                ...ctx.recoveryFor('no_filings_found'),
+                issuer_cik: match.cik,
+                issuer_name: submissions.name,
+                legacy_filings_before_coverage: legacyCount,
+            });
+        }
+        // Fetch and parse each selected filing. A document that 404s or does not parse as a
+        // schedule is dropped rather than failing the call — one malformed filing must not
+        // hide every other blockholder in the list.
+        const filings = [];
+        for (const ref of selected) {
+            const xml = await api.tryGetFilingDocument(match.cik, ref.accessionNumber, ref.document);
+            const parsed = xml ? parseBeneficialOwnershipXml(xml) : undefined;
+            if (!parsed) {
+                ctx.log.debug('Skipping unparseable beneficial-ownership filing', {
+                    accessionNumber: ref.accessionNumber,
+                    document: ref.document,
+                });
+                continue;
+            }
+            const purpose = clip(parsed.purpose_of_transaction, PURPOSE_MAX_CHARS);
+            filings.push({
+                form: ref.form,
+                schedule: ref.schedule,
+                is_amendment: ref.form.endsWith('/A'),
+                amendment_number: parsed.amendment_number,
+                accession_number: ref.accessionNumber,
+                filing_date: ref.filingDate,
+                event_date: parsed.event_date,
+                security_class: parsed.security_class,
+                cusips: parsed.issuer_cusips,
+                purpose_of_transaction: purpose.text,
+                purpose_truncated: purpose.cut,
+                reporting_persons: parsed.owners.map((o) => ({
+                    name: o.name,
+                    cik: o.cik,
+                    citizenship: o.citizenship,
+                    percent_of_class: o.percent_of_class,
+                    aggregate_amount_owned: o.aggregate_amount_owned,
+                    sole_voting_power: o.sole_voting_power,
+                    shared_voting_power: o.shared_voting_power,
+                    sole_dispositive_power: o.sole_dispositive_power,
+                    shared_dispositive_power: o.shared_dispositive_power,
+                    person_types: o.person_types,
+                    excludes_certain_shares: o.excludes_certain_shares,
+                    notes: clip(o.notes, NOTES_MAX_CHARS).text,
+                })),
+            });
+        }
+        const truncated = totalMatching > filings.length;
+        // One row per reporting person — the grain the ownership question is asked at, and the
+        // grain that joins to the insider and 13F dataframes on issuer_cik.
+        let dataset;
+        const bridge = getCanvasBridge();
+        const rows = filings.flatMap((f) => f.reporting_persons.map((p) => ({
+            issuer_cik: match.cik,
+            issuer_name: submissions.name,
+            form: f.form,
+            schedule: f.schedule,
+            is_amendment: f.is_amendment,
+            accession_number: f.accession_number,
+            filing_date: f.filing_date,
+            event_date: f.event_date ?? null,
+            security_class: f.security_class ?? null,
+            cusip: f.cusips[0] ?? null,
+            reporting_person: p.name,
+            reporting_person_cik: p.cik ?? null,
+            citizenship: p.citizenship ?? null,
+            percent_of_class: p.percent_of_class ?? null,
+            aggregate_amount_owned: p.aggregate_amount_owned ?? null,
+            sole_voting_power: p.sole_voting_power ?? null,
+            shared_voting_power: p.shared_voting_power ?? null,
+            sole_dispositive_power: p.sole_dispositive_power ?? null,
+            shared_dispositive_power: p.shared_dispositive_power ?? null,
+            person_types: p.person_types.join(',') || null,
+            has_stated_purpose: f.purpose_of_transaction !== undefined,
+        })));
+        if (bridge && rows.length > 0) {
+            const registered = await bridge.registerDataframe(ctx, {
+                rows,
+                sourceTool: 'secedgar_get_beneficial_owners',
+                queryParams: {
+                    issuer: input.issuer,
+                    issuer_cik: match.cik,
+                    form_kind: input.form_kind,
+                    include_amendments: input.include_amendments,
+                    limit: input.limit,
+                },
+                truncated,
+            });
+            if (registered)
+                dataset = { ...toDatasetField(registered), truncated };
+        }
+        if (filings.length === 0) {
+            ctx.enrich.notice(`${totalMatching} structured filings are indexed for ${submissions.name}, but none of the ${selected.length} fetched parsed as a SCHEDULE 13D or 13G document. Read one directly with secedgar_get_filing on an accession number from secedgar_search_filings.`);
+        }
+        else if (truncated) {
+            ctx.enrich.truncated({
+                shown: filings.length,
+                cap: input.limit,
+                guidance: `${totalMatching} structured blockholder filings are indexed for this issuer. Raise limit to reach further back, or narrow with form_kind or include_amendments=false.`,
+            });
+        }
+        ctx.log.info('Beneficial owners retrieved', {
+            cik: match.cik,
+            formKind: input.form_kind,
+            totalMatching,
+            parsed: filings.length,
+            owners: rows.length,
+            datasetName: dataset?.name,
+        });
+        return {
+            issuer: input.issuer,
+            issuer_cik: match.cik,
+            issuer_name: submissions.name,
+            form_kind: input.form_kind,
+            total_structured_filings: totalMatching,
+            filings_parsed: filings.length,
+            structured_coverage_from: STRUCTURED_FROM,
+            legacy_filings_before_coverage: legacyCount,
+            filings,
+            dataset,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**5%+ beneficial owners of ${result.issuer_name}** (CIK ${result.issuer_cik}) — input "${result.issuer}"`,
+            `Schedule filter: ${result.form_kind} | ${result.filings_parsed} of ${result.total_structured_filings} structured filings parsed`,
+            `Structured coverage starts ${result.structured_coverage_from}; ${result.legacy_filings_before_coverage} legacy SC 13D/SC 13G filings sit before it in the submissions window (read those with secedgar_get_filing).`,
+        ];
+        for (const f of result.filings) {
+            lines.push('');
+            const amendment = f.is_amendment
+                ? ` (amendment${f.amendment_number ? ` no. ${f.amendment_number}` : ''})`
+                : '';
+            lines.push(`## ${f.form}${amendment} — filed ${f.filing_date} [${f.accession_number}]`);
+            const bits = [`Schedule ${f.schedule}`];
+            if (f.event_date)
+                bits.push(`event ${f.event_date}`);
+            if (f.security_class)
+                bits.push(f.security_class);
+            if (f.cusips.length > 0)
+                bits.push(`CUSIP ${f.cusips.join(', ')}`);
+            lines.push(bits.join(' | '));
+            for (const p of f.reporting_persons) {
+                const pct = p.percent_of_class !== undefined ? `${p.percent_of_class}% of class` : 'percent N/A';
+                const owned = p.aggregate_amount_owned !== undefined
+                    ? `${p.aggregate_amount_owned.toLocaleString()} shares`
+                    : 'amount N/A';
+                const idBits = [];
+                if (p.cik)
+                    idBits.push(`CIK ${p.cik}`);
+                if (p.citizenship)
+                    idBits.push(p.citizenship);
+                if (p.person_types.length > 0)
+                    idBits.push(p.person_types.join('/'));
+                lines.push(`- **${p.name}**${idBits.length > 0 ? ` (${idBits.join(', ')})` : ''}`);
+                lines.push(`  ${owned} | ${pct}`);
+                lines.push(`  voting sole/shared: ${p.sole_voting_power ?? 'N/A'} / ${p.shared_voting_power ?? 'N/A'} | dispositive sole/shared: ${p.sole_dispositive_power ?? 'N/A'} / ${p.shared_dispositive_power ?? 'N/A'}`);
+                if (p.excludes_certain_shares !== undefined) {
+                    lines.push(`  Excludes disclaimed shares: ${p.excludes_certain_shares ? 'yes' : 'no'}`);
+                }
+                if (p.notes)
+                    lines.push(`  Note: ${p.notes}`);
+            }
+            if (f.purpose_of_transaction) {
+                lines.push(`**Purpose of transaction:** ${f.purpose_of_transaction}${f.purpose_truncated ? ' (clipped — read the full Item 4 with secedgar_get_filing)' : ''}`);
+            }
+            else {
+                lines.push(f.schedule === '13G'
+                    ? '**Purpose of transaction:** not applicable — 13G is the passive form and has no purpose item.'
+                    : '**Purpose of transaction:** not stated in this filing.');
+            }
+        }
+        if (result.dataset) {
+            const note = result.dataset.truncated
+                ? ' (truncated — more structured filings exist beyond limit)'
+                : '';
+            lines.push(`\nDataset: ${result.dataset.name} (${result.dataset.row_count} reporting-person rows, expires ${result.dataset.expires_at})${note} — query with secedgar_dataframe_query.`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-beneficial-owners.tool.js.map

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

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

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

@@ -90,5 +90,10 @@ export declare const getFilingTool: import("@cyanheads/mcp-ts-core").ToolDefinit
     readonly code: JsonRpcErrorCode.NotFound;
     readonly when: "The section string did not match any detected heading in the document";
     readonly recovery: "Pick a heading from the outline in the error message, or use offset paging instead.";
-}], undefined>;
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+    readonly truncated: z.ZodOptional<z.ZodBoolean>;
+    readonly shown: z.ZodOptional<z.ZodNumber>;
+    readonly cap: z.ZodOptional<z.ZodNumber>;
+}>;
 //# sourceMappingURL=get-filing.tool.d.ts.map

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

@@ -1 +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;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA+GjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkcxB,CAAC"}
+{"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;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA+GjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0dxB,CAAC"}

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

@@ -45,6 +45,21 @@ const documentEntrySchema = z
 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. Use offset/next_offset for multi-page access to large filings (10-K, S-1 can exceed 1M chars): pass the next_offset from a truncated response to read the next page. Use section to jump directly to a heading (e.g. 'risk factors', 'item 7') without needing an offset.",
     annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    // Agent-facing disclosure of the content window. `content_truncated` types the
+    // fact on the wire; this carries how much of the document the page actually
+    // held and the cap that produced it, which the output schema does not.
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance on reading the next page when the content was capped.'),
+        truncated: z
+            .boolean()
+            .optional()
+            .describe('True when the document is longer than `content_limit` allowed through.'),
+        shown: z.number().optional().describe('Characters of document text returned on this page.'),
+        cap: z.number().optional().describe('The `content_limit` that was applied.'),
+    },
     errors: [
         {
             reason: 'document_not_found',
@@ -180,7 +195,7 @@ export const getFilingTool = tool('secedgar_get_filing', {
         })
             .describe('One detected heading with its offset.'))
             .optional()
-            .describe('Document outline — detected headings with their character offsets. Present on the first page of a truncated response (offset=0, no section). Use a heading offset as offset, or pass heading text as section, to jump to that section.'),
+            .describe('Document outline — up to 50 detected headings with their character offsets. Present on the first page of a truncated response (offset=0, no section). Use a heading offset as offset, or pass heading text as section, to jump to that section.'),
         filing_url: z.string().describe('Direct URL to the filing on SEC.gov.'),
     }),
     async handler(input, ctx) {
@@ -315,6 +330,13 @@ export const getFilingTool = tool('secedgar_get_filing', {
             });
         }
         const { text, truncated, totalLength, nextOffset } = windowText(fullText, effectiveOffset, input.content_limit);
+        if (truncated) {
+            ctx.enrich.truncated({
+                shown: text.length,
+                cap: input.content_limit,
+                guidance: `Showing ${text.length} of ${totalLength} characters. Pass next_offset (${nextOffset ?? '?'}) as offset to read the next page, or jump with section.`,
+            });
+        }
         // Emit outline on first-page truncated responses (not on subsequent pages or section jumps)
         const shouldEmitOutline = truncated && effectiveOffset === 0 && !input.section;
         const outline = shouldEmitOutline ? detectHeadings(fullText, 50) : undefined;