us-gov-open-data-mcp 1.0.0

package/dist/sdk/fdic.d.ts

@@ -0,0 +1,227 @@
+/**
+ * FDIC SDK — typed API client for the Federal Deposit Insurance Corporation
+ * BankFind Suite API.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchInstitutions, getBankFailures, getFinancials } from "us-gov-open-data/sdk/fdic";
+ *
+ *   const banks = await searchInstitutions({ filters: "STNAME:\"California\"", limit: 10 });
+ *   const failures = await getBankFailures({ limit: 25 });
+ *
+ * No API key required.
+ * Docs: https://banks.data.fdic.gov/docs/
+ */
+export interface FdicApiResponse<T = Record<string, unknown>> {
+    meta: {
+        total: number;
+        parameters: Record<string, unknown>;
+        index?: string;
+        [key: string]: unknown;
+    };
+    data: Array<{
+        data: T;
+        score?: number;
+    }>;
+    totals?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface Institution {
+    CERT?: number;
+    REPDTE?: string;
+    INSTNAME?: string;
+    CITY?: string;
+    STNAME?: string;
+    STALP?: string;
+    ZIP?: string;
+    WEBADDR?: string;
+    INSTCAT?: number;
+    SPECGRP?: number;
+    ASSET?: number;
+    DEP?: number;
+    DEPDOM?: number;
+    NETINC?: number;
+    ROA?: number;
+    ROE?: number;
+    RISESSION?: number;
+    CHARTER_CLASS?: string;
+    FED_RSSD?: number;
+    ACTIVE?: number;
+    REGAGENT?: string;
+    FDICREGION?: string;
+    HCTMULT?: string;
+    OFFDOM?: number;
+    [key: string]: unknown;
+}
+export interface BankFailure {
+    CERT?: number;
+    INSTNAME?: string;
+    CITY?: string;
+    ST?: string;
+    FAILDATE?: string;
+    SAVR?: string;
+    COST?: number;
+    RESTYPE?: string;
+    RESTYPE1?: string;
+    QBFASSET?: number;
+    QBFDEP?: number;
+    PSTALP?: string;
+    [key: string]: unknown;
+}
+export interface FinancialRecord {
+    CERT?: number;
+    REPDTE?: string;
+    INSTNAME?: string;
+    ASSET?: number;
+    DEP?: number;
+    DEPDOM?: number;
+    NETINC?: number;
+    INTINC?: number;
+    EINTEXP?: number;
+    ELNATR?: number;
+    NITEFDS?: number;
+    NONII?: number;
+    ROA?: number;
+    ROE?: number;
+    LNLSGR?: number;
+    LNLSNET?: number;
+    [key: string]: unknown;
+}
+export interface SodRecord {
+    CERT?: number;
+    REPDTE?: string;
+    INSTNAME?: string;
+    BRNUM?: number;
+    BRSERTYP?: number;
+    STNAME?: string;
+    STALP?: string;
+    CITY?: string;
+    COUNTY?: string;
+    ZIPBR?: string;
+    DEPSUMBR?: number;
+    BKMO?: number;
+    [key: string]: unknown;
+}
+export interface HistoryEvent {
+    CERT?: number;
+    INSTNAME?: string;
+    PCITY?: string;
+    PSTALP?: string;
+    EFFDATE?: string;
+    ACESSION?: string;
+    ACT_NAME?: string;
+    CHARTEFDS?: string;
+    [key: string]: unknown;
+}
+export interface DemographicRecord {
+    CERT?: number;
+    REPDTE?: string;
+    INSTNAME?: string;
+    STALP?: string;
+    STNAME?: string;
+    MSA_NO?: string;
+    TRACT?: string;
+    INCOME_LVL?: string;
+    [key: string]: unknown;
+}
+/** Available FDIC API datasets/endpoints. */
+export declare const DATASETS: Record<string, string>;
+/** Common filter field names for the institutions endpoint. */
+export declare const INSTITUTION_FIELDS: Record<string, string>;
+/** Filter syntax examples. */
+export declare const FILTER_EXAMPLES: Record<string, string>;
+/**
+ * Search FDIC-insured institutions (banks, savings & loans).
+ *
+ * Example:
+ *   const banks = await searchInstitutions({ filters: 'STALP:"CA" AND ACTIVE:1', limit: 25 });
+ *   const large = await searchInstitutions({ filters: 'ASSET:[1000000 TO *]', sort_by: 'ASSET', sort_order: 'DESC' });
+ */
+export declare function searchInstitutions(opts?: {
+    filters?: string;
+    fields?: string;
+    search?: string;
+    sort_by?: string;
+    sort_order?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<FdicApiResponse<Institution>>;
+/**
+ * Get FDIC-insured bank failures since 1934.
+ *
+ * Example:
+ *   const recent = await getBankFailures({ limit: 20, sort_by: "FAILDATE", sort_order: "DESC" });
+ *   const byState = await getBankFailures({ filters: 'PSTALP:"GA"' });
+ */
+export declare function getBankFailures(opts?: {
+    filters?: string;
+    fields?: string;
+    sort_by?: string;
+    sort_order?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<FdicApiResponse<BankFailure>>;
+/**
+ * Get quarterly financial reports (Call Report data) for banks.
+ *
+ * Example:
+ *   const financials = await getFinancials({ filters: 'CERT:3511', limit: 10 });
+ *   const stateFinancials = await getFinancials({ filters: 'STALP:"CA" AND REPDTE:20240331', limit: 50 });
+ */
+export declare function getFinancials(opts?: {
+    filters?: string;
+    fields?: string;
+    sort_by?: string;
+    sort_order?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<FdicApiResponse<FinancialRecord>>;
+/**
+ * Get aggregate banking statistics (industry totals by state, charter type, etc.).
+ *
+ * Example:
+ *   const summary = await getSummary({ filters: 'STALP:"TX"', limit: 10 });
+ */
+export declare function getSummary(opts?: {
+    filters?: string;
+    fields?: string;
+    sort_by?: string;
+    sort_order?: string;
+    limit?: number;
+    offset?: number;
+    agg_by?: string;
+    agg_term_fields?: string;
+    agg_sum_fields?: string;
+    agg_limit?: number;
+}): Promise<FdicApiResponse>;
+/**
+ * Get Summary of Deposits — branch-level deposit data (annual, as of June 30).
+ *
+ * Example:
+ *   const deposits = await getDeposits({ filters: 'STALP:"NY"', sort_by: 'DEPSUMBR', sort_order: 'DESC', limit: 20 });
+ */
+export declare function getDeposits(opts?: {
+    filters?: string;
+    fields?: string;
+    sort_by?: string;
+    sort_order?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<FdicApiResponse<SodRecord>>;
+/**
+ * Get institution event history (mergers, name changes, charter changes).
+ *
+ * Example:
+ *   const history = await getHistory({ filters: 'CERT:3511', limit: 50 });
+ */
+export declare function getHistory(opts?: {
+    filters?: string;
+    fields?: string;
+    sort_by?: string;
+    sort_order?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<FdicApiResponse<HistoryEvent>>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=fdic.d.ts.map

package/dist/sdk/fdic.d.ts.map

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

package/dist/sdk/fdic.js

@@ -0,0 +1,172 @@
+/**
+ * FDIC SDK — typed API client for the Federal Deposit Insurance Corporation
+ * BankFind Suite API.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchInstitutions, getBankFailures, getFinancials } from "us-gov-open-data/sdk/fdic";
+ *
+ *   const banks = await searchInstitutions({ filters: "STNAME:\"California\"", limit: 10 });
+ *   const failures = await getBankFailures({ limit: 25 });
+ *
+ * No API key required.
+ * Docs: https://banks.data.fdic.gov/docs/
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const client = createClient({
+    baseUrl: "https://banks.data.fdic.gov/api",
+    name: "fdic",
+    rateLimit: { perSecond: 5, burst: 10 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour
+});
+// ─── Reference Data ──────────────────────────────────────────────────
+/** Available FDIC API datasets/endpoints. */
+export const DATASETS = {
+    institutions: "Currently open and insured depository institutions — filterable by state, assets, charter type",
+    failures: "All FDIC-insured bank failures since 1934",
+    financials: "Call report financial data (assets, deposits, income, ratios) by quarter",
+    summary: "Aggregate banking statistics by state or charter type across time",
+    sod: "Summary of Deposits — branch-level deposit data, annual (June 30)",
+    history: "Institution event history — mergers, name changes, charter changes",
+    locations: "Physical branch and office locations",
+    demographics: "Community Reinvestment Act assessment area demographics",
+};
+/** Common filter field names for the institutions endpoint. */
+export const INSTITUTION_FIELDS = {
+    STALP: "State abbreviation (CA, TX, NY)",
+    STNAME: "State full name",
+    INSTNAME: "Institution name",
+    ACTIVE: "Active status (1=active)",
+    INSTCAT: "Institution category (1=commercial bank, 2=savings, 5=state charter, 9=national bank)",
+    ASSET: "Total assets (in thousands)",
+    DEP: "Total deposits (in thousands)",
+    NETINC: "Net income (in thousands)",
+    CHARTER_CLASS: "Charter class (N=national, SM=state member, NM=state non-member, SB=savings bank, SL=savings & loan)",
+    CITY: "City name",
+    ZIP: "ZIP code",
+};
+/** Filter syntax examples. */
+export const FILTER_EXAMPLES = {
+    "State filter": 'STALP:"CA"',
+    "Active only": "ACTIVE:1",
+    "Large banks": "ASSET:[1000000 TO *]",
+    "Multiple": 'STALP:"TX" AND ACTIVE:1',
+    "Name search": 'INSTNAME:"Wells Fargo"',
+    "Charter type": 'CHARTER_CLASS:"N"',
+    "Asset range": "ASSET:[100000 TO 500000]",
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+async function queryEndpoint(endpoint, opts = {}) {
+    const params = {};
+    if (opts.filters)
+        params.filters = opts.filters;
+    if (opts.fields)
+        params.fields = opts.fields;
+    if (opts.sort_by)
+        params.sort_by = opts.sort_by;
+    if (opts.sort_order)
+        params.sort_order = opts.sort_order;
+    if (opts.limit !== undefined)
+        params.limit = opts.limit;
+    if (opts.offset !== undefined)
+        params.offset = opts.offset;
+    if (opts.search)
+        params.search = opts.search;
+    if (opts.agg_by)
+        params.agg_by = opts.agg_by;
+    if (opts.agg_term_fields)
+        params.agg_term_fields = opts.agg_term_fields;
+    if (opts.agg_sum_fields)
+        params.agg_sum_fields = opts.agg_sum_fields;
+    if (opts.agg_limit !== undefined)
+        params.agg_limit = opts.agg_limit;
+    return client.get(`/${endpoint}`, params);
+}
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Search FDIC-insured institutions (banks, savings & loans).
+ *
+ * Example:
+ *   const banks = await searchInstitutions({ filters: 'STALP:"CA" AND ACTIVE:1', limit: 25 });
+ *   const large = await searchInstitutions({ filters: 'ASSET:[1000000 TO *]', sort_by: 'ASSET', sort_order: 'DESC' });
+ */
+export async function searchInstitutions(opts = {}) {
+    return queryEndpoint("institutions", {
+        ...opts,
+        limit: opts.limit ?? 25,
+        sort_order: opts.sort_order ?? "DESC",
+    });
+}
+/**
+ * Get FDIC-insured bank failures since 1934.
+ *
+ * Example:
+ *   const recent = await getBankFailures({ limit: 20, sort_by: "FAILDATE", sort_order: "DESC" });
+ *   const byState = await getBankFailures({ filters: 'PSTALP:"GA"' });
+ */
+export async function getBankFailures(opts = {}) {
+    return queryEndpoint("failures", {
+        ...opts,
+        limit: opts.limit ?? 25,
+        sort_by: opts.sort_by ?? "FAILDATE",
+        sort_order: opts.sort_order ?? "DESC",
+    });
+}
+/**
+ * Get quarterly financial reports (Call Report data) for banks.
+ *
+ * Example:
+ *   const financials = await getFinancials({ filters: 'CERT:3511', limit: 10 });
+ *   const stateFinancials = await getFinancials({ filters: 'STALP:"CA" AND REPDTE:20240331', limit: 50 });
+ */
+export async function getFinancials(opts = {}) {
+    return queryEndpoint("financials", {
+        ...opts,
+        limit: opts.limit ?? 25,
+        sort_by: opts.sort_by ?? "REPDTE",
+        sort_order: opts.sort_order ?? "DESC",
+    });
+}
+/**
+ * Get aggregate banking statistics (industry totals by state, charter type, etc.).
+ *
+ * Example:
+ *   const summary = await getSummary({ filters: 'STALP:"TX"', limit: 10 });
+ */
+export async function getSummary(opts = {}) {
+    return queryEndpoint("summary", {
+        ...opts,
+        limit: opts.limit ?? 25,
+    });
+}
+/**
+ * Get Summary of Deposits — branch-level deposit data (annual, as of June 30).
+ *
+ * Example:
+ *   const deposits = await getDeposits({ filters: 'STALP:"NY"', sort_by: 'DEPSUMBR', sort_order: 'DESC', limit: 20 });
+ */
+export async function getDeposits(opts = {}) {
+    return queryEndpoint("sod", {
+        ...opts,
+        limit: opts.limit ?? 25,
+        sort_order: opts.sort_order ?? "DESC",
+    });
+}
+/**
+ * Get institution event history (mergers, name changes, charter changes).
+ *
+ * Example:
+ *   const history = await getHistory({ filters: 'CERT:3511', limit: 50 });
+ */
+export async function getHistory(opts = {}) {
+    return queryEndpoint("history", {
+        ...opts,
+        limit: opts.limit ?? 25,
+    });
+}
+/** Clear cached responses. */
+export function clearCache() {
+    client.clearCache();
+}
+//# sourceMappingURL=fdic.js.map

package/dist/sdk/fdic.js.map

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

package/dist/sdk/fec.d.ts

@@ -0,0 +1,142 @@
+/**
+ * FEC SDK — typed API client for OpenFEC (Federal Election Commission).
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchCandidates, getCandidateFinancials } from "us-gov-open-data/sdk/fec";
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ * Docs: https://api.open.fec.gov/developers/
+ */
+export interface FecPagination {
+    page: number;
+    per_page: number;
+    count: number;
+    pages: number;
+}
+export interface FecCandidate {
+    candidate_id: string;
+    name: string;
+    party: string;
+    party_full?: string;
+    office: string;
+    office_full?: string;
+    state?: string;
+    district?: string;
+    election_years?: number[];
+    candidate_status?: string;
+    incumbent_challenge?: string;
+    incumbent_challenge_full?: string;
+    has_raised_funds?: boolean;
+    [key: string]: unknown;
+}
+export interface FecCommittee {
+    committee_id: string;
+    name: string;
+    committee_type: string;
+    committee_type_full?: string;
+    party?: string;
+    party_full?: string;
+    state?: string;
+    designation?: string;
+    designation_full?: string;
+    filing_frequency?: string;
+    [key: string]: unknown;
+}
+export interface FecFinancialTotals {
+    cycle: number;
+    receipts: number;
+    disbursements: number;
+    cash_on_hand_end_period?: number;
+    last_cash_on_hand_end_period?: number;
+    debts_owed_by_committee?: number;
+    last_debts_owed_by_committee?: number;
+    individual_contributions?: number;
+    other_political_committee_contributions?: number;
+    political_party_committee_contributions?: number;
+    independent_expenditures?: number;
+    coverage_start_date?: string;
+    coverage_end_date?: string;
+    committee_type?: string;
+    committee_type_full?: string;
+    [key: string]: unknown;
+}
+export interface FecCandidateTotals {
+    name: string;
+    candidate_id?: string;
+    party?: string;
+    party_full?: string;
+    state?: string;
+    receipts: number;
+    disbursements: number;
+    cash_on_hand_end_period?: number;
+    [key: string]: unknown;
+}
+export interface FecSearchResult<T> {
+    pagination: FecPagination;
+    results: T[];
+}
+export interface FecDisbursement {
+    committee_id: string;
+    committee: {
+        name: string;
+        committee_id: string;
+        party?: string;
+    } | null;
+    recipient_name: string;
+    recipient_committee_id: string | null;
+    recipient_committee: {
+        name: string;
+        committee_id: string;
+        party?: string;
+        committee_type_full?: string;
+    } | null;
+    disbursement_amount: number;
+    disbursement_date: string;
+    disbursement_description: string;
+    recipient_state: string | null;
+    line_number_label: string | null;
+    memo_text: string | null;
+    [key: string]: unknown;
+}
+/** Search for federal election candidates by name, state, party, office, or election year. */
+export declare function searchCandidates(opts?: {
+    name?: string;
+    state?: string;
+    party?: string;
+    office?: string;
+    election_year?: number;
+    page?: number;
+    per_page?: number;
+}): Promise<FecSearchResult<FecCandidate>>;
+/** Search for political committees (PACs, campaign committees, party committees). */
+export declare function searchCommittees(opts?: {
+    name?: string;
+    state?: string;
+    committee_type?: string;
+    cycle?: number;
+    page?: number;
+    per_page?: number;
+}): Promise<FecSearchResult<FecCommittee>>;
+/** Get financial summary for a candidate. */
+export declare function getCandidateFinancials(candidateId: string, cycle?: number): Promise<FecFinancialTotals[]>;
+/** Get financial totals for a committee (PAC, campaign, party). */
+export declare function getCommitteeFinancials(committeeId: string, cycle?: number): Promise<FecFinancialTotals[]>;
+/** Get top candidates ranked by total money raised for a given office and cycle. */
+export declare function getTopCandidates(opts: {
+    office: string;
+    election_year: number;
+    state?: string;
+    per_page?: number;
+}): Promise<FecSearchResult<FecCandidateTotals>>;
+/** Get itemized disbursements (Schedule B) for a committee — shows exactly who received money. */
+export declare function getCommitteeDisbursements(opts: {
+    committee_id: string;
+    cycle?: number;
+    recipient_name?: string;
+    per_page?: number;
+    sort?: string;
+}): Promise<FecSearchResult<FecDisbursement>>;
+/** Clear cached responses. */
+export declare function clearCache(): void;
+//# sourceMappingURL=fec.d.ts.map

package/dist/sdk/fec.d.ts.map

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

package/dist/sdk/fec.js

@@ -0,0 +1,92 @@
+/**
+ * FEC SDK — typed API client for OpenFEC (Federal Election Commission).
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchCandidates, getCandidateFinancials } from "us-gov-open-data/sdk/fec";
+ *
+ * Requires DATA_GOV_API_KEY env var. Get one at https://api.data.gov/signup/
+ * Docs: https://api.open.fec.gov/developers/
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.open.fec.gov/v1",
+    name: "fec",
+    auth: { type: "query", key: "api_key", envVar: "DATA_GOV_API_KEY" },
+    rateLimit: { perSecond: 3, burst: 10 }, // 1000 req/hour ≈ ~0.28/s, burst for interactive use
+    cacheTtlMs: 30 * 60 * 1000, // 30 min
+});
+// ─── Public API ──────────────────────────────────────────────────────
+/** Search for federal election candidates by name, state, party, office, or election year. */
+export async function searchCandidates(opts = {}) {
+    return api.get("/candidates/search/", {
+        q: opts.name,
+        state: opts.state,
+        party: opts.party,
+        office: opts.office,
+        election_year: opts.election_year,
+        page: opts.page ?? 1,
+        per_page: opts.per_page ?? 20,
+        sort: "-first_file_date",
+    });
+}
+/** Search for political committees (PACs, campaign committees, party committees). */
+export async function searchCommittees(opts = {}) {
+    return api.get("/committees/", {
+        q: opts.name,
+        state: opts.state,
+        committee_type: opts.committee_type,
+        cycle: opts.cycle,
+        page: opts.page ?? 1,
+        per_page: opts.per_page ?? 20,
+    });
+}
+/** Get financial summary for a candidate. */
+export async function getCandidateFinancials(candidateId, cycle) {
+    const params = {};
+    if (cycle)
+        params.cycle = cycle;
+    const res = await api.get(`/candidate/${candidateId}/totals/`, params);
+    return res.results ?? [];
+}
+/** Get financial totals for a committee (PAC, campaign, party). */
+export async function getCommitteeFinancials(committeeId, cycle) {
+    const params = {};
+    if (cycle)
+        params.cycle = cycle;
+    const res = await api.get(`/committee/${committeeId}/totals/`, params);
+    return res.results ?? [];
+}
+/** Get top candidates ranked by total money raised for a given office and cycle. */
+export async function getTopCandidates(opts) {
+    return api.get("/candidates/totals/", {
+        office: opts.office,
+        election_year: opts.election_year,
+        state: opts.state,
+        sort: "-receipts",
+        sort_null_only: "false",
+        per_page: opts.per_page ?? 20,
+        page: 1,
+        is_active_candidate: "true",
+    });
+}
+/** Get itemized disbursements (Schedule B) for a committee — shows exactly who received money. */
+export async function getCommitteeDisbursements(opts) {
+    const params = {
+        committee_id: opts.committee_id,
+        per_page: opts.per_page ?? 20,
+        sort: opts.sort ?? "-disbursement_date",
+        sort_null_only: "false",
+    };
+    if (opts.cycle)
+        params.two_year_transaction_period = opts.cycle;
+    if (opts.recipient_name)
+        params.recipient_name = opts.recipient_name;
+    return api.get("/schedules/schedule_b/", params);
+}
+/** Clear cached responses. */
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=fec.js.map

package/dist/sdk/fec.js.map

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