usaspending-mcp 0.1.0

package/README.md

@@ -0,0 +1,164 @@
+# usaspending-mcp
+
+MCP server for the [USASpending.gov API](https://api.usaspending.gov/) — 25 tools for querying federal spending data, tracking government contracts, and researching award recipients.
+
+No API key required. Works with Claude Code, Claude Desktop, Claude.ai, and any MCP-compatible client.
+
+## Quick Start
+
+### Claude Code (npx)
+
+```json
+{
+  "mcpServers": {
+    "usaspending": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "usaspending-mcp"]
+    }
+  }
+}
+```
+
+### Claude Code (local)
+
+```json
+{
+  "mcpServers": {
+    "usaspending": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/path/to/usaspending-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+### Remote (Streamable HTTP)
+
+Run on a server:
+
+```bash
+npx usaspending-mcp --transport http --port 3001
+```
+
+Connect from Claude Desktop or Claude.ai via your reverse proxy URL.
+
+## Tools
+
+### Search & Discovery (8 tools)
+
+| Tool | Description |
+|------|-------------|
+| `search_awards` | Search federal awards with filters (agency, NAICS, PSC, keywords, date range, award type). Supports pagination. |
+| `search_awards_count` | Get result counts by award type before running a full search. |
+| `search_subawards` | Search subaward/subcontract records across all prime awards. |
+| `search_by_category` | Aggregate spending by dimension (NAICS, PSC, recipient, agency, geography, etc.). |
+| `search_new_awards_over_time` | Track new award volume over time by month, quarter, or fiscal year. |
+| `search_spending_over_time` | Track spending amounts over time. |
+| `search_spending_by_geography` | Break down spending by state, county, or congressional district. |
+| `search_by_transaction` | Transaction-level search across all awards. |
+
+### Award & IDV Detail (8 tools)
+
+| Tool | Description |
+|------|-------------|
+| `get_award` | Full details for a specific award (recipient, amounts, dates, NAICS/PSC, agency). |
+| `get_award_funding` | Funding sources — which federal accounts and agencies fund an award. |
+| `get_award_subawards` | Subawards under a prime award. Key for mapping supply chains. |
+| `get_award_transactions` | Transaction/modification history for an award. |
+| `get_idv_amounts` | Funding summary for an IDV (IDIQ, GWAC, BPA, BOA, FSS). |
+| `get_idv_awards` | Task orders under an IDV. Identifies all awardees on a contract vehicle. |
+| `get_idv_activity` | Modification and activity history for an IDV. |
+| `get_idv_funding` | IDV funding breakdown by federal account. |
+
+### Recipient Intelligence (5 tools)
+
+| Tool | Description |
+|------|-------------|
+| `autocomplete_recipient` | Quick recipient name search. First step in finding a company. |
+| `list_recipients` | Search and filter recipients with award totals. |
+| `get_recipient` | Full company profile — DUNS/UEI, parent company, award history by type. |
+| `get_recipient_children` | Child/subsidiary organizations under a parent company. |
+| `get_spending_by_recipient_for_agency` | Recipients ranked by award amount from a specific agency. |
+
+### Reference Data (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_agencies` | All top-tier federal agencies with codes and metadata. |
+| `search_naics` | Search NAICS industry codes by keyword. |
+| `search_psc` | Search Product/Service Classification codes by keyword. |
+| `get_naics_hierarchy` | Browse the NAICS code tree. |
+
+## Filtering
+
+Search tools accept a shared filter object:
+
+```json
+{
+  "keywords": ["cybersecurity"],
+  "award_type_codes": ["D"],
+  "time_period": [{ "start_date": "2025-01-01", "end_date": "2025-12-31" }],
+  "agencies": [{ "type": "awarding", "tier": "toptier", "name": "Department of Defense" }],
+  "naics_codes": ["541512"],
+  "psc_codes": ["D399"],
+  "recipient_search_text": ["Lockheed"],
+  "page": 1,
+  "limit": 20,
+  "sort": "Award Amount",
+  "order": "desc"
+}
+```
+
+All filter fields are optional — compose what you need.
+
+### Award Type Codes
+
+| Code | Type |
+|------|------|
+| `A` | BPA Call |
+| `B` | Purchase Order |
+| `C` | Delivery Order |
+| `D` | Definitive Contract |
+| `IDV_A` | GWAC |
+| `IDV_B_A` | IDC / IDIQ |
+| `IDV_B_B` | IDC / Indefinite |
+| `IDV_B_C` | IDC / Definitive |
+| `IDV_C` | FSS |
+| `IDV_D` | BOA |
+| `IDV_E` | BPA |
+
+## Example Workflows
+
+**Find DOD cybersecurity contracts:**
+1. `search_naics` — find relevant codes (541512, 541519)
+2. `search_awards` — filter by DOD + NAICS codes + award type "D" + date range
+3. `get_award` — deep dive on a specific contract
+4. `get_recipient` — profile the winning company
+
+**Map a contractor's supply chain:**
+1. `autocomplete_recipient` — find the prime by name
+2. `get_recipient` — get their profile
+3. `search_awards` — find their contracts
+4. `get_award_subawards` — find subcontractors on each contract
+
+**Explore an IDIQ/GWAC:**
+1. `search_awards` — filter for IDV award types
+2. `get_idv_awards` — list all task order holders
+3. `get_idv_activity` — see recent activity
+4. `get_recipient` — profile each awardee
+
+## Development
+
+```bash
+git clone https://github.com/boejucci/usa-spending-mcp.git
+cd usa-spending-mcp
+npm install
+npm run build
+npm run dev        # watch mode
+```
+
+## License
+
+MIT

package/dist/api/client.d.ts

@@ -0,0 +1,45 @@
+/**
+ * USASpending API Client
+ *
+ * HTTP layer for all communication with the USASpending.gov API.
+ * Every MCP tool in this server routes through this client.
+ */
+export declare class USASpendingApiError extends Error {
+    readonly statusCode: number;
+    readonly statusText: string;
+    readonly body: string;
+    readonly url: string;
+    constructor(message: string, statusCode: number, statusText: string, body: string, url: string);
+}
+export interface PageMetadata {
+    page: number;
+    hasNext: boolean;
+    total?: number;
+    limit?: number;
+}
+export declare class USASpendingClient {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(baseUrl?: string, timeoutMs?: number);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: Record<string, unknown>): Promise<T>;
+    /**
+     * Injects a human-readable `_summary` field into a paginated API response.
+     *
+     * Only modifies the response if `page_metadata` is present.
+     *
+     * Format:
+     *   "Page X of Y (Z total results). Showing N items. [context] [More pages available.]"
+     */
+    addSummary<T extends Record<string, unknown>>(response: T, context?: string): T & {
+        _summary?: string;
+    };
+    private request;
+    /**
+     * Counts the number of result items in a response by looking for the first
+     * top-level array field (excluding metadata-like keys).
+     */
+    private countItems;
+}
+export declare const client: USASpendingClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,UAAU,EAAE,MAAM;aAClB,UAAU,EAAE,MAAM;aAClB,IAAI,EAAE,MAAM;aACZ,GAAG,EAAE,MAAM;gBAJ3B,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM;CAK9B;AAMD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,GAAE,MAAiB,EAAE,SAAS,GAAE,MAAmB;IAShE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKhC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYtE;;;;;;;OAOG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,MAAM,GACf,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;YA4Cd,OAAO;IA4CrB;;;OAGG;IACH,OAAO,CAAC,UAAU;CASnB;AAMD,eAAO,MAAM,MAAM,mBAA0B,CAAC"}

package/dist/api/client.js

@@ -0,0 +1,145 @@
+/**
+ * USASpending API Client
+ *
+ * HTTP layer for all communication with the USASpending.gov API.
+ * Every MCP tool in this server routes through this client.
+ */
+const BASE_URL = "https://api.usaspending.gov/api/v2";
+const TIMEOUT_MS = 30_000;
+// ---------------------------------------------------------------------------
+// Error class
+// ---------------------------------------------------------------------------
+export class USASpendingApiError extends Error {
+    statusCode;
+    statusText;
+    body;
+    url;
+    constructor(message, statusCode, statusText, body, url) {
+        super(message);
+        this.statusCode = statusCode;
+        this.statusText = statusText;
+        this.body = body;
+        this.url = url;
+        this.name = "USASpendingApiError";
+    }
+}
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+export class USASpendingClient {
+    baseUrl;
+    timeoutMs;
+    constructor(baseUrl = BASE_URL, timeoutMs = TIMEOUT_MS) {
+        this.baseUrl = baseUrl;
+        this.timeoutMs = timeoutMs;
+    }
+    // -------------------------------------------------------------------------
+    // Public HTTP methods
+    // -------------------------------------------------------------------------
+    async get(path) {
+        const url = `${this.baseUrl}${path}`;
+        return this.request(url, { method: "GET" });
+    }
+    async post(path, body) {
+        const url = `${this.baseUrl}${path}`;
+        return this.request(url, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Pagination summary injection
+    // -------------------------------------------------------------------------
+    /**
+     * Injects a human-readable `_summary` field into a paginated API response.
+     *
+     * Only modifies the response if `page_metadata` is present.
+     *
+     * Format:
+     *   "Page X of Y (Z total results). Showing N items. [context] [More pages available.]"
+     */
+    addSummary(response, context) {
+        const metadata = response.page_metadata;
+        if (!metadata) {
+            return response;
+        }
+        const { page, hasNext } = metadata;
+        // Some endpoints put total/limit in page_metadata, others at the top level
+        const total = metadata.total ?? response.total;
+        const limit = metadata.limit ?? response.limit;
+        // Determine how many items are on the current page.
+        const itemCount = this.countItems(response);
+        const parts = [];
+        if (total != null && limit != null) {
+            const totalPages = Math.max(1, Math.ceil(total / limit));
+            parts.push(`Page ${page} of ${totalPages} (${total.toLocaleString()} total results).`);
+        }
+        else {
+            parts.push(`Page ${page}.`);
+        }
+        parts.push(`Showing ${itemCount} items.`);
+        if (context) {
+            parts.push(context);
+        }
+        if (hasNext) {
+            parts.push("More pages available.");
+        }
+        return {
+            ...response,
+            _summary: parts.join(" "),
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    async request(url, init) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                ...init,
+                signal: controller.signal,
+                headers: {
+                    "Content-Type": "application/json",
+                    ...init.headers,
+                },
+            });
+            if (!response.ok) {
+                const body = await response.text();
+                throw new USASpendingApiError(`USASpending API error: ${response.status} ${response.statusText} for ${url}`, response.status, response.statusText, body, url);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof USASpendingApiError) {
+                throw error;
+            }
+            if (error instanceof DOMException ||
+                (error instanceof Error && error.name === "AbortError")) {
+                throw new Error(`USASpending API request timed out after ${this.timeoutMs}ms: ${url}`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Counts the number of result items in a response by looking for the first
+     * top-level array field (excluding metadata-like keys).
+     */
+    countItems(response) {
+        const skipKeys = new Set(["page_metadata", "_summary", "messages"]);
+        for (const [key, value] of Object.entries(response)) {
+            if (!skipKeys.has(key) && Array.isArray(value)) {
+                return value.length;
+            }
+        }
+        return 0;
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton export
+// ---------------------------------------------------------------------------
+export const client = new USASpendingClient();
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import express from "express";
+import { randomUUID } from "node:crypto";
+import { createServer } from "./server.js";
+const args = process.argv.slice(2);
+const transportFlag = args.includes("--transport")
+    ? args[args.indexOf("--transport") + 1]
+    : "stdio";
+const portFlag = args.includes("--port")
+    ? parseInt(args[args.indexOf("--port") + 1], 10)
+    : 3001;
+async function main() {
+    if (transportFlag === "stdio") {
+        const server = createServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("USASpending MCP server running on stdio");
+    }
+    else if (transportFlag === "http") {
+        const app = express();
+        app.use(express.json());
+        const transports = new Map();
+        app.post("/mcp", async (req, res) => {
+            const sessionId = req.headers["mcp-session-id"];
+            if (sessionId && transports.has(sessionId)) {
+                const transport = transports.get(sessionId);
+                await transport.handleRequest(req, res, req.body);
+                return;
+            }
+            if (!sessionId && isInitializeRequest(req.body)) {
+                const transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => randomUUID(),
+                    onsessioninitialized: (sid) => {
+                        transports.set(sid, transport);
+                    },
+                });
+                transport.onclose = () => {
+                    const sid = [...transports.entries()].find(([, t]) => t === transport)?.[0];
+                    if (sid)
+                        transports.delete(sid);
+                };
+                const server = createServer();
+                await server.connect(transport);
+                await transport.handleRequest(req, res, req.body);
+                return;
+            }
+            res.status(400).json({ error: "Invalid request" });
+        });
+        app.get("/mcp", async (req, res) => {
+            const sessionId = req.headers["mcp-session-id"];
+            if (sessionId && transports.has(sessionId)) {
+                const transport = transports.get(sessionId);
+                await transport.handleRequest(req, res);
+                return;
+            }
+            res.status(400).json({ error: "Invalid request - no session" });
+        });
+        app.delete("/mcp", async (req, res) => {
+            const sessionId = req.headers["mcp-session-id"];
+            if (sessionId && transports.has(sessionId)) {
+                const transport = transports.get(sessionId);
+                await transport.handleRequest(req, res);
+                transports.delete(sessionId);
+                return;
+            }
+            res.status(400).json({ error: "Invalid request - no session" });
+        });
+        app.listen(portFlag, () => {
+            console.error(`USASpending MCP server running on http://localhost:${portFlag}/mcp`);
+        });
+    }
+    else {
+        console.error(`Unknown transport: ${transportFlag}. Use "stdio" or "http".`);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,YAAY,IAAI,SAAS,CAYxC"}

package/dist/server.js

@@ -0,0 +1,17 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerReferenceTools } from "./tools/references.js";
+import { registerRecipientTools } from "./tools/recipients.js";
+import { registerSearchTools } from "./tools/search.js";
+import { registerAwardTools } from "./tools/awards.js";
+export function createServer() {
+    const server = new McpServer({
+        name: "usaspending-mcp",
+        version: "0.1.0",
+    });
+    registerReferenceTools(server);
+    registerRecipientTools(server);
+    registerSearchTools(server);
+    registerAwardTools(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/awards.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Award & IDV Detail Tools
+ *
+ * Tools for drilling into specific awards and Indefinite Delivery Vehicles (IDVs).
+ * Once a user finds an award via search, these tools provide full details,
+ * funding breakdowns, subaward chains, transaction histories, and IDV structure.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAwardTools(server: McpServer): void;
+//# sourceMappingURL=awards.d.ts.map

package/dist/tools/awards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awards.d.ts","sourceRoot":"","sources":["../../src/tools/awards.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0W1D"}