us-gov-open-data-mcp 1.0.0

package/dist/modules/senate-lobbying.js

@@ -0,0 +1,189 @@
+/**
+ * Senate Lobbying Disclosure MCP module — follow the money from lobbyists to legislation.
+ */
+import { z } from "zod";
+import { searchFilings, getFilingDetail, searchContributions, searchRegistrants, searchLobbyists, FILING_TYPES, ISSUE_CODES } from "../sdk/senate-lobbying.js";
+export const name = "senate-lobbying";
+export const displayName = "Senate Lobbying Disclosures";
+export const description = "Lobbying filings, expenditures, activities, and campaign contributions — who is lobbying Congress, on what issues, and how much they're spending";
+export const workflow = "lobbying_search to find filings by company/issue → lobbying_detail for specific bills lobbied → 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 const tips = "Search by registrant_name (lobbying firm or self-filer like 'Pfizer'), client_name (who hired the lobbyist), " +
+    "or issue_code (TAX, HCR, DEF, etc.). Filing types: Q1-Q4 (quarterly), RN (new registration). " +
+    "Expenses are in dollars. No API key required. " +
+    "KEY TRADE GROUPS: 'American Bankers Association' (banking), 'PhRMA' or 'Pharmaceutical Research' (pharma), " +
+    "'American Petroleum Institute' (oil/gas), 'National Association of Realtors' (real estate). " +
+    "Always search BOTH the trade group AND individual companies for a complete lobbying picture.";
+export const reference = {
+    filingTypes: FILING_TYPES,
+    issueCodes: ISSUE_CODES,
+    docs: {
+        "LDA API": "https://lda.gov/api/v1/",
+        "LDA Search": "https://lda.gov/filings/public/filing/search/",
+        "Lobbying Disclosure Act": "https://lobbyingdisclosure.house.gov/",
+    },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function summarizeFiling(f) {
+    return {
+        uuid: f.filing_uuid,
+        type: f.filing_type_display,
+        year: f.filing_year,
+        period: f.filing_period_display,
+        registrant: f.registrant?.name,
+        client: f.client?.name,
+        clientDescription: f.client?.general_description,
+        income: f.income ? `$${Number(f.income).toLocaleString()}` : null,
+        expenses: f.expenses ? `$${Number(f.expenses).toLocaleString()}` : null,
+        issuesLobbied: f.lobbying_activities?.map((a) => a.general_issue_code_display).filter(Boolean),
+        documentUrl: f.filing_document_url,
+        posted: f.dt_posted,
+    };
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "lobbying_search",
+        description: "Search lobbying disclosure filings — find out who is lobbying Congress, on what issues, and how much they're spending.\n\n" +
+            "Search by:\n" +
+            "- registrant_name: lobbying firm or self-filing org ('Pfizer', 'Amazon', 'National Rifle Association')\n" +
+            "- client_name: who hired the lobbyist ('Google', 'ExxonMobil')\n" +
+            "- issue_code: policy area ('TAX', 'HCR' health, 'DEF' defense, 'ENV' environment, 'ENG' energy, 'IMM' immigration)\n" +
+            "- filing_year: year of filing (2020-2026)\n\n" +
+            "Returns expenses/income amounts, issues lobbied, and registrant/client info.",
+        annotations: { title: "Lobbying: Search Filings", readOnlyHint: true },
+        parameters: z.object({
+            registrant_name: z.string().optional().describe("Lobbying firm or organization: 'Pfizer', 'Amazon', 'US Chamber of Commerce'"),
+            client_name: z.string().optional().describe("Client who hired the lobbyist: 'Google', 'Meta', 'Boeing'"),
+            issue_code: z.string().optional().describe("Issue area code: 'TAX' (taxation), 'HCR' (health), 'DEF' (defense), 'ENV' (environment), 'ENG' (energy), 'IMM' (immigration), 'BUD' (budget), 'FIN' (finance), 'EDU' (education)"),
+            filing_year: z.number().int().optional().describe("Year: 2020-2026"),
+            filing_type: z.string().optional().describe("'Q1','Q2','Q3','Q4' (quarterly), 'RN' (new registration)"),
+            page_size: z.number().int().max(25).optional().describe("Results per page (default 20)"),
+        }),
+        execute: async ({ registrant_name, client_name, issue_code, filing_year, filing_type, page_size }) => {
+            const data = await searchFilings({ registrant_name, client_name, issue_code, filing_year, filing_type, page_size });
+            if (!data.results?.length)
+                return "No lobbying filings found.";
+            return JSON.stringify({
+                summary: `Lobbying filings: ${data.count} total, showing ${data.results.length}`,
+                total: data.count,
+                filings: data.results.map(summarizeFiling),
+            });
+        },
+    },
+    {
+        name: "lobbying_detail",
+        description: "Get full detail on a specific lobbying filing — shows every issue lobbied, specific bills mentioned, and lobbyist names.\n" +
+            "Use the filing UUID from lobbying_search results.",
+        annotations: { title: "Lobbying: Filing Detail", readOnlyHint: true },
+        parameters: z.object({
+            filing_uuid: z.string().describe("Filing UUID from lobbying_search results"),
+        }),
+        execute: async ({ filing_uuid }) => {
+            const f = await getFilingDetail(filing_uuid);
+            return JSON.stringify({
+                summary: `Lobbying filing: ${f.registrant?.name} for ${f.client?.name} (${f.filing_year} ${f.filing_type_display})`,
+                registrant: f.registrant?.name,
+                client: f.client?.name,
+                clientDescription: f.client?.general_description,
+                expenses: f.expenses ? `$${Number(f.expenses).toLocaleString()}` : null,
+                income: f.income ? `$${Number(f.income).toLocaleString()}` : null,
+                activities: f.lobbying_activities?.map((a) => ({
+                    issue: a.general_issue_code_display,
+                    description: a.description,
+                    lobbyists: a.lobbyists?.map((l) => l.lobbyist_full_display_name).filter(Boolean),
+                })),
+                documentUrl: f.filing_document_url,
+            });
+        },
+    },
+    {
+        name: "lobbying_contributions",
+        description: "Search campaign contributions made by lobbyists — shows which lobbyists donated to which politicians.\n" +
+            "Required under the LDA to disclose political contributions by registered lobbyists.",
+        annotations: { title: "Lobbying: Campaign Contributions", readOnlyHint: true },
+        parameters: z.object({
+            filing_year: z.number().int().optional().describe("Year: 2020-2026"),
+            registrant_name: z.string().optional().describe("Lobbying firm name"),
+            lobbyist_name: z.string().optional().describe("Individual lobbyist name"),
+            page_size: z.number().int().max(25).optional().describe("Results per page (default 20)"),
+        }),
+        execute: async ({ filing_year, registrant_name, lobbyist_name, page_size }) => {
+            const data = await searchContributions({ filing_year, registrant_name, lobbyist_name, page_size });
+            if (!data.results?.length)
+                return "No contribution filings found.";
+            // Flatten nested contribution_items from each filing
+            const allContributions = [];
+            for (const filing of data.results) {
+                if (!filing.contribution_items?.length)
+                    continue;
+                for (const item of filing.contribution_items) {
+                    allContributions.push({
+                        lobbyist: filing.lobbyist ? `${filing.lobbyist.first_name} ${filing.lobbyist.last_name}`.trim() : null,
+                        registrant: filing.registrant?.name,
+                        filerType: filing.filer_type_display,
+                        recipient: item.payee_name,
+                        honoree: item.honoree_name,
+                        amount: item.amount ? `$${Number(item.amount).toLocaleString()}` : null,
+                        date: item.date,
+                        type: item.contribution_type_display,
+                        contributor: item.contributor_name,
+                    });
+                }
+            }
+            const filingsWithItems = data.results.filter((r) => r.contribution_items?.length > 0).length;
+            return JSON.stringify({
+                summary: `Lobbying contributions: ${data.count} filings total, ${filingsWithItems} with contribution items, ${allContributions.length} individual contributions`,
+                totalFilings: data.count,
+                filingsWithContributions: filingsWithItems,
+                contributions: allContributions.slice(0, 50),
+            });
+        },
+    },
+    {
+        name: "lobbying_registrants",
+        description: "Search lobbying firms and organizations registered to lobby Congress.",
+        annotations: { title: "Lobbying: Search Registrants", readOnlyHint: true },
+        parameters: z.object({
+            name: z.string().describe("Registrant name: 'Amazon', 'Pfizer', 'National Rifle Association'"),
+            page_size: z.number().int().max(25).optional().describe("Results per page (default 20)"),
+        }),
+        execute: async ({ name, page_size }) => {
+            const data = await searchRegistrants({ registrant_name: name, page_size });
+            if (!data.results?.length)
+                return `No registrants found matching "${name}".`;
+            return JSON.stringify({
+                summary: `Lobbying registrants matching "${name}": ${data.count} found`,
+                registrants: data.results.map((r) => ({
+                    id: r.id, name: r.name, description: r.description,
+                    address: `${r.address_1}, ${r.city}, ${r.state}`,
+                    contact: r.contact_name, phone: r.contact_telephone,
+                })),
+            });
+        },
+    },
+    {
+        name: "lobbying_lobbyists",
+        description: "Search individual lobbyists by name or firm.\n" +
+            "Find specific people who lobby Congress and which firms they work for.",
+        annotations: { title: "Lobbying: Lobbyist Search", readOnlyHint: true },
+        parameters: z.object({
+            name: z.string().optional().describe("Lobbyist name (partial match): 'Smith', 'Johnson'"),
+            firm: z.string().optional().describe("Lobbying firm name: 'Akin Gump', 'K Street'"),
+            page_size: z.number().int().max(50).optional().describe("Results per page (default 20)"),
+        }),
+        execute: async ({ name, firm, page_size }) => {
+            const data = await searchLobbyists({ lobbyist_name: name, registrant_name: firm, page_size });
+            if (!data.results?.length)
+                return `No lobbyists found.`;
+            return JSON.stringify({
+                summary: `Lobbyists: ${data.count} found`,
+                results: data.results.map((r) => ({
+                    name: `${r.prefix ?? ""} ${r.first_name ?? ""} ${r.last_name ?? ""}${r.suffix ? " " + r.suffix : ""}`.trim(),
+                    firm: r.registrant?.name,
+                })),
+            });
+        },
+    },
+];
+export { clearCache } from "../sdk/senate-lobbying.js";
+//# sourceMappingURL=senate-lobbying.js.map

package/dist/modules/senate-lobbying.js.map

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

package/dist/modules/treasury.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Treasury Fiscal Data MCP module — tools + metadata. Delegates all API calls to sdk/treasury.
+ *
+ * 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 = "treasury";
+export declare const displayName = "U.S. Treasury Fiscal Data";
+export declare const description = "National debt, revenue, spending, interest rates, exchange rates, savings bonds, auctions, trust funds \u2014 53 datasets, 181 endpoints";
+export declare const workflow = "search_datasets \u2192 get_endpoint_fields \u2192 query_fiscal_data";
+export declare const tips = "No API key required. Use search_datasets to find endpoints by keyword. Use get_endpoint_fields to discover field names before querying. Sort by -record_date for latest data. Use page_size=1 for most recent record. Filter syntax: field:operator:value.";
+export declare const reference: {
+    popularEndpoints: Record<string, string>;
+    filterOperators: Record<string, string>;
+    docs: {
+        "API Documentation": string;
+        "Endpoint List": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export declare const prompts: InputPrompt<any, any>[];
+export { clearCache } from "../sdk/treasury.js";
+//# sourceMappingURL=treasury.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"treasury.d.ts","sourceRoot":"","sources":["../../src/modules/treasury.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAWjD,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,eAAO,MAAM,WAAW,8BAA8B,CAAC;AACvD,eAAO,MAAM,WAAW,6IAAwI,CAAC;AACjK,eAAO,MAAM,QAAQ,wEAA8D,CAAC;AACpF,eAAO,MAAM,IAAI,+PAA+P,CAAC;AAEjR,eAAO,MAAM,SAAS;sBAUf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;qBAQtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;CAK5B,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAiJjC,CAAC;AAIF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EA4E1C,CAAC;AAIF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/modules/treasury.js

@@ -0,0 +1,234 @@
+/**
+ * Treasury Fiscal Data MCP module — tools + metadata. Delegates all API calls to sdk/treasury.
+ *
+ * Tools return raw JSON data — no markdown formatting. The client decides how to present it.
+ */
+import { z } from "zod";
+import { listDatasets, searchEndpoints, getEndpointFields, queryFiscalData, ENDPOINTS, } from "../sdk/treasury.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "treasury";
+export const displayName = "U.S. Treasury Fiscal Data";
+export const description = "National debt, revenue, spending, interest rates, exchange rates, savings bonds, auctions, trust funds — 53 datasets, 181 endpoints";
+export const workflow = "search_datasets → get_endpoint_fields → query_fiscal_data";
+export const tips = "No API key required. Use search_datasets to find endpoints by keyword. Use get_endpoint_fields to discover field names before querying. Sort by -record_date for latest data. Use page_size=1 for most recent record. Filter syntax: field:operator:value.";
+export const reference = {
+    popularEndpoints: {
+        "/v2/accounting/od/debt_to_penny": "Total public debt outstanding (daily)",
+        "/v2/accounting/od/avg_interest_rates": "Average interest rates on Treasury securities",
+        "/v1/accounting/od/rates_of_exchange": "Treasury reporting exchange rates",
+        "/v2/accounting/od/gold_reserve": "U.S. Treasury-owned gold reserves",
+        "/v1/accounting/mts/mts_table_1": "Monthly Treasury Statement: receipts, outlays, deficit",
+        "/v1/accounting/od/auctions_query": "Treasury securities auction data",
+        "/v2/accounting/od/debt_outstanding": "Historical debt outstanding (since 1790)",
+        "/v2/accounting/od/interest_expense": "Interest expense on public debt",
+    },
+    filterOperators: {
+        eq: "equal",
+        gt: "greater than",
+        gte: "greater than or equal",
+        lt: "less than",
+        lte: "less than or equal",
+        in: "in list (comma-separated in parens)",
+    },
+    docs: {
+        "API Documentation": "https://fiscaldata.treasury.gov/api-documentation/",
+        "Endpoint List": "https://fiscaldata.treasury.gov/api-documentation/#list-of-endpoints",
+    },
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "list_datasets",
+        description: "List all 53 U.S. Treasury Fiscal Data API datasets and their 181 endpoints. " +
+            "Returns dataset name, data table name, API endpoint path, and description.",
+        annotations: { title: "Treasury: List Datasets", readOnlyHint: true },
+        parameters: z.object({}),
+        execute: async () => {
+            const grouped = listDatasets();
+            const datasets = Object.entries(grouped).map(([name, tables]) => ({
+                dataset: name,
+                datasetUrl: `https://fiscaldata.treasury.gov/datasets${tables[0].slug}`,
+                tables: tables.map(t => ({
+                    dataTable: t.dataTable,
+                    endpoint: t.endpoint,
+                    description: t.description,
+                })),
+            }));
+            return JSON.stringify({
+                summary: `U.S. Treasury Fiscal Data: ${Object.keys(grouped).length} datasets, ${ENDPOINTS.length} total endpoints`,
+                baseUrl: "https://api.fiscaldata.treasury.gov/services/api/fiscal_service",
+                datasets,
+            });
+        },
+    },
+    {
+        name: "search_datasets",
+        description: "Search for Treasury Fiscal Data datasets and endpoints by keyword. " +
+            "Searches across all 53 datasets (181 endpoints) by name, table name, endpoint path, and description.",
+        annotations: { title: "Treasury: Search Datasets", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().describe("The keyword or phrase to search for (case-insensitive). Examples: 'debt', 'exchange rate', 'gold', 'auction'"),
+        }),
+        execute: async ({ query }) => {
+            const matches = searchEndpoints(query);
+            if (!matches.length) {
+                return JSON.stringify({ summary: `No datasets found matching "${query}". Try a broader search term.`, matches: [] });
+            }
+            const results = matches.map(ep => ({
+                dataset: ep.dataset,
+                dataTable: ep.dataTable,
+                endpoint: ep.endpoint,
+                description: ep.description,
+                datasetUrl: `https://fiscaldata.treasury.gov/datasets${ep.slug}`,
+            }));
+            return JSON.stringify({
+                summary: `Found ${matches.length} endpoint(s) matching "${query}"`,
+                matches: results,
+            });
+        },
+    },
+    {
+        name: "get_endpoint_fields",
+        description: "Get field names, data types, and formats for a specific Treasury Fiscal Data API endpoint. " +
+            "This helps you discover what fields are available before querying data.",
+        annotations: { title: "Treasury: Get Endpoint Fields", readOnlyHint: true },
+        parameters: z.object({
+            endpoint: z.string().describe("The API endpoint path, e.g. '/v2/accounting/od/debt_to_penny' or '/v1/accounting/dts/operating_cash_balance'"),
+        }),
+        execute: async ({ endpoint }) => {
+            const res = await getEndpointFields(endpoint);
+            const fields = Object.keys(res.meta.labels);
+            const fieldDetails = fields.map(f => ({
+                name: f,
+                label: res.meta.labels[f],
+                type: res.meta.dataTypes[f] || "unknown",
+                format: res.meta.dataFormats?.[f] || "unknown",
+            }));
+            return JSON.stringify({
+                summary: `Endpoint ${endpoint}: ${fields.length} fields, ${res.meta["total-count"]} total records`,
+                endpoint,
+                totalRecords: res.meta["total-count"],
+                fields: fieldDetails,
+            });
+        },
+    },
+    {
+        name: "query_fiscal_data",
+        description: "Query the U.S. Treasury Fiscal Data API. Supports field selection, filtering, sorting, and pagination.\n\n" +
+            "Filter operators: eq (equal), gt, gte, lt, lte, in.\n" +
+            "Example filter: 'record_date:gte:2024-01-01'\n" +
+            "Example sort: '-record_date' (descending)\n" +
+            "Multiple filters: 'country_currency_desc:in:(Canada-Dollar,Mexico-Peso),record_date:gte:2024-01-01'",
+        annotations: { title: "Treasury: Query Fiscal Data", readOnlyHint: true },
+        parameters: z.object({
+            endpoint: z.string().describe("The API endpoint path, e.g. '/v2/accounting/od/debt_to_penny'"),
+            fields: z.string().optional().describe("Comma-separated list of field names to return. If omitted, all fields are returned. Example: 'record_date,tot_pub_debt_out_amt'"),
+            filter: z.string().optional().describe("Filter expression. Format: field:operator:value. Multiple: field1:op1:val1,field2:op2:val2. " +
+                "Example: 'record_date:gte:2024-01-01,security_type_desc:eq:Treasury Bills'"),
+            sort: z.string().optional().describe("Comma-separated list of fields to sort by. Prefix with '-' for descending. Example: '-record_date'"),
+            page_number: z.number().int().positive().optional().describe("Page number (1-indexed). Default: 1"),
+            page_size: z.number().int().positive().max(10000).optional().describe("Number of records per page (1-10000). Default: 100"),
+        }),
+        execute: async ({ endpoint, fields, filter, sort, page_number, page_size }) => {
+            const res = await queryFiscalData(endpoint, {
+                fields,
+                filter,
+                sort,
+                pageNumber: page_number,
+                pageSize: page_size,
+            });
+            const maxRows = 50;
+            const rows = res.data.slice(0, maxRows);
+            const truncated = res.data.length > maxRows;
+            const fieldInfo = Object.entries(res.meta.labels).map(([k, v]) => ({
+                name: k,
+                label: v,
+                type: res.meta.dataTypes[k] || "unknown",
+            }));
+            return JSON.stringify({
+                summary: `Query ${endpoint}: ${res.meta.count} returned, ${res.meta["total-count"]} total, page ${page_number || 1} of ${res.meta["total-pages"]}${truncated ? ` (showing first ${maxRows})` : ""}`,
+                endpoint,
+                recordsReturned: res.meta.count,
+                totalRecords: res.meta["total-count"],
+                totalPages: res.meta["total-pages"],
+                truncated,
+                fields: fieldInfo,
+                rows,
+            });
+        },
+    },
+];
+// ─── Prompts ─────────────────────────────────────────────────────────
+export const prompts = [
+    {
+        name: "fiscal_snapshot",
+        description: "Get a comprehensive snapshot of current U.S. fiscal data including national debt, interest rates, and recent revenue/spending.",
+        load: async () => "Please give me a comprehensive fiscal snapshot of the United States using the Treasury Fiscal Data API. Include:\n\n" +
+            "1. **Current national debt** — query /v2/accounting/od/debt_to_penny with sort=-record_date, page_size=1, fields=record_date,tot_pub_debt_out_amt,debt_held_public_amt,intragov_hold_amt\n" +
+            "2. **Latest average interest rates** — query /v2/accounting/od/avg_interest_rates with sort=-record_date, page_size=10, fields=record_date,security_type_desc,avg_interest_rate_amt\n" +
+            "3. **Latest monthly receipts & outlays** — query /v1/accounting/mts/mts_table_1 with sort=-record_date, page_size=5\n" +
+            "4. **Gold reserves** — query /v2/accounting/od/gold_reserve with sort=-record_date, page_size=5\n\n" +
+            "Format the results in a clear summary with dollar amounts and dates.",
+    },
+    {
+        name: "debt_analysis",
+        description: "Analyze the national debt trend with legislative context and vote breakdowns.",
+        arguments: [
+            { name: "start_date", description: "Start date in YYYY-MM-DD format (default: 1 year ago)", required: false },
+        ],
+        load: async (args) => {
+            const defaultDate = new Date();
+            defaultDate.setFullYear(defaultDate.getFullYear() - 1);
+            const startStr = args.start_date || defaultDate.toISOString().split("T")[0];
+            return (`Analyze the U.S. national debt trend since ${startStr}.\n\n` +
+                `== DEBT DATA ==\n` +
+                `1. Query /v2/accounting/od/debt_to_penny with filter=record_date:gte:${startStr}, sort=-record_date, page_size=50, fields=record_date,tot_pub_debt_out_amt,debt_held_public_amt,intragov_hold_amt\n` +
+                `2. Calculate the change from the earliest to latest record\n` +
+                `3. Show the trend — is debt increasing or decreasing?\n` +
+                `4. Break down by debt held by public vs intragovernmental holdings\n\n` +
+                `== LEGISLATIVE CONTEXT ==\n` +
+                `5. Use congress_search_bills for 'debt ceiling' or 'appropriations' to find relevant legislation\n` +
+                `6. Use congress_house_votes and congress_senate_votes to show how each party voted on debt-related bills\n` +
+                `7. Use FRED GDP series to calculate debt-to-GDP ratio for context\n\n` +
+                `Present the analysis with clear numbers, percentage changes, and note which congress/president was in office.`);
+        },
+    },
+    {
+        name: "exchange_rates",
+        description: "Look up Treasury exchange rates for a specific currency.",
+        arguments: [
+            { name: "currency", description: "Currency to look up, e.g. 'Euro Zone-Euro', 'Canada-Dollar', 'Japan-Yen'", required: true },
+        ],
+        load: async (args) => `Get the Treasury reporting exchange rates for "${args.currency}".\n\n` +
+            `Query /v1/accounting/od/rates_of_exchange with:\n` +
+            `- fields: record_date,country_currency_desc,exchange_rate\n` +
+            `- filter: country_currency_desc:eq:${args.currency}\n` +
+            `- sort: -record_date\n- page_size: 20\n\nShow the exchange rate history and note any trends.`,
+    },
+    {
+        name: "auction_results",
+        description: "Get recent Treasury securities auction results.",
+        arguments: [
+            { name: "security_type", description: "Type of security: 'Bill', 'Note', 'Bond', 'TIPS', 'FRN'", required: false },
+        ],
+        load: async (args) => {
+            const filterPart = args.security_type ? `\n- filter: security_type_desc:eq:${args.security_type}` : "";
+            return (`Get the latest Treasury securities auction results.\n\n` +
+                `Query /v1/accounting/od/auctions_query with:\n- sort: -auction_date\n- page_size: 15${filterPart}\n\n` +
+                `Summarize the results showing auction dates, security types, amounts, and interest rates.`);
+        },
+    },
+    {
+        name: "interest_rate_comparison",
+        description: "Compare current interest rates across all Treasury security types.",
+        load: async () => "Compare current average interest rates across all Treasury security types.\n\n" +
+            "1. First use get_endpoint_fields on /v2/accounting/od/avg_interest_rates to see available fields\n" +
+            "2. Query /v2/accounting/od/avg_interest_rates with sort=-record_date, page_size=50, fields=record_date,security_type_desc,security_desc,avg_interest_rate_amt\n" +
+            "3. Group the latest rates by security type\n" +
+            "4. Show which security types have the highest and lowest rates\n\n" +
+            "Present as a comparison table.",
+    },
+];
+// ─── Re-export cache control from SDK ────────────────────────────────
+export { clearCache } from "../sdk/treasury.js";
+//# sourceMappingURL=treasury.js.map

package/dist/modules/treasury.js.map

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

package/dist/modules/usaspending.d.ts

@@ -0,0 +1,19 @@
+/**
+ * USAspending MCP module — tools + metadata. Delegates all API calls to sdk/usaspending.
+ *
+ * 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 = "usaspending";
+export declare const displayName = "USAspending";
+export declare const description = "Federal contracts, grants, loans, direct payments \u2014 who got the money and where";
+export declare const workflow = "search awards by keyword/agency/state \u2192 drill into recipients or trends";
+export declare const tips = "No API key required. Data updates nightly. Earliest data: FY2008 (2007-10-01).";
+export declare const reference: {
+    awardTypes: Record<string, string[]>;
+    agencyCodes: Record<string, string>;
+};
+export declare const tools: Tool<any, any>[];
+export { clearCache } from "../sdk/usaspending.js";
+export declare const prompts: InputPrompt<any, any>[];
+//# sourceMappingURL=usaspending.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usaspending.d.ts","sourceRoot":"","sources":["../../src/modules/usaspending.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAejD,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAClC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,WAAW,yFAAoF,CAAC;AAC7G,eAAO,MAAM,QAAQ,iFAA4E,CAAC;AAClG,eAAO,MAAM,IAAI,mFAAmF,CAAC;AAErG,eAAO,MAAM,SAAS;;;CAGrB,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EA4KjC,CAAC;AAIF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAoB1C,CAAC"}