@cliwant/mcp-sam-gov

The most comprehensive keyless federal-data MCP server. 36 tools for SAM.gov + USAspending + Federal Register + eCFR + Grants.gov. No API key, no registration, no signup. Works in Claude Desktop, Claude Code, Codex CLI, Cursor, Continue, Gemini CLI, and any MCP-aware host.

한국어 README · 日本語 README

What this gives Claude (and other AI agents)

36 tools total. Zero API keys. p50 latency 257ms, p95 766ms (live benchmarks against federal APIs).

How do I install it? Pick the path that matches you.

🟢 Path 1 — Claude Desktop, one-click (no terminal needed)

Best for non-developers. Just download a file and double-click.

1. Download mcp-sam-gov.mcpb from the latest release.

2. Double-click the file. Claude Desktop opens with an "Install Extension" dialog.

3. Click Install.

4. Done. Start a new conversation and ask "Find active SAM.gov opportunities under NAICS 541512".

That's it. No PowerShell, no npm, nothing.

Requires Claude Desktop ≥ 1.0 (which ships its own Node.js runtime).

🟡 Path 2 — Claude Code, one command

If you already use Claude Code (the CLI):

/plugin install cliwant/mcp-sam-gov

This installs the MCP server plus a SKILL.md workflow guide that teaches Claude when + how to use each of the 36 tools.

🔵 Path 3 — Manual install for any MCP host (Codex, Cursor, Continue, Gemini)

For Codex CLI / Cursor / Continue / Gemini CLI / anything that speaks MCP:

gh repo clone cliwant/mcp-sam-gov
cd mcp-sam-gov
npm install --omit=dev
npm install -g .

After install, the binary mcp-sam-gov is on your PATH. Add this to your host config:

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov"
    }
  }
}

Specific config locations per host: see Host configurations below.

⚪ Path 4 — Direct path (zero install, just point at the file)

Skip installation entirely:

gh repo clone cliwant/mcp-sam-gov
cd mcp-sam-gov
npm install --omit=dev   # only runtime deps; dist/ is pre-built

Then point your host config at the absolute path:

{
  "mcpServers": {
    "sam-gov": {
      "command": "node",
      "args": ["C:\\Users\\you\\mcp-sam-gov\\dist\\server.js"]
    }
  }
}

Host configurations

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "sam-gov": { "command": "mcp-sam-gov" }
  }
}

(Or skip this entirely — use Path 1's .mcpb and it auto-configures.)

Restart Claude Desktop fully (system tray quit on Windows / Quit menu on macOS), then look for the 🔨 icon. You should see "sam-gov (36 tools)".

Claude Code

Per-project .mcp.json:

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

Or globally:

claude mcp add sam-gov mcp-sam-gov

Codex CLI

~/.codex/config.toml:

[mcp_servers.sam-gov]
command = "mcp-sam-gov"
args = []

Cursor

Settings → MCP → Add new MCP server:

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

Continue

~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServer": {
      "transport": { "type": "stdio", "command": "mcp-sam-gov" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json:

{ "mcpServers": { "sam-gov": { "command": "mcp-sam-gov" } } }

Anything else

If your host speaks MCP over stdio, point it at mcp-sam-gov. No host-specific code.

What questions can I ask?

Once installed, you can ask in natural language. The agent picks the right tool sequence automatically.

Discovery

• "NAICS 541512 의 메릴랜드 입찰 중 30일 안에 마감되는 것 찾아줘"

• "Find active SAM.gov solicitations under NAICS 541512, MD only, closing in 30 days"

• "What's the canonical NAICS code for 'computer systems design'?"

RFP analysis

• "Pull noticeId 5ef3db5daeb54099a96d487783a38bd0 — give me the SOW, contracting officer, and attachments"

• "Show me the full RFP body for that notice"

Competitive landscape

• "Top 5 recipients of VA contracts in NAICS 541519 last fiscal year"

• "Show me Booz Allen's individual awards at DISA"

• "Who are the sub-contractors on Leidos' VA contracts?"

• "What's CMS in USAspending? (resolve the abbreviation)"

Trends & aggregation

• "How has VA 541512 spending trended over the last 5 fiscal years?"

• "Top 10 states by federal contracting spend in 541512"

• "Top PSC categories at DoD by spending"

• "Federal grant programs in cybersecurity by total $"

Agency intelligence (capture brief)

• "Give me a capture brief on VA: mission, FY26 budget breakdown, top sub-agencies"

• "What's VA's transaction volume for FY25?"

Recompete radar

• "VA 541512 contracts expiring in next 12 months over $1M"

• "Pull period of performance for award CONT_AWD_..."

Regulatory

• "Find FAR sections about SDVOSB set-aside requirements"

• "What new VA cybersecurity rules were published this quarter?"

• "Is there a Federal Register doc number 2026-08333? Pull the citation."

Grants

• "Cybersecurity grants posted in the last 30 days"

• "Pull grant id 361238"

Optional — higher rate limits + archives

The MCP server runs keyless by default. For higher SAM.gov rate limits + the full archive (notices older than ~12 months), set SAM_GOV_API_KEY in your host's env block:

{
  "mcpServers": {
    "sam-gov": {
      "command": "mcp-sam-gov",
      "env": { "SAM_GOV_API_KEY": "your-key-here" }
    }
  }
}

Get a free key at sam.gov/SAM/pages/public/searchKeyData.jsf. The agent doesn't need to know — the key path is transparent.

Tool catalog (36 tools)

• sam_search_opportunities — keyless HAL search (~47K active)

• sam_get_opportunity — full detail by 32-char hex noticeId (POCs + attachments + body)

• sam_fetch_description — full RFP body as plain text

• sam_attachment_url — public download URL for resourceId

• sam_lookup_organization — federal-organization id → fullParentPathName

• usas_search_awards — share-of-wallet at agency × NAICS

• usas_search_individual_awards — line items (returns generatedInternalId)

• usas_search_subagency_spending — buyer-office breakdown

• usas_lookup_agency — abbreviation → canonical name

• usas_search_awards_by_recipient — recipient win history

• usas_search_subawards — supply-chain / teaming

• usas_search_expiring_contracts — recompete radar

• usas_get_award_detail — period of performance, options, set-aside, competition

• usas_spending_over_time — fiscal_year / quarter / month time series

• usas_search_psc_spending — PSC market structure

• usas_search_state_spending — geographic distribution

• usas_search_cfda_spending — grant programs

• usas_search_federal_account_spending — Treasury Account Symbols (TAS)

• usas_search_agency_spending — top buying agencies for NAICS / set-aside

• usas_get_agency_profile — mission, abbreviation, website

• usas_get_agency_awards_summary — transaction count + obligations

• usas_get_agency_budget_function — budget breakdown by program area

• usas_search_recipients — list with parent/child hierarchy

• usas_get_recipient_profile — full detail (DUNS, UEI, alternate names, totals)

• usas_autocomplete_naics — anti-hallucination NAICS guard

• usas_autocomplete_recipient — anti-hallucination recipient guard

• usas_naics_hierarchy — navigate NAICS tree

• usas_glossary — 151 federal-spending terms

• usas_list_toptier_agencies — list all toptier agencies + obligations

• fed_register_search_documents — search by query / agency / type / date

• fed_register_get_document — citation, body URL, CFR refs

• fed_register_list_agencies — agency slugs reference

• ecfr_search — full-text search (titleNumber=48 for FAR)

• ecfr_list_titles — all 50 CFR titles + last-amended dates

• grants_search — opportunity search

• grants_get_opportunity — full grant detail

Troubleshooting

Use as a TypeScript / JavaScript library (no MCP)

Beyond the MCP server, this package also exports the underlying federal-data clients as importable modules. Useful if you're building your own SaaS, AI agent, or CLI and want programmatic access without spawning an MCP server.

npm install @cliwant/mcp-sam-gov

// SAM.gov client
import { SamGovClient } from "@cliwant/mcp-sam-gov/sam-gov";

const sam = new SamGovClient(); // keyless
const result = await sam.searchOpportunities({ ncode: "541512", limit: 5 });
const opp = await sam.getOpportunity("5ef3db5daeb54099a96d487783a38bd0");

// USAspending wrappers (22 functions)
import * as usas from "@cliwant/mcp-sam-gov/usaspending";

const recompete = await usas.searchExpiringContracts({
  agency: "Department of Veterans Affairs",
  naics: "541512",
  monthsUntilExpiry: 12,
});
const recipient = await usas.getRecipientProfile("ed02855e-60d7-2540-...-P");

// Federal Register / eCFR / Grants.gov
import * as fedreg from "@cliwant/mcp-sam-gov/federal-register";
import * as ecfr from "@cliwant/mcp-sam-gov/ecfr";
import * as grants from "@cliwant/mcp-sam-gov/grants";

const farResults = await ecfr.search({ query: "SDVOSB", titleNumber: 48 });

This is the canonical home for the Cliwant federal-data libraries — there is no separate library package. Two earlier repos (govicon-sam-gov and govicon-mcp-sam-gov) have been archived and consolidated here. All client code lives in src/sam-gov/, src/usaspending.ts, src/federal-register.ts, src/ecfr.ts, src/grants.ts.

License

MIT — see LICENSE.

Disclaimer

This server uses publicly available federal API endpoints. It is not affiliated with the General Services Administration, SAM.gov, USAspending.gov, the Office of the Federal Register, the National Archives, Grants.gov, or any federal agency. Federal procurement, spending, and regulation data is in the public domain.