SAM.gov entities, UEI and CAGE lookups, opportunities, exclusions and USAspending awards.
Connect Remote server
claude mcp add --transport http samgovapi https://samgovapi.io/api/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
{
"mcpServers": {
"samgovapi": {
"url": "https://samgovapi.io/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
{
"servers": {
"samgovapi": {
"type": "http",
"url": "https://samgovapi.io/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://samgovapi.io/api/mcp
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 29 found in our last check
list_alertsList Alerts. A saved watch on SAM.gov data, such as a registration expiry for a UEI or new opportunities matching your NAICS and PSC codes.
get_alertsRead one of your Alerts by id.
create_alertsCreate one of your Alerts.
update_alertsChange fields on one of your Alerts.
delete_alertsDelete one of your Alerts. Cannot be undone, so confirm with your user first.
send_feedbackTell the team what is missing or wrong. The team reads every one. Costs no quota.
get_onboarding_questionsThe questions that finish setting up your user's account, with their ids and options. With a key, also the answers already given. Costs no quota.
answer_onboardingAnswer the onboarding questions for your user, from what you know about their project. Ask them what you do not know; never guess. Answering again replaces the answers; the same answers twice change nothing. Your user sees them on their dashboard, marked as answered by their age…
cancel_subscriptionCancel your user's paid plan at the end of the current billing period. Only call this when your user asked to cancel. A reason is required: ask your user why they are cancelling and pass their answer; never pick a reason for them. Reasons: got_what_i_needed (I got the data I nee…
keep_subscriptionUndo a scheduled cancellation, so your user's plan renews as normal. Only when your user asks. Costs no quota.
get_subscriptionYour user's plan and subscription status, including a scheduled cancellation, and the reasons cancel_subscription accepts. Costs no quota.
registration_statusStart here for a company: is this UEI or CAGE registered in SAM.gov, its status, expiration date, days to expiry, renewal window and exclusion flag. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending so…
get_entityThe full SAM.gov registration of one entity by UEI or CAGE: names, status, dates, address city and state, NAICS, PSC, business types, SBA certifications. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspendi…
search_entitiesFind registered entities by name, UEI, CAGE, NAICS, PSC, state, set-aside or business type, status, or registrations expiring within N days. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
search_opportunitiesFind contract opportunities (bids) by keyword, NAICS, PSC, set-aside, agency, state, notice type, posted dates or deadline. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
get_opportunityOne contract opportunity with its full description. Contracting-officer contacts as printed in the notice are included on Pro and Scale. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
exclusion_checkIs this UEI, CAGE code or exact name actively excluded from federal awards? Answers from the dated exclusions extract. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
search_awardsFind contract awards by recipient UEI, agency, NAICS, PSC, vehicle, fiscal year, or awards ending within N days. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
recompetesAwards whose potential end date falls in the next months, the contracts most likely to be recompeted, by NAICS and agency. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
naics_lookupOne NAICS code (title, description, size standard), or a search of codes by words or prefix. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
size_standard_checkThe SBA size standard for a NAICS code, and whether a business with these average annual receipts or employees counts as small. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
labor_ratesGSA schedule ceiling labor rates for a category, or with stats=true the count, quartiles and range. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
teaming_partnersActive, unexcluded firms in a NAICS code for finding teaming partners; with small=true or a certification (8a, hubzone, wosb, edwosb, sdvosb), small businesses ranked by award volume. Pro and Scale. Costs credits like the REST call. Every answer has meta.as_of (the dataset date)…
expiring_registrationsFirms whose SAM.gov registration expires within the next N days (default 30), soonest first, by NAICS and state. Individuals are left out. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
searchSearch 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.
fetchThe 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.
start_signupGet an API key for your user without them pasting one: send what they want and why, then show them approval_url and the code. They approve in the browser (creating a free account if needed). Then call finish_signup. Ask your user rather than guess.
finish_signupCollect the API key after your user approves: send the device_code from start_signup. Returns status pending until they approve; the key is returned once.
give_feedbackReport wrong or missing data, a missing feature, a bug or a docs gap, or rate the last result 1 to 5. Kinds: wrong_data, missing_data, missing_feature, bug, docs, praise, other. No key needed and no credits; the team reads every one.
Headers
| Name | Description |
|---|---|
AuthorizationOptional, secret | Optional. "Bearer " followed by an API key from https://samgovapi.io/dashboard/keys. search and fetch work without it. |
Details
| Endpoint | https://samgovapi.io/api/mcp (Streamable HTTP) |
| Package | [email protected] (NPM, stdio) |
| First published | 16 Nov 2026 |
| Last updated | 16 Nov 2026 |
| Registry name | io.github.samgovapi/samgovapi |
More search and web servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
