@cyanheads/openfec-mcp-server 0.2.2

package/dist/mcp-server/tools/definitions/search-disbursements.tool.js

@@ -0,0 +1,212 @@
+/**
+ * @fileoverview Search itemized committee spending (Schedule B) or get aggregate
+ * breakdowns by purpose or recipient. Answers "what is this committee spending money on?"
+ * @module mcp-server/tools/definitions/search-disbursements.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { decodeCursor, getOpenFecService } from '../../../services/openfec/openfec-service.js';
+import { fmt$ } from './utils/format-helpers.js';
+import { validateCommitteeId } from './utils/id-validators.js';
+const modes = ['itemized', 'by_purpose', 'by_recipient', 'by_recipient_id'];
+export const searchDisbursements = tool('openfec_search_disbursements', {
+    description: 'Search itemized committee spending (Schedule B) or get aggregate breakdowns by purpose ' +
+        'or recipient. All modes require a committee_id. Use to answer "what is this committee ' +
+        'spending money on?" or "who is receiving payments from this committee?"',
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        mode: z
+            .enum(modes)
+            .default('itemized')
+            .describe('Query mode. "itemized" returns individual disbursement records (keyset pagination). ' +
+            '"by_purpose" aggregates by purpose category. "by_recipient" aggregates by recipient name. ' +
+            '"by_recipient_id" aggregates by recipient committee ID (committee-to-committee transfers).'),
+        committee_id: z
+            .string()
+            .min(1)
+            .describe('Spending committee ID (e.g., C00703975). Required for all modes.'),
+        recipient_name: z.string().optional().describe('Full-text payee name search. Itemized only.'),
+        recipient_state: z.string().optional().describe('Recipient state. Itemized only.'),
+        recipient_city: z.string().optional().describe('Recipient city. Itemized only.'),
+        recipient_committee_id: z
+            .string()
+            .optional()
+            .describe('Recipient committee ID (for committee-to-committee transfers). Itemized only.'),
+        disbursement_description: z
+            .string()
+            .optional()
+            .describe('Full-text description search (e.g., "media buy", "consulting"). Itemized only.'),
+        disbursement_purpose_category: z
+            .string()
+            .optional()
+            .describe('Purpose category code. Itemized only.'),
+        cycle: z.number().optional().describe('Two-year election cycle (e.g., 2024). Even years only.'),
+        min_date: z
+            .string()
+            .optional()
+            .describe('Earliest disbursement date (YYYY-MM-DD). Itemized only.'),
+        max_date: z
+            .string()
+            .optional()
+            .describe('Latest disbursement date (YYYY-MM-DD). Itemized only.'),
+        min_amount: z.number().optional().describe('Minimum amount in dollars. Itemized only.'),
+        max_amount: z.number().optional().describe('Maximum amount in dollars. Itemized only.'),
+        sort: z
+            .enum(['disbursement_date', 'disbursement_amount'])
+            .optional()
+            .describe('Sort field. Itemized only.'),
+        per_page: z.number().default(20).describe('Results per page (max 100).'),
+        cursor: z
+            .string()
+            .optional()
+            .describe('Opaque pagination cursor from a previous response. Itemized mode only (keyset pagination).'),
+    }),
+    output: z.object({
+        results: z
+            .array(z.record(z.string(), z.unknown()))
+            .describe('Disbursement records (itemized) or aggregate rows.'),
+        next_cursor: z
+            .string()
+            .nullable()
+            .optional()
+            .describe('Pagination cursor for the next page of itemized results. Null when no more pages.'),
+        count: z.number().optional().describe('Total result count (may be approximate for itemized).'),
+        pagination: z
+            .object({
+            page: z.number().describe('Current page number.'),
+            pages: z.number().describe('Total pages.'),
+            count: z.number().describe('Total results.'),
+            per_page: z.number().describe('Results per page.'),
+        })
+            .optional()
+            .describe('Page-based pagination info (aggregate modes only).'),
+    }),
+    async handler(input, ctx) {
+        const fec = getOpenFecService();
+        const mode = input.mode;
+        validateCommitteeId(input.committee_id);
+        /* ---------------------------------------------------------------- */
+        /*  Itemized disbursements (keyset/SEEK)                            */
+        /* ---------------------------------------------------------------- */
+        if (mode === 'itemized') {
+            const params = {
+                committee_id: input.committee_id,
+                per_page: input.per_page,
+            };
+            if (input.cycle)
+                params.two_year_transaction_period = input.cycle;
+            if (input.recipient_name)
+                params.recipient_name = input.recipient_name;
+            if (input.recipient_state)
+                params.recipient_state = input.recipient_state;
+            if (input.recipient_city)
+                params.recipient_city = input.recipient_city;
+            if (input.recipient_committee_id)
+                params.recipient_committee_id = input.recipient_committee_id;
+            if (input.disbursement_description)
+                params.disbursement_description = input.disbursement_description;
+            if (input.disbursement_purpose_category) {
+                params.disbursement_purpose_category = input.disbursement_purpose_category;
+            }
+            if (input.min_date)
+                params.min_date = input.min_date;
+            if (input.max_date)
+                params.max_date = input.max_date;
+            if (input.min_amount !== undefined)
+                params.min_amount = input.min_amount;
+            if (input.max_amount !== undefined)
+                params.max_amount = input.max_amount;
+            if (input.sort)
+                params.sort = input.sort;
+            if (input.cursor) {
+                const lastIndexes = decodeCursor(input.cursor);
+                Object.assign(params, lastIndexes);
+            }
+            const result = await fec.searchDisbursements(params, ctx);
+            ctx.log.info('Itemized disbursements fetched', {
+                committee_id: input.committee_id,
+                count: result.pagination.count,
+                returned: result.results.length,
+            });
+            return {
+                results: result.results,
+                next_cursor: result.nextCursor,
+                count: result.pagination.count,
+            };
+        }
+        /* ---------------------------------------------------------------- */
+        /*  Aggregate modes                                                 */
+        /* ---------------------------------------------------------------- */
+        const params = {
+            committee_id: input.committee_id,
+            per_page: input.per_page,
+        };
+        if (input.cycle)
+            params.cycle = input.cycle;
+        const result = await fec.getDisbursementAggregates(mode, params, ctx);
+        ctx.log.info('Disbursement aggregates fetched', {
+            mode,
+            committee_id: input.committee_id,
+            count: result.pagination.count,
+            returned: result.results.length,
+        });
+        return {
+            results: result.results,
+            pagination: result.pagination,
+        };
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [
+                {
+                    type: 'text',
+                    text: 'No disbursements found. Try a different cycle, broaden name/description filters, or verify the committee_id is correct.',
+                },
+            ];
+        }
+        const isItemized = 'next_cursor' in result && result.next_cursor !== undefined;
+        if (isItemized) {
+            const lines = [
+                `**${result.count?.toLocaleString() ?? '?'} total disbursements**\n`,
+            ];
+            for (const r of result.results) {
+                const recipient = r.recipient_name ?? 'Unknown';
+                const amount = fmt$(r.disbursement_amount);
+                const date = r.disbursement_date ?? '';
+                const desc = r.disbursement_description ?? '';
+                const purpose = r.disbursement_purpose_category ?? '';
+                const committee = r.committee_name ?? r.committee_id ?? '';
+                const city = r.recipient_city ?? '';
+                const state = r.recipient_state ?? '';
+                const location = [city, state].filter(Boolean).join(', ');
+                lines.push(`- **${recipient}** ${location ? `(${location})` : ''}`);
+                lines.push(`  ${amount} on ${date} from ${committee}`);
+                if (desc)
+                    lines.push(`  ${desc}`);
+                if (purpose && purpose !== desc)
+                    lines.push(`  Purpose: ${purpose}`);
+            }
+            if (result.next_cursor) {
+                lines.push(`\n_More results available — pass cursor to continue._`);
+            }
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        // Aggregate
+        const lines = [
+            `**${result.pagination?.count?.toLocaleString() ?? '?'} aggregate rows**\n`,
+        ];
+        for (const r of result.results) {
+            const dimension = r.purpose ?? r.recipient_name ?? r.recipient_id ?? r.committee_name ?? 'Unknown';
+            const total = fmt$(r.total);
+            const count = typeof r.count === 'number' ? ` (${r.count.toLocaleString()} transactions)` : '';
+            const pct = typeof r.recipient_disbursement_percent === 'number'
+                ? ` — ${r.recipient_disbursement_percent.toFixed(1)}%`
+                : '';
+            lines.push(`- **${dimension}**: ${total}${count}${pct}`);
+        }
+        if (result.pagination && result.pagination.page < result.pagination.pages) {
+            lines.push(`\n_Page ${result.pagination.page} of ${result.pagination.pages}_`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-disbursements.tool.js.map

package/dist/mcp-server/tools/definitions/search-disbursements.tool.js.map

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

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

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview Search independent expenditures (Schedule E) — outside spending
+ * by Super PACs, party committees, and other groups supporting or opposing
+ * federal candidates. Key dataset for tracking outside money in elections.
+ * @module mcp-server/tools/definitions/search-expenditures.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchExpenditures: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        itemized: "itemized";
+        by_candidate: "by_candidate";
+    }>>;
+    committee_id: z.ZodOptional<z.ZodString>;
+    candidate_id: z.ZodOptional<z.ZodString>;
+    support_oppose: z.ZodOptional<z.ZodEnum<{
+        S: "S";
+        O: "O";
+    }>>;
+    payee_name: z.ZodOptional<z.ZodString>;
+    candidate_office: z.ZodOptional<z.ZodEnum<{
+        H: "H";
+        S: "S";
+        P: "P";
+    }>>;
+    candidate_office_state: z.ZodOptional<z.ZodString>;
+    candidate_party: z.ZodOptional<z.ZodString>;
+    cycle: z.ZodOptional<z.ZodNumber>;
+    min_date: z.ZodOptional<z.ZodString>;
+    max_date: z.ZodOptional<z.ZodString>;
+    min_amount: z.ZodOptional<z.ZodNumber>;
+    max_amount: z.ZodOptional<z.ZodNumber>;
+    is_notice: z.ZodOptional<z.ZodBoolean>;
+    most_recent: z.ZodDefault<z.ZodBoolean>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        expenditure_date: "expenditure_date";
+        expenditure_amount: "expenditure_amount";
+        office_total_ytd: "office_total_ytd";
+    }>>;
+    per_page: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    count: z.ZodOptional<z.ZodNumber>;
+    pagination: z.ZodOptional<z.ZodObject<{
+        page: z.ZodNumber;
+        pages: z.ZodNumber;
+        count: z.ZodNumber;
+        per_page: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-expenditures.tool.d.ts.map

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

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

package/dist/mcp-server/tools/definitions/search-expenditures.tool.js

@@ -0,0 +1,247 @@
+/**
+ * @fileoverview Search independent expenditures (Schedule E) — outside spending
+ * by Super PACs, party committees, and other groups supporting or opposing
+ * federal candidates. Key dataset for tracking outside money in elections.
+ * @module mcp-server/tools/definitions/search-expenditures.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { invalidParams } from '@cyanheads/mcp-ts-core/errors';
+import { decodeCursor, getOpenFecService } from '../../../services/openfec/openfec-service.js';
+import { fmt$ } from './utils/format-helpers.js';
+import { validateCandidateId, validateCommitteeId } from './utils/id-validators.js';
+/** Expand S/O indicator to a readable label. */
+const supportOpposeLabel = (code) => code === 'S' ? 'SUPPORT' : code === 'O' ? 'OPPOSE' : String(code ?? '');
+const modes = ['itemized', 'by_candidate'];
+export const searchExpenditures = tool('openfec_search_expenditures', {
+    description: 'Search independent expenditures (Schedule E) — outside spending supporting or opposing ' +
+        'federal candidates. Covers Super PACs, party committees, and other groups. Use itemized ' +
+        'mode for individual expenditure records, or by_candidate for aggregated totals per candidate.',
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        mode: z
+            .enum(modes)
+            .default('itemized')
+            .describe('Query mode. "itemized" returns individual expenditure records (keyset pagination). ' +
+            '"by_candidate" returns aggregated totals per candidate by committee (page-based).'),
+        committee_id: z.string().optional().describe('Spending committee ID (e.g., C00703975).'),
+        candidate_id: z.string().optional().describe('Targeted candidate ID (e.g., P00003392).'),
+        support_oppose: z
+            .enum(['S', 'O'])
+            .optional()
+            .describe('S = support, O = oppose. Filter by whether the expenditure supports or opposes the candidate.'),
+        payee_name: z.string().optional().describe('Full-text payee name search. Itemized only.'),
+        candidate_office: z
+            .enum(['H', 'S', 'P'])
+            .optional()
+            .describe('Office of the targeted candidate: H=House, S=Senate, P=President.'),
+        candidate_office_state: z
+            .string()
+            .optional()
+            .describe('Two-letter state code of the targeted race.'),
+        candidate_party: z
+            .string()
+            .optional()
+            .describe('Three-letter party code of the targeted candidate (e.g., DEM, REP).'),
+        cycle: z.number().optional().describe('Two-year election cycle (e.g., 2024). Even years only.'),
+        min_date: z
+            .string()
+            .optional()
+            .describe('Earliest expenditure date (YYYY-MM-DD). Itemized only.'),
+        max_date: z
+            .string()
+            .optional()
+            .describe('Latest expenditure date (YYYY-MM-DD). Itemized only.'),
+        min_amount: z
+            .number()
+            .optional()
+            .describe('Minimum expenditure amount in dollars. Itemized only.'),
+        max_amount: z
+            .number()
+            .optional()
+            .describe('Maximum expenditure amount in dollars. Itemized only.'),
+        is_notice: z
+            .boolean()
+            .optional()
+            .describe('Only 24/48-hour notice filings (near-election spending). Itemized only.'),
+        most_recent: z
+            .boolean()
+            .default(true)
+            .describe('Only the most recent version of amended filings. Itemized only.'),
+        sort: z
+            .enum(['expenditure_date', 'expenditure_amount', 'office_total_ytd'])
+            .optional()
+            .describe('Sort field. Itemized only.'),
+        per_page: z.number().default(20).describe('Results per page (max 100).'),
+        cursor: z
+            .string()
+            .optional()
+            .describe('Opaque pagination cursor from a previous response. Itemized mode only (keyset pagination).'),
+    }),
+    output: z.object({
+        results: z
+            .array(z.record(z.string(), z.unknown()))
+            .describe('Expenditure records (itemized) or per-candidate aggregate rows.'),
+        next_cursor: z
+            .string()
+            .nullable()
+            .optional()
+            .describe('Pagination cursor for the next page of itemized results. Null when no more pages.'),
+        count: z.number().optional().describe('Total result count (may be approximate for itemized).'),
+        pagination: z
+            .object({
+            page: z.number().describe('Current page number.'),
+            pages: z.number().describe('Total pages.'),
+            count: z.number().describe('Total results.'),
+            per_page: z.number().describe('Results per page.'),
+        })
+            .optional()
+            .describe('Page-based pagination info (by_candidate mode only).'),
+    }),
+    async handler(input, ctx) {
+        const fec = getOpenFecService();
+        const mode = input.mode;
+        if (input.candidate_id)
+            validateCandidateId(input.candidate_id);
+        if (input.committee_id)
+            validateCommitteeId(input.committee_id);
+        /* ---------------------------------------------------------------- */
+        /*  Itemized expenditures (keyset/SEEK)                             */
+        /* ---------------------------------------------------------------- */
+        if (mode === 'itemized') {
+            const params = {
+                per_page: input.per_page,
+                most_recent: input.most_recent,
+            };
+            if (input.committee_id)
+                params.committee_id = input.committee_id;
+            if (input.candidate_id)
+                params.candidate_id = input.candidate_id;
+            if (input.support_oppose)
+                params.support_oppose_indicator = input.support_oppose;
+            if (input.payee_name)
+                params.payee_name = input.payee_name;
+            if (input.candidate_office)
+                params.candidate_office = input.candidate_office;
+            if (input.candidate_office_state)
+                params.candidate_office_state = input.candidate_office_state;
+            if (input.candidate_party)
+                params.candidate_party = input.candidate_party;
+            if (input.cycle)
+                params.cycle = input.cycle;
+            if (input.min_date)
+                params.min_date = input.min_date;
+            if (input.max_date)
+                params.max_date = input.max_date;
+            if (input.min_amount !== undefined)
+                params.min_amount = input.min_amount;
+            if (input.max_amount !== undefined)
+                params.max_amount = input.max_amount;
+            if (input.is_notice !== undefined)
+                params.is_notice = input.is_notice;
+            if (input.sort)
+                params.sort = input.sort;
+            if (input.cursor) {
+                const lastIndexes = decodeCursor(input.cursor);
+                Object.assign(params, lastIndexes);
+            }
+            const result = await fec.searchExpenditures(params, ctx);
+            ctx.log.info('Itemized expenditures fetched', {
+                committee_id: input.committee_id,
+                candidate_id: input.candidate_id,
+                count: result.pagination.count,
+                returned: result.results.length,
+            });
+            return {
+                results: result.results,
+                next_cursor: result.nextCursor,
+                count: result.pagination.count,
+            };
+        }
+        /* ---------------------------------------------------------------- */
+        /*  By candidate (page-based)                                       */
+        /* ---------------------------------------------------------------- */
+        if (!input.candidate_id) {
+            throw invalidParams('by_candidate mode requires a candidate_id. Use openfec_search_candidates to find the ID, then pass it here to see independent expenditures supporting or opposing that candidate.', { mode: input.mode });
+        }
+        const params = { per_page: input.per_page };
+        if (input.committee_id)
+            params.committee_id = input.committee_id;
+        if (input.candidate_id)
+            params.candidate_id = input.candidate_id;
+        if (input.support_oppose)
+            params.support_oppose_indicator = input.support_oppose;
+        if (input.candidate_office)
+            params.candidate_office = input.candidate_office;
+        if (input.candidate_office_state)
+            params.candidate_office_state = input.candidate_office_state;
+        if (input.candidate_party)
+            params.candidate_party = input.candidate_party;
+        if (input.cycle)
+            params.cycle = input.cycle;
+        const result = await fec.getExpendituresByCandidate(params, ctx);
+        ctx.log.info('Expenditures by candidate fetched', {
+            count: result.pagination.count,
+            returned: result.results.length,
+        });
+        return {
+            results: result.results,
+            pagination: result.pagination,
+        };
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [
+                {
+                    type: 'text',
+                    text: 'No independent expenditures found. Try a different cycle, broaden filters, or verify the candidate_id/committee_id. Not all races attract significant outside spending.',
+                },
+            ];
+        }
+        const isItemized = 'next_cursor' in result && result.next_cursor !== undefined;
+        if (isItemized) {
+            const lines = [
+                `**${result.count?.toLocaleString() ?? '?'} total independent expenditures**\n`,
+            ];
+            for (const r of result.results) {
+                const indicator = supportOpposeLabel(r.support_oppose_indicator);
+                const amount = fmt$(r.expenditure_amount);
+                const date = r.expenditure_date ?? '';
+                const committee = r.committee_name ?? r.committee_id ?? '';
+                const candidate = r.candidate_name ?? r.candidate_id ?? '';
+                const office = r.candidate_office ?? '';
+                const state = r.candidate_office_state ?? '';
+                const payee = r.payee_name ?? '';
+                const desc = r.expenditure_description ?? '';
+                const notice = r.is_notice ? ' [24/48h NOTICE]' : '';
+                lines.push(`- **[${indicator}]** ${amount} — ${candidate} (${office}${state ? `-${state}` : ''})${notice}`);
+                lines.push(`  By: ${committee} on ${date}`);
+                if (payee)
+                    lines.push(`  Payee: ${payee}`);
+                if (desc)
+                    lines.push(`  ${desc}`);
+            }
+            if (result.next_cursor) {
+                lines.push(`\n_More results available — pass cursor to continue._`);
+            }
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        // By candidate aggregate
+        const lines = [
+            `**${result.pagination?.count?.toLocaleString() ?? '?'} candidate-committee pairs**\n`,
+        ];
+        for (const r of result.results) {
+            const indicator = supportOpposeLabel(r.support_oppose_indicator);
+            const candidate = r.candidate_name ?? r.candidate_id ?? 'Unknown';
+            const committee = r.committee_name ?? r.committee_id ?? 'Unknown';
+            const total = fmt$(r.total);
+            const count = typeof r.count === 'number' ? ` (${r.count.toLocaleString()} expenditures)` : '';
+            lines.push(`- **[${indicator}]** ${candidate}`);
+            lines.push(`  ${total}${count} from ${committee}`);
+        }
+        if (result.pagination && result.pagination.page < result.pagination.pages) {
+            lines.push(`\n_Page ${result.pagination.page} of ${result.pagination.pages}_`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-expenditures.tool.js.map

package/dist/mcp-server/tools/definitions/search-expenditures.tool.js.map

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

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

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Tool for searching FEC filings and reports. Covers all
+ * disclosure documents: financial reports (F3/F3P/F3X), statements of
+ * candidacy, organizational filings, and amendments.
+ * @module mcp-server/tools/definitions/search-filings.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchFilings: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    committee_id: z.ZodOptional<z.ZodString>;
+    candidate_id: z.ZodOptional<z.ZodString>;
+    filer_name: z.ZodOptional<z.ZodString>;
+    form_type: z.ZodOptional<z.ZodString>;
+    report_type: z.ZodOptional<z.ZodString>;
+    report_year: z.ZodOptional<z.ZodNumber>;
+    cycle: z.ZodOptional<z.ZodNumber>;
+    is_amended: z.ZodOptional<z.ZodBoolean>;
+    most_recent: z.ZodOptional<z.ZodBoolean>;
+    min_receipt_date: z.ZodOptional<z.ZodString>;
+    max_receipt_date: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    per_page: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    filings: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pages: z.ZodNumber;
+        count: z.ZodNumber;
+        per_page: z.ZodNumber;
+    }, z.core.$strip>;
+}, 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;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;kBAkIxB,CAAC"}