samgovapi-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
samgovapi-mcp
A stdio MCP server for samgovapi.io: SAM.gov entity registrations, UEI and CAGE lookups, contract opportunities, exclusions and USAspending prime awards, for Claude Desktop, Claude Code, Cursor, VS Code and any other MCP client.
searchandfetchwork with no API key.Set
SAMGOVAPI_API_KEYand the data tools appear too:registration_status,get_entity,search_entities,search_opportunities,get_opportunity,exclusion_check,search_awards,recompetes,naics_lookup,size_standard_check,labor_rates,expiring_registrations.Zero dependencies, Node 18+. It forwards JSON-RPC to the hosted server at
https://samgovapi.io/api/mcp, so tool schemas always match the live API.
Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.
Use it
Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and most clients take the same block:
{
"mcpServers": {
"samgovapi": {
"command": "npx",
"args": ["-y", "samgovapi-mcp"],
"env": { "SAMGOVAPI_API_KEY": "sg_..." }
}
}
}Leave out env to run keyless. Claude Code:
claude mcp add samgovapi -e SAMGOVAPI_API_KEY=sg_... -- npx -y samgovapi-mcpA client that speaks Streamable HTTP can skip this package and point at the hosted server directly: https://samgovapi.io/api/mcp, with an optional Authorization: Bearer sg_... header.
Free keys: samgovapi.io/sign-up. The data tools take user_request, the current task in one sentence.
Related MCP server: EzBiz Government Contracting MCP Server
Environment
Variable | Effect |
| Optional. Enables the keyed data tools and sends |
| Expose every hosted tool, including |
| Override the upstream endpoint (used by the tests). |
Real run
The published bin, run over stdio with no key on 15 Nov 2026:
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"readme","version":"0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
'{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search","arguments":{"query":"Booz Allen Hamilton"}}}' \
| npx -y samgovapi-mcpOutput, one JSON-RPC reply per line (the notification gets none):
{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{"listChanged":false}},"serverInfo":{"name":"samgovapi-mcp","title":"samgovapi.io","version":"0.1.0","websiteUrl":"https://samgovapi.io?utm_source=npm&utm_medium=readme&utm_campaign=samgovapi-mcp"},"instructions":"SAM.gov entities, CAGE and UEI lookups, contract opportunities, exclusions and USAspending awards from samgovapi.io. search and fetch work with no key. Set SAMGOVAPI_API_KEY (free at https://samgovapi.io/sign-up?utm_source=npm&utm_medium=readme&utm_campaign=samgovapi-mcp) for the data tools; they take user_request, the current task in one sentence. Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency."}}{"jsonrpc":"2.0","id":2,"result":{"tools":[{"name":"search","description":"Search the public samgovapi.io lookup pages and docs: companies by name, UEI or CAGE, NAICS codes, open opportunities, guides and data fields. Needs no key. Then call fetch with a result id.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Words to look for: a company name, a UEI, a NAICS code or a question."}},"required":["query"]}},{"name":"fetch","description":"The full text of one search result as markdown: a company's registration and awards, an opportunity, a NAICS code, a doc or a field. Needs no key. Quote the data-as-of date when you state a fact.", ...(2,903 bytes in full; the five keyless tools listed are search, fetch, start_signup, finish_signup, give_feedback.)
{"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"{\"results\":[{\"id\":\"entity:UAVDK5WWYDZ5\",\"title\":\"BOOZ ALLEN HAMILTON INC (UEI UAVDK5WWYDZ5)\",\"url\":\"https://samgovapi.io/entity/UAVDK5WWYDZ5\"},{\"id\":\"entity:QDFNQQ83G946\",\"title\":\"BOOZ ALLEN HAMILTON INC. (UEI QDFNQQ83G946)\",\"url\":\"https://samgovapi.io/entity/QDFNQQ83G946\"},{\"id\":\"entity:ELFANDP17M48\",\"title\":\"BOOZ ALLEN HAMILTON INC. (UEI ELFANDP17M48)\",\"url\":\"https://samgovapi.io/entity/ELFANDP17M48\"},{\"id\":\"entity:CZ26THPKFPJ9\",\"title\":\"BOOZ ALLEN HAMILTON INC. (UEI CZ26THPKFPJ9)\",\"url\":\"https://samgovapi.io/entity/CZ26THPKFPJ9\"},{\"id\":\"entity:FRFTWN17QUF3\",\"title\":\"BOOZ ALLEN HAMILTON INC (UEI FRFTWN17QUF3)\",\"url\":\"https://samgovapi.io/entity/FRFTWN17QUF3\"}]}"}],"isError":false}}Then fetch with {"id":"entity:UAVDK5WWYDZ5"} returns that registration as markdown: status, expiration date, NAICS codes, exclusion flag, the data-as-of date and links to the SAM.gov and USAspending records.
Plans and credits
The keyless tools are rate limited per client and cost nothing. With a key: Free is 100 credits a month and 20 requests a minute with no card; Developer $49 a month, Pro $149, Scale $499; a $9 top-up adds 1,000 credits. A lookup costs 1 credit, a search 1 per 100 rows, award history 3x, and errors cost nothing.
Coverage
As of 15 Nov 2026: 881,370 entities from the 1 Nov 2026 SAM.gov monthly extract, 74,420 opportunity notices (nightly), 169,191 exclusions (daily) and 114,954 USAspending prime awards with action dates from 1 Oct 2026. Award history before FY2027 is not loaded yet.
Tests
npm test # offline: JSON-RPC loop with a mocked upstream, plus a stdio run against a local fake server
SAMGOVAPI_LIVE=1 npm test # also lists tools and runs search and fetch on the hosted serverRegistry
server.json describes this package (npm, stdio) and the hosted Streamable HTTP endpoint for the official MCP registry. package.json carries the matching mcpName.
License
MIT, Copyright (c) 2026 Stunning Couches LLC.
Links
Product: https://samgovapi.io
Hosted MCP endpoint (Streamable HTTP):
https://samgovapi.io/api/mcpMCP Registry name:
io.github.samgovapi/samgovapi
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
SAM.gov entities, UEI and CAGE lookups, opportunities, exclusions and USAspending awards.
SAM.gov contract opportunities and entity lookup (BYOK) plus USASpending federal award data.
MCP access to the U.S. federal procurement graph: contracts, opportunities, entities, and more.
Pay-per-result SAM.gov contracts, SEC EDGAR filings, USAspending awards and GLEIF LEI lookups.
Related MCP Servers
- AlicenseAqualityBmaintenanceThe 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.153238 npm19MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to search federal contracts, analyze agency spending, track competitor wins, and monitor small business set-aside opportunities using SAM.gov, USASpending.gov, and FPDS data.1-
- AlicenseAqualityDmaintenanceMCP server for querying SAM.gov federal contract opportunities, providing precise search, retrieval, and attachment tools with full source traceability and explicit abstention when data is absent.5MIT
- AlicenseAqualityDmaintenanceMCP server for querying US federal contracts and public company financial data from USAspending and SEC EDGAR. Enables searching expiring contracts, screening companies by metrics, and retrieving financial histories.4MIT