{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_8q7zmqqa5s5f","handle":"usaspending-mcp","url":"https://wellknown.network/agents/usaspending-mcp","links":{"self":"https://wellknown.network/agents/usaspending-mcp/record.json","html":"https://wellknown.network/agents/usaspending-mcp","markdown":"https://wellknown.network/agents/usaspending-mcp/record.md","api":"https://wellknown.network/api/v1/agents/usaspending-mcp","status":"https://wellknown.network/api/v1/agents/usaspending-mcp/status","claim":"https://wellknown.network/agents/usaspending-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/usaspending-mcp/claim.json","badge":"https://wellknown.network/agents/usaspending-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/usaspending-mcp/history","tools":"https://wellknown.network/api/v1/agents/usaspending-mcp/tools"},"ard":{"identifier":"urn:air::server:usaspending-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"usaspending-mcp","summary":"MCP server for US federal spending data via api.usaspending.gov","description":"# usaspending-mcp\n\n[![CI](https://github.com/asachs01/usaspending-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/asachs01/usaspending-mcp/actions/workflows/ci.yml)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://python.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-blueviolet.svg)](https://modelcontextprotocol.io)\n\nProduction-grade MCP server for US federal spending data via [api.usaspending.gov](https://api.usaspending.gov).\n\n## Features\n\n- **8 decision-tree tools** covering the full USASpending API (awards, agencies, recipients, spending, disaster funding, accounts, downloads)\n- **Dual transport:** STDIO (Claude Desktop/Code) and Streamable HTTP + SSE (hosted deployments)\n- **Progress notifications** for long-running paginated searches and bulk downloads\n- **4 MCP resources:** agencies list, current fiscal year, data freshness, glossary\n- **Lazy-loaded reference data** with TTL cache (no blocking startup calls)\n- **No authentication required** — USASpending API is public\n\n## Installation\n\n```bash\n# From PyPI (when published)\npip install usaspending-mcp\n\n# From GitHub\npip install git+https://github.com/asachs01/usaspending-mcp.git\n\n# For development\ngit clone https://github.com/asachs01/usaspending-mcp.git\ncd usaspending-mcp\npip install -e \".[dev]\"\n```\n\n## Quick Start\n\n```bash\n# STDIO mode (default — for Claude Desktop / Claude Code)\nusaspending-mcp\n\n# HTTP mode (for hosted/remote deployments)\nusaspending-mcp-http\n\n# With custom port\nusaspending-mcp-http --port 9000\n\n# Auto-detect transport\npython -m usaspending_mcp.server --transport http\n```\n\n## Configuration\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"usaspending\": {\n      \"command\": \"uvx\",\n      \"args\": [\"usaspending-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"usaspending\": {\n      \"command\": \"uvx\",\n      \"args\": [\"usaspending-mcp\"]\n    }\n  }…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:usaspending-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":1,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"usaspending-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:01.428Z","publishedAt":"2026-03-02T18:37:38.219910Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"usaspending-mcp","url":"https://pypi.org/project/usaspending-mcp/","firstSeenAt":"2026-09-10T15:22:57.877Z","fetchedAt":"2026-09-10T15:22:57.877Z","normalizedAt":"2026-09-10T15:22:57.877Z"}]},"firstSeenAt":"2026-09-10T15:22:57.877Z","updatedAt":"2026-09-10T15:25:01.428Z"}