us-gov-open-data-mcp 1.0.0

package/dist/modules/regulations.js

@@ -0,0 +1,173 @@
+/**
+ * Regulations.gov MCP module — search regulatory documents, public comments, and dockets.
+ */
+import { z } from "zod";
+import { searchDocuments, getDocument, searchComments, getComment, searchDockets, getDocket, } from "../sdk/regulations.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "regulations";
+export const displayName = "Regulations.gov";
+export const description = "Federal rulemaking: proposed rules, final rules, public comments, and regulatory dockets from all federal agencies";
+export const auth = { envVar: "DATA_GOV_API_KEY", signup: "https://api.data.gov/signup/" };
+export const workflow = "regulations_search_documents to find rules → regulations_document_detail for full info → regulations_search_comments for public feedback";
+export const tips = "Document types: 'Proposed Rule', 'Rule', 'Supporting & Related Material', 'Other'. Sort by '-postedDate' for newest first. Agency IDs: EPA, FDA, DOL, HHS, DOT, etc.";
+export const reference = {
+    documentTypes: {
+        "Proposed Rule": "Notice of proposed rulemaking (NPRM)",
+        "Rule": "Final rule",
+        "Supporting & Related Material": "Supporting documents, analyses, studies",
+        "Other": "Other documents",
+    },
+    docketTypes: {
+        "Rulemaking": "Rulemaking docket",
+        "Nonrulemaking": "Nonrulemaking docket",
+    },
+    docs: {
+        "API Docs": "https://open.gsa.gov/api/regulationsgov/",
+        "Regulations.gov": "https://www.regulations.gov/",
+    },
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "regulations_search_documents",
+        description: "Search for federal regulatory documents — proposed rules, final rules, and supporting materials.\n" +
+            "Filter by agency, docket, date, or keyword. Complements Federal Register data with rulemaking context.\n\n" +
+            "Document types: 'Proposed Rule', 'Rule', 'Supporting & Related Material', 'Other'.\n" +
+            "Sort: 'postedDate' (asc) or '-postedDate' (desc, newest first).",
+        annotations: { title: "Regulations.gov: Search Documents", readOnlyHint: true },
+        parameters: z.object({
+            searchTerm: z.string().optional().describe("Full-text search keyword (e.g. 'water quality', 'emissions')"),
+            agencyId: z.string().optional().describe("Agency abbreviation: 'EPA', 'FDA', 'DOL', 'HHS', 'DOT', 'OSHA'"),
+            docketId: z.string().optional().describe("Docket ID (e.g. 'EPA-HQ-OAR-2003-0129')"),
+            documentType: z.string().optional().describe("'Proposed Rule', 'Rule', 'Supporting & Related Material', 'Other'"),
+            postedDate: z.string().optional().describe("Exact date: '2024-01-15'"),
+            postedDateGe: z.string().optional().describe("Posted on or after date: '2024-01-01'"),
+            postedDateLe: z.string().optional().describe("Posted on or before date: '2024-12-31'"),
+            sort: z.string().optional().describe("Sort field: 'postedDate', '-postedDate', 'title', '-title'"),
+            pageSize: z.number().int().max(250).optional().describe("Results per page (max 250, default 25)"),
+            pageNumber: z.number().int().optional().describe("Page number (1-based)"),
+        }),
+        execute: async (args) => {
+            const data = await searchDocuments(args);
+            if (!data.data?.length)
+                return `No documents found${args.searchTerm ? ` for '${args.searchTerm}'` : ""}.`;
+            return JSON.stringify({
+                summary: `Found ${data.meta?.totalElements ?? data.data.length} regulatory documents${args.agencyId ? ` from ${args.agencyId}` : ""}${args.searchTerm ? ` matching '${args.searchTerm}'` : ""}, showing ${data.data.length}`,
+                total: data.meta?.totalElements,
+                documents: data.data.map(d => ({
+                    documentId: d.id,
+                    title: d.attributes.title,
+                    agency: d.attributes.agencyId,
+                    type: d.attributes.documentType,
+                    docket: d.attributes.docketId,
+                    posted: d.attributes.postedDate,
+                    commentEndDate: d.attributes.commentEndDate,
+                    withdrawn: d.attributes.withdrawn,
+                })),
+            });
+        },
+    },
+    {
+        name: "regulations_document_detail",
+        description: "Get detailed information for a specific regulatory document by its document ID (e.g. 'FDA-2009-N-0501-0012').",
+        annotations: { title: "Regulations.gov: Document Detail", readOnlyHint: true },
+        parameters: z.object({
+            documentId: z.string().describe("Document ID (e.g. 'FDA-2009-N-0501-0012', 'EPA-HQ-OAR-2021-0208-0001')"),
+        }),
+        execute: async ({ documentId }) => {
+            const data = await getDocument(documentId);
+            return JSON.stringify(data.data);
+        },
+    },
+    {
+        name: "regulations_search_comments",
+        description: "Search for public comments on federal regulations.\n" +
+            "Filter by keyword, agency, docket, or date. Shows what the public said about proposed rules.\n\n" +
+            "Sort: 'postedDate' (asc) or '-postedDate' (desc, newest first).",
+        annotations: { title: "Regulations.gov: Search Comments", readOnlyHint: true },
+        parameters: z.object({
+            searchTerm: z.string().optional().describe("Keyword search in comments"),
+            agencyId: z.string().optional().describe("Agency abbreviation: 'EPA', 'FDA', 'DOL'"),
+            docketId: z.string().optional().describe("Docket ID to get comments for a specific rulemaking"),
+            postedDateGe: z.string().optional().describe("Comments posted on or after date: '2024-01-01'"),
+            postedDateLe: z.string().optional().describe("Comments posted on or before date: '2024-12-31'"),
+            sort: z.string().optional().describe("'-postedDate' for newest first, 'postedDate' for oldest first"),
+            pageSize: z.number().int().max(250).optional().describe("Results per page (max 250, default 25)"),
+            pageNumber: z.number().int().optional().describe("Page number (1-based)"),
+        }),
+        execute: async (args) => {
+            const data = await searchComments(args);
+            if (!data.data?.length)
+                return `No comments found${args.searchTerm ? ` for '${args.searchTerm}'` : ""}.`;
+            return JSON.stringify({
+                summary: `Found ${data.meta?.totalElements ?? data.data.length} public comments${args.agencyId ? ` for ${args.agencyId}` : ""}${args.docketId ? ` on docket ${args.docketId}` : ""}, showing ${data.data.length}`,
+                total: data.meta?.totalElements,
+                comments: data.data.map(c => ({
+                    commentId: c.id,
+                    title: c.attributes.title,
+                    agency: c.attributes.agencyId,
+                    docket: c.attributes.docketId,
+                    posted: c.attributes.postedDate,
+                    comment: c.attributes.comment,
+                })),
+            });
+        },
+    },
+    {
+        name: "regulations_comment_detail",
+        description: "Get detailed information for a specific public comment by its comment ID.",
+        annotations: { title: "Regulations.gov: Comment Detail", readOnlyHint: true },
+        parameters: z.object({
+            commentId: z.string().describe("Comment ID (e.g. 'HHS-OCR-2018-0002-5313')"),
+        }),
+        execute: async ({ commentId }) => {
+            const data = await getComment(commentId);
+            return JSON.stringify(data.data);
+        },
+    },
+    {
+        name: "regulations_search_dockets",
+        description: "Search for regulatory dockets — organizational folders containing related rules, comments, and documents.\n" +
+            "Each docket represents a rulemaking or non-rulemaking action by a federal agency.\n\n" +
+            "Sort: 'title', '-title'.",
+        annotations: { title: "Regulations.gov: Search Dockets", readOnlyHint: true },
+        parameters: z.object({
+            searchTerm: z.string().optional().describe("Keyword search (e.g. 'clean air', 'food safety')"),
+            agencyId: z.string().optional().describe("Agency abbreviation: 'EPA', 'FDA', 'DOL', 'HHS'. Comma-separate for multiple: 'EPA,FDA'"),
+            docketType: z.string().optional().describe("'Rulemaking' or 'Nonrulemaking'"),
+            sort: z.string().optional().describe("'title' or '-title'"),
+            pageSize: z.number().int().max(250).optional().describe("Results per page (max 250, default 25)"),
+            pageNumber: z.number().int().optional().describe("Page number (1-based)"),
+        }),
+        execute: async (args) => {
+            const data = await searchDockets(args);
+            if (!data.data?.length)
+                return `No dockets found${args.searchTerm ? ` for '${args.searchTerm}'` : ""}.`;
+            return JSON.stringify({
+                summary: `Found ${data.meta?.totalElements ?? data.data.length} dockets${args.agencyId ? ` from ${args.agencyId}` : ""}, showing ${data.data.length}`,
+                total: data.meta?.totalElements,
+                dockets: data.data.map(d => ({
+                    docketId: d.id,
+                    title: d.attributes.title,
+                    agency: d.attributes.agencyId,
+                    type: d.attributes.docketType,
+                    lastModified: d.attributes.lastModifiedDate,
+                })),
+            });
+        },
+    },
+    {
+        name: "regulations_docket_detail",
+        description: "Get detailed information for a specific regulatory docket by its docket ID (e.g. 'EPA-HQ-OAR-2003-0129').",
+        annotations: { title: "Regulations.gov: Docket Detail", readOnlyHint: true },
+        parameters: z.object({
+            docketId: z.string().describe("Docket ID (e.g. 'EPA-HQ-OAR-2003-0129')"),
+        }),
+        execute: async ({ docketId }) => {
+            const data = await getDocket(docketId);
+            return JSON.stringify(data.data);
+        },
+    },
+];
+export { clearCache } from "../sdk/regulations.js";
+//# sourceMappingURL=regulations.js.map

package/dist/modules/regulations.js.map

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

package/dist/modules/sec.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SEC EDGAR MCP module — tools + metadata. Delegates all API calls to sdk/sec.
+ *
+ * Tools return raw JSON data — no markdown formatting. The client decides how to present it.
+ */
+import type { Tool, InputPrompt } from "fastmcp";
+export declare const name = "sec";
+export declare const displayName = "SEC EDGAR";
+export declare const description = "Company filings, financial data (XBRL), and full-text search across SEC EDGAR";
+export declare const workflow = "sec_filing_search to find companies/CIKs \u2192 sec_company_search for details \u2192 sec_company_financials for XBRL data";
+export declare const tips = "No API key required. Rate limit: 10 req/sec. CIK numbers must be looked up first \u2014 use sec_filing_search to find them by company name.";
+export declare const reference: {
+    xbrlConcepts: Record<string, string>;
+    commonCiks: Record<string, string>;
+    docs: {
+        "Developer Resources": string;
+        "EDGAR APIs": string;
+        "Full-Text Search": string;
+        "Fair Access Policy": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export declare const prompts: InputPrompt<any, any>[];
+export { clearCache } from "../sdk/sec.js";
+//# sourceMappingURL=sec.d.ts.map

package/dist/modules/sec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sec.d.ts","sourceRoot":"","sources":["../../src/modules/sec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAajD,eAAO,MAAM,IAAI,QAAQ,CAAC;AAC1B,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,WAAW,kFAAkF,CAAC;AAC3G,eAAO,MAAM,QAAQ,+HAAqH,CAAC;AAC3I,eAAO,MAAM,IAAI,gJAA2I,CAAC;AAE7J,eAAO,MAAM,SAAS;kBACU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;gBAU/C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;CAO5B,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAyJjC,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAe1C,CAAC;AAIF,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/modules/sec.js

@@ -0,0 +1,192 @@
+/**
+ * SEC EDGAR MCP module — tools + metadata. Delegates all API calls to sdk/sec.
+ *
+ * Tools return raw JSON data — no markdown formatting. The client decides how to present it.
+ */
+import { z } from "zod";
+import { getCompanyByCik, getCompanyFacts, searchEdgar, extractConceptData, summarizeFinancials, xbrlConcepts, } from "../sdk/sec.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "sec";
+export const displayName = "SEC EDGAR";
+export const description = "Company filings, financial data (XBRL), and full-text search across SEC EDGAR";
+export const workflow = "sec_filing_search to find companies/CIKs → sec_company_search for details → sec_company_financials for XBRL data";
+export const tips = "No API key required. Rate limit: 10 req/sec. CIK numbers must be looked up first — use sec_filing_search to find them by company name.";
+export const reference = {
+    xbrlConcepts: xbrlConcepts,
+    commonCiks: {
+        "0000320193": "Apple",
+        "0000789019": "Microsoft",
+        "0001018724": "Amazon",
+        "0000936468": "Lockheed Martin",
+        "0000101829": "Raytheon (RTX)",
+        "0000012927": "Boeing",
+        "0000040533": "General Dynamics",
+        "0001133421": "Northrop Grumman",
+    },
+    docs: {
+        "Developer Resources": "https://www.sec.gov/about/developer-resources",
+        "EDGAR APIs": "https://www.sec.gov/page/edgar-application-programming-interfaces-old",
+        "Full-Text Search": "https://efts.sec.gov/LATEST/",
+        "Fair Access Policy": "https://www.sec.gov/privacy.htm#security",
+    },
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "sec_company_search",
+        description: "Look up a company on SEC EDGAR by CIK number. Returns company name, " +
+            "tickers, SIC code, state, and recent filings list.\n\n" +
+            "Common CIK numbers:\n" +
+            "- Apple: 0000320193\n" +
+            "- Microsoft: 0000789019\n" +
+            "- Amazon: 0001018724\n" +
+            "- Lockheed Martin: 0000936468\n" +
+            "- Raytheon (RTX): 0000101829\n" +
+            "- Boeing: 0000012927\n\n" +
+            "To find CIK: search by company name using sec_filing_search.",
+        annotations: { title: "SEC: Company Lookup", readOnlyHint: true },
+        parameters: z.object({
+            cik: z.string().describe("10-digit CIK number (e.g., '0000320193' for Apple). Leading zeros optional."),
+        }),
+        execute: async ({ cik }) => {
+            const res = await getCompanyByCik(cik);
+            const filings = res.filings?.recent;
+            const forms = filings?.form || [];
+            const dates = filings?.filingDate || [];
+            const descriptions = filings?.primaryDocDescription || [];
+            const accessions = filings?.accessionNumber || [];
+            // Last 15 non-insider filings (skip Form 3, 4, 5, 144)
+            const majorFilings = [];
+            for (let i = 0; i < forms.length && majorFilings.length < 15; i++) {
+                if (["3", "4", "5", "144"].includes(forms[i]))
+                    continue;
+                majorFilings.push({
+                    form: forms[i],
+                    date: dates[i],
+                    description: descriptions[i] || "No description",
+                    accessionNumber: accessions[i],
+                });
+            }
+            return JSON.stringify({
+                summary: `SEC EDGAR: ${res.name || "Unknown"} (CIK ${res.cik}) — ${res.tickers?.join(", ") || "no tickers"}`,
+                company: {
+                    cik: res.cik,
+                    name: res.name,
+                    tickers: res.tickers || [],
+                    exchanges: res.exchanges || [],
+                    sic: res.sic,
+                    sicDescription: res.sicDescription,
+                    stateOfIncorporation: res.stateOfIncorporation,
+                    entityType: res.entityType,
+                    category: res.category,
+                    fiscalYearEnd: res.fiscalYearEnd,
+                    formerNames: res.formerNames || [],
+                },
+                recentFilings: majorFilings,
+            });
+        },
+    },
+    {
+        name: "sec_company_financials",
+        description: "Get financial data (revenue, net income, assets, etc.) from SEC XBRL filings for a company. " +
+            "Returns standardized financial data extracted from 10-K and 10-Q filings.\n\n" +
+            "Requires CIK number. Use sec_company_search to look up filings first.\n\n" +
+            "Common XBRL concepts: Revenues, NetIncomeLoss, Assets, Liabilities, " +
+            "StockholdersEquity, EarningsPerShareBasic, CashAndCashEquivalentsAtCarryingValue",
+        annotations: { title: "SEC: Company Financial Facts", readOnlyHint: true },
+        parameters: z.object({
+            cik: z.string().describe("10-digit CIK number (e.g., '0000320193' for Apple)"),
+            metric: z.string().optional().describe("Specific XBRL concept to retrieve (e.g., 'Revenues', 'NetIncomeLoss', 'Assets'). " +
+                "Omit to get a summary of available key metrics."),
+        }),
+        execute: async ({ cik, metric }) => {
+            const facts = await getCompanyFacts(cik);
+            const usgaap = facts.facts["us-gaap"];
+            if (!usgaap) {
+                return JSON.stringify({ summary: `No US-GAAP financial data found for CIK ${cik}.`, data: null });
+            }
+            // Specific metric requested
+            if (metric) {
+                const data = extractConceptData(facts, metric);
+                if (!data) {
+                    const available = Object.keys(usgaap).slice(0, 30);
+                    return JSON.stringify({
+                        summary: `Metric "${metric}" not found for ${facts.entityName}. Showing first 30 available metrics.`,
+                        availableMetrics: available,
+                    });
+                }
+                return JSON.stringify({
+                    summary: `${facts.entityName} — ${data.concept} (${data.label}): ${data.annual.length} annual + ${data.quarterly.length} quarterly observations`,
+                    entityName: facts.entityName,
+                    concept: data.concept,
+                    label: data.label,
+                    description: data.description,
+                    unit: data.unit,
+                    annual: data.annual.map(d => ({ period: d.end, value: d.val, filed: d.filed })),
+                    quarterly: data.quarterly.map(d => ({ period: d.end, value: d.val, filed: d.filed })),
+                });
+            }
+            // Summary of key metrics
+            const summary = summarizeFinancials(facts);
+            return JSON.stringify({
+                summary: `SEC Financial Facts: ${summary.entityName} — ${summary.keyMetrics.length} key metrics found (${summary.totalMetrics} total available)`,
+                ...summary,
+            });
+        },
+    },
+    {
+        name: "sec_filing_search",
+        description: "Full-text search across all SEC EDGAR filings. " +
+            "Search by company name, keyword, or topic.\n\n" +
+            "Form types: 10-K (annual), 10-Q (quarterly), 8-K (current events), " +
+            "DEF 14A (proxy), S-1 (IPO registration)",
+        annotations: { title: "SEC: Search Filings", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().describe("Search query — company name, keyword, or topic"),
+            forms: z.string().optional().describe("Comma-separated form types to filter: '10-K', '10-Q', '8-K', 'DEF 14A', 'S-1'"),
+            start_date: z.string().optional().describe("Start date YYYY-MM-DD"),
+            end_date: z.string().optional().describe("End date YYYY-MM-DD"),
+        }),
+        execute: async ({ query, forms, start_date, end_date }) => {
+            const result = await searchEdgar(query, {
+                forms,
+                startDate: start_date,
+                endDate: end_date,
+            });
+            if (result.hits.length === 0) {
+                return JSON.stringify({ summary: `No filings found for "${query}".`, total: 0, filings: [] });
+            }
+            const filings = result.hits.slice(0, 20).map(hit => ({
+                company: hit.names[0] || "?",
+                form: hit.form,
+                date: hit.date,
+                description: hit.description,
+            }));
+            return JSON.stringify({
+                summary: `SEC filing search "${query}": ${result.total} results, showing ${filings.length}`,
+                total: result.total,
+                filings,
+            });
+        },
+    },
+];
+export const prompts = [
+    {
+        name: "company_snapshot",
+        description: "Quick financial overview of a public company from SEC filings.",
+        arguments: [
+            { name: "company", description: "Company name or ticker", required: true },
+        ],
+        load: async (args) => {
+            const company = args?.company ?? "";
+            return (`Get a financial snapshot of ${company}:\n\n` +
+                `1. Use sec_company_search to find the company and get its CIK number\n` +
+                "2. Use sec_company_financials with the CIK to get recent financials\n" +
+                "   Request these metrics: Revenues, NetIncomeLoss, Assets, Liabilities, EarningsPerShareDiluted\n\n" +
+                "Present the last 3-4 years of financial data as a summary. Note trends in revenue, profitability, and debt levels.");
+        },
+    },
+];
+// ─── Re-export cache control from SDK ────────────────────────────────
+export { clearCache } from "../sdk/sec.js";
+//# sourceMappingURL=sec.js.map

package/dist/modules/sec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sec.js","sourceRoot":"","sources":["../../src/modules/sec.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GAEb,MAAM,eAAe,CAAC;AAEvB,wEAAwE;AAExE,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC;AAC1B,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,+EAA+E,CAAC;AAC3G,MAAM,CAAC,MAAM,QAAQ,GAAG,kHAAkH,CAAC;AAC3I,MAAM,CAAC,MAAM,IAAI,GAAG,wIAAwI,CAAC;AAE7J,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE,YAAsC;IACpD,UAAU,EAAE;QACV,YAAY,EAAE,OAAO;QACrB,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,iBAAiB;QAC/B,YAAY,EAAE,gBAAgB;QAC9B,YAAY,EAAE,QAAQ;QACtB,YAAY,EAAE,kBAAkB;QAChC,YAAY,EAAE,kBAAkB;KACP;IAC3B,IAAI,EAAE;QACJ,qBAAqB,EAAE,+CAA+C;QACtE,YAAY,EAAE,uEAAuE;QACrF,kBAAkB,EAAE,8BAA8B;QAClD,oBAAoB,EAAE,0CAA0C;KACjE;CACF,CAAC;AAEF,wEAAwE;AAExE,MAAM,CAAC,MAAM,KAAK,GAAqB;IACrC;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,sEAAsE;YACtE,wDAAwD;YACxD,uBAAuB;YACvB,uBAAuB;YACvB,2BAA2B;YAC3B,wBAAwB;YACxB,iCAAiC;YACjC,gCAAgC;YAChC,0BAA0B;YAC1B,8DAA8D;QAChE,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,IAAI,EAAE;QACjE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;SACxG,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;YACzB,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;YAEvC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;YACpC,MAAM,KAAK,GAAG,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;YACxC,MAAM,YAAY,GAAG,OAAO,EAAE,qBAAqB,IAAI,EAAE,CAAC;YAC1D,MAAM,UAAU,GAAG,OAAO,EAAE,eAAe,IAAI,EAAE,CAAC;YAElD,uDAAuD;YACvD,MAAM,YAAY,GAAgB,EAAE,CAAC;YACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAAE,SAAS;gBACxD,YAAY,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;oBACd,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;oBACd,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,gBAAgB;oBAChD,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC;iBAC/B,CAAC,CAAC;YACL,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,cAAc,GAAG,CAAC,IAAI,IAAI,SAAS,SAAS,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,EAAE;gBAC5G,OAAO,EAAE;oBACP,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;oBAC1B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;oBAC9B,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,cAAc,EAAE,GAAG,CAAC,cAAc;oBAClC,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;oBAC9C,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,aAAa,EAAE,GAAG,CAAC,aAAa;oBAChC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;iBACnC;gBACD,aAAa,EAAE,YAAY;aAC5B,CAAC,CAAC;QACL,CAAC;KACF;IAED;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,8FAA8F;YAC9F,+EAA+E;YAC/E,2EAA2E;YAC3E,sEAAsE;YACtE,kFAAkF;QACpF,WAAW,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,YAAY,EAAE,IAAI,EAAE;QAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;YAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACpC,mFAAmF;gBACnF,iDAAiD,CAClD;SACF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;YACjC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,2CAA2C,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACpG,CAAC;YAED,4BAA4B;YAC5B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACnD,OAAO,IAAI,CAAC,SAAS,CAAC;wBACpB,OAAO,EAAE,WAAW,MAAM,mBAAmB,KAAK,CAAC,UAAU,uCAAuC;wBACpG,gBAAgB,EAAE,SAAS;qBAC5B,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,OAAO,EAAE,GAAG,KAAK,CAAC,UAAU,MAAM,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,aAAa,IAAI,CAAC,SAAS,CAAC,MAAM,yBAAyB;oBAChJ,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;oBAC/E,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;iBACtF,CAAC,CAAC;YACL,CAAC;YAED,yBAAyB;YACzB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,wBAAwB,OAAO,CAAC,UAAU,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,uBAAuB,OAAO,CAAC,YAAY,mBAAmB;gBAChJ,GAAG,OAAO;aACX,CAAC,CAAC;QACL,CAAC;KACF;IAED;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,iDAAiD;YACjD,gDAAgD;YAChD,qEAAqE;YACrE,yCAAyC;QAC3C,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,IAAI,EAAE;QACjE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC5E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;YACtH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACnE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SAChE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE;gBACtC,KAAK;gBACL,SAAS,EAAE,UAAU;gBACrB,OAAO,EAAE,QAAQ;aAClB,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,yBAAyB,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAChG,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnD,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG;gBAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,WAAW,EAAE,GAAG,CAAC,WAAW;aAC7B,CAAC,CAAC,CAAC;YAEJ,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,sBAAsB,KAAK,MAAM,MAAM,CAAC,KAAK,qBAAqB,OAAO,CAAC,MAAM,EAAE;gBAC3F,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO;aACR,CAAC,CAAC;QACL,CAAC;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAA4B;IAC9C;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,gEAAgE;QAC7E,SAAS,EAAE;YACT,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC3E;QACD,IAAI,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;YAAG,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;YAAC,OAAO,CACvE,+BAA+B,OAAO,OAAO;gBAC7C,wEAAwE;gBACxE,uEAAuE;gBACvE,qGAAqG;gBACrG,oHAAoH,CACrH,CAAC;QAAC,CAAC;KACL;CACF,CAAC;AAEF,wEAAwE;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/modules/senate-lobbying.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Senate Lobbying Disclosure MCP module — follow the money from lobbyists to legislation.
+ */
+import type { Tool } from "fastmcp";
+export declare const name = "senate-lobbying";
+export declare const displayName = "Senate Lobbying Disclosures";
+export declare const description = "Lobbying filings, expenditures, activities, and campaign contributions \u2014 who is lobbying Congress, on what issues, and how much they're spending";
+export declare const workflow = "lobbying_search to find filings by company/issue \u2192 lobbying_detail for specific bills lobbied \u2192 lobbying_contributions for campaign donations by lobbyists. For conflict-of-interest investigations: search by trade group AND individual companies to get total industry lobbying spend across 3+ years around a vote.";
+export declare const tips: string;
+export declare const reference: {
+    filingTypes: Record<string, string>;
+    issueCodes: Record<string, string>;
+    docs: {
+        "LDA API": string;
+        "LDA Search": string;
+        "Lobbying Disclosure Act": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export { clearCache } from "../sdk/senate-lobbying.js";
+//# sourceMappingURL=senate-lobbying.d.ts.map

package/dist/modules/senate-lobbying.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senate-lobbying.d.ts","sourceRoot":"","sources":["../../src/modules/senate-lobbying.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAGpC,eAAO,MAAM,IAAI,oBAAoB,CAAC;AACtC,eAAO,MAAM,WAAW,gCAAgC,CAAC;AACzD,eAAO,MAAM,WAAW,0JAAqJ,CAAC;AAC9K,eAAO,MAAM,QAAQ,sUAA4T,CAAC;AAClV,eAAO,MAAM,IAAI,QAM+E,CAAC;AAEjG,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC;AAuBF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAsJjC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}