Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

samgovapi.io

REMOTE · SAMGOVAPI.IO · 2 COMPONENTS

SAM.gov entities, UEI and CAGE lookups, opportunities, exclusions and USAspending awards.

64 Trust /100

Last scanned (19 hours ago)

Scores higher than 46% of remote servers

Reachable. Last reached 21 Nov 2026.

Category Finance and Payments

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security63
Transport & Reachability100
Schema Quality & AI Usability66
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 4198 tokens (~139/item across 30 items; 30 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management17
  • Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage98
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 94% of tool parameters carry a description.Partial
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "delete_alerts" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 31 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities60
  • Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail
What we tested

Checks we ran (12)

  • TLS certificate
  • HTTPS
  • HSTS header
  • DNSSEC
  • Transport
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this hosted endpoint. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Authorization in Endpoint SecurityAuthorisation not fully verified: no authorisation is required to call this server, and 30 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.

Does not apply to this hosted endpoint (2)

  • Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
  • Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 20 Nov 26 +1
    • Tool “search_opportunities” rewrote its description, which is the text the model reads security
  • 18 Nov 26 +1
    • The server rewrote its instructions, which are the text every model session reads security
    • Tool “start_signup” rewrote its description, which is the text the model reads security
    • New tool “get_sample_data” functional
    • “start_signup” added an optional parameter “email” cosmetic
  • 17 Nov 26 0
    • Stability: unverified → 0.03 ▲ functional
  • 16 Nov 26 62

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Probed https://samgovapi.io/api/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=samgovapi.io CN=YR2,O=Let's Encrypt,C=US 13 Nov 2026 11 Feb 2027 RSA 2048 SHA256-RSA 604441d5a347982d2d7850353d1d122c36f
SANs: samgovapi.io
CN=YR2,O=Let's Encrypt,C=US (CA) CN=Root YR,O=ISRG,C=US 3 Sept 2025 2 Sept 2028 RSA 2048 SHA256-RSA 4ebd24947e24d394802d84a52fd5b319
CN=Root YR,O=ISRG,C=US (CA) CN=ISRG Root X1,O=Internet Security Research Group,C=US 13 May 2026 2 Sept 2032 RSA 4096 SHA256-RSA f24b6d17f9d9ad7cb1c9fea78782699f

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of samgovapi.io. — Not signed

Zone DS Keys Algorithms Outcome
. Trust anchor 20326, 38696 8, 8 Verified
io. DS published 38690 8 Verified
samgovapi.io. No DS Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200
Header Value
strict-transport-security max-age=63072000; includeSubDomains
x-content-type-options nosniff
x-frame-options DENY
referrer-policy strict-origin-when-cross-origin
permissions-policy camera=(), microphone=(), geolocation=()

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://samgovapi.io/api/mcp Verified 200
http (plaintext) http://samgovapi.io/api/mcp HTTPS enforced 308 https://samgovapi.io/api/mcp
MCP tools · 30 exposed · ~4,061 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
answer_onboarding ~105

Answer 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 agent. Costs no quota.

NameTypeReqDescription
answersobjectyesQuestion id to answer. A select question takes one of its options.
clientstring–Your name, such as Claude Code or Cursor.

No output schema declared.

No examples provided.

cancel_subscription ~194

Cancel 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 needed), too_expensive (Too expensive), missing_data (Missing data or features I need), reliability (Errors or slow responses), not_using (Not using it enough), switched (Switched to another service), other (Something else). "other" needs a comment. keep_subscription undoes it. Costs no quota.

NameTypeReqDescription
clientstring–Your name, such as Claude Code or Cursor.
commentstring–Your user's own words about why. Required when reason is other.
reasonstringyesWhy your user is cancelling, in their words mapped to one id. Ask them; never guess.

No output schema declared.

No examples provided.

create_alerts ~155

Create one of your Alerts.

NameTypeReqDescription
agencystring–Department or agency name to limit matches to
kindstringyesWhich change fires the alert
naicsstring–Comma-separated 6-digit NAICS codes for opportunity and recompete alerts
namestringyesWhat this alert watches
pscstring–Comma-separated product and service codes
set_asidestring–Set-aside code such as SBA
ueistring–12-character Unique Entity ID to watch
user_requeststringyesThe current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

No output schema declared.

No examples provided.

delete_alerts ~65

Delete one of your Alerts. Cannot be undone, so confirm with your user first.

NameTypeReqDescription
idstringyes–
user_requeststringyesThe current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

No output schema declared.

No examples provided.

exclusion_check ~102

Is 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.

NameTypeReqDescription
qstringyesUEI, CAGE code or exact name.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

expiring_registrations ~175

Firms 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.

NameTypeReqDescription
cursorstring–next_cursor from the previous answer.
daysinteger–1 to 365. Default 30.
limitinteger–Rows to return, 1 to 100. Default 25.
naicsstring–NAICS code or 2 to 5 digit prefix.
statestring–2-letter state.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

fetch ~79

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.

NameTypeReqDescription
idstringyesAn id from search, such as entity:ABCDEFGH1234 or naics:541512.

No output schema declared.

No examples provided.

finish_signup ~52

Collect 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.

NameTypeReqDescription
device_codestringyesThe device_code from start_signup.

No output schema declared.

No examples provided.

get_alerts ~56

Read one of your Alerts by id.

NameTypeReqDescription
idstringyes–
user_requeststringyesThe current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

No output schema declared.

No examples provided.

get_entity ~132

The 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 USAspending source.

NameTypeReqDescription
cagestring–5-character CAGE code, if there is no UEI.
ueistring–12-character UEI.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

get_onboarding_questions ~40

The 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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_opportunity ~100

One 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.

NameTypeReqDescription
notice_idstringyesSAM.gov notice ID.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

get_sample_data ~136

Real rows from any dataset with no key: registration status, entities, opportunities, awards, exclusions, recompetes, NAICS, labor rates or expiring registrations, up to 5 rows a call, same fields as the API. Use it to try the data before your user signs up (10,000 free credits a month, 120 requests a minute, no card).

NameTypeReqDescription
datasetstringyesDataset name, any case.
paramsobject–Filters for that dataset, such as {"q":"lockheed"} or {"naics":"541512","open":"true"}. Codes are matched in any case.

No output schema declared.

No examples provided.

get_subscription ~31

Your user's plan and subscription status, including a scheduled cancellation, and the reasons cancel_subscription accepts. Costs no quota.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

give_feedback ~173

Report 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.

NameTypeReqDescription
agentstring–Your agent or client name.
blockingboolean–True if this stops the task.
endpointstring–The tool or endpoint involved.
kindstring–Feedback kind.
messagestring–3 to 2000 characters. Name the UEI, notice, field or endpoint.
ratinginteger–1 to 5: how well the last result served the task.
use_casestring–What you are building.

No output schema declared.

No examples provided.

keep_subscription ~32

Undo a scheduled cancellation, so your user's plan renews as normal. Only when your user asks. Costs no quota.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

labor_rates ~155

GSA 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.

NameTypeReqDescription
educationstring–Minimum education.
limitinteger–1 to 100.
min_yearsinteger–Minimum years of experience.
qstringyesLabor category words, such as software engineer.
schedulestring–Schedule name.
statsboolean–Return summary statistics instead of rows.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

list_alerts ~86

List 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.

NameTypeReqDescription
limitnumber––
offsetnumber––
user_requeststringyesThe current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

No output schema declared.

No examples provided.

naics_lookup ~115

One 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.

NameTypeReqDescription
codestring–NAICS code, such as 541512.
qstring–Words or a code prefix to search.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

recompetes ~217

Awards 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.

NameTypeReqDescription
agencystring–Awarding agency name.
agency_codestring–Awarding agency or sub-agency code.
cursorstring–next_cursor from the previous answer.
limitinteger–Rows to return, 1 to 100. Default 25.
min_valuenumber–Potential value at least this many dollars.
months_aheadinteger–1 to 36. Default 12.
naicsstring–NAICS code or prefix.
set_asidestring–Set-aside code or comma list, such as SBA,SBP.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

registration_status ~117

Start 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 source.

NameTypeReqDescription
idstringyesA 12-character UEI or a 5-character CAGE code.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

search ~80

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.

NameTypeReqDescription
querystringyesWords to look for: a company name, a UEI, a NAICS code or a question.

No output schema declared.

No examples provided.

search_awards ~270

Find 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.

NameTypeReqDescription
action_fromstring–YYYY-MM-DD.
action_tostring–YYYY-MM-DD.
agencystring–Awarding agency name.
agency_codestring–Awarding agency or sub-agency code.
cursorstring–next_cursor from the previous answer.
expiring_within_daysinteger–Potential end date within this many days.
fiscal_yearinteger–Fiscal year.
limitinteger–Rows to return, 1 to 100. Default 25.
min_amountnumber–Obligated at least this many dollars.
naicsstring–NAICS code or prefix.
pscstring–PSC code.
recipientstring–Recipient name contains.
recipient_ueistring–Recipient UEI.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.
vehiclestring–Contract vehicle name.

No output schema declared.

No examples provided.

search_entities ~243

Find 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.

NameTypeReqDescription
business_typestring–SAM.gov business type code.
cursorstring–next_cursor from the previous answer.
expiring_within_daysinteger–Registrations expiring within this many days.
limitinteger–Rows to return, 1 to 100. Default 25.
naicsstring–6-digit NAICS code.
pscstring–PSC code.
qstring–Name, UEI or CAGE.
set_asidestring–Business type or SBA program code, such as 8A.
statestring–2-letter state.
statusstring–active or expired.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

search_opportunities ~389

Find contract opportunities (bids) by keyword, NAICS, PSC, set-aside, agency, state, notice type, posted dates or deadline. To have new and changed notices pushed instead of polling, any key can open the WebSocket change stream at wss://stream.samgovapi.io/v1/stream (Free: 5 minutes late; paid plans: real time). 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.

NameTypeReqDescription
activeboolean–true for open notices only.
agencystring–Department or sub-tier name.
agency_codestring–Department or sub-tier code from the agencies list.
cursorstring–next_cursor from the previous answer.
deadline_fromstring–YYYY-MM-DD.
deadline_tostring–Response deadline on or before, YYYY-MM-DD.
limitinteger–Rows to return, 1 to 100. Default 25.
naicsstring–NAICS code or prefix.
openboolean–true for open bids: deadline not passed, award notices left out.
posted_fromstring–YYYY-MM-DD.
posted_tostring–YYYY-MM-DD.
pscstring–PSC code.
qstring–Title words or solicitation number.
set_asidestring–Set-aside code, such as SBA, 8A, WOSB, SDVOSBC.
sortstring–posted (newest first) or deadline (closing soonest).
statestring–Place of performance state.
typestring–Notice type.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

send_feedback ~48

Tell the team what is missing or wrong. The team reads every one. Costs no quota.

NameTypeReqDescription
contactstring––
kindstringyes–
messagestringyes–

No output schema declared.

No examples provided.

size_standard_check ~124

The 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.

NameTypeReqDescription
codestringyes6-digit NAICS code.
employeesnumber–Average employees.
revenue_usdnumber–Average annual receipts in dollars.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

start_signup ~187

Get an API key for your user without them pasting one: send what they want and why. With their email you get api_key back at once, a starter key with 250 credits. Show them approval_url and the code; when they approve in the browser (creating a free account if needed) the same key moves to the free plan. Then call finish_signup. Ask your user rather than guess.

NameTypeReqDescription
agentstring–Your agent or client name.
data_wantedstringyesWhat SAM.gov or contracting data they want, 3 to 1000 characters.
emailstring–Your user's email, for an instant starter key. Optional.
found_usstring–How your user says they found this API, if they said.
use_casestringyesWhat they will do with it, 3 to 1000 characters.

No output schema declared.

No examples provided.

teaming_partners ~239

Active, 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) and a record_url to the SAM.gov or USAspending source.

NameTypeReqDescription
certificationstring–8a, hubzone, wosb, edwosb or sdvosb.
cursorstring–next_cursor from the previous answer.
limitinteger–Rows to return, 1 to 100. Default 25.
naicsstring–NAICS code; a 2 to 5 digit prefix works with small=true.
set_asidestring–SBA program or business type code.
smallboolean–true for small businesses ranked by award volume.
statestring–2-letter state.
user_requeststringyesThe current user task in one sentence. Leave out secrets and personal data.

No output schema declared.

No examples provided.

update_alerts ~164

Change fields on one of your Alerts.

NameTypeReqDescription
agencystring–Department or agency name to limit matches to
idstringyes–
kindstring–Which change fires the alert
naicsstring–Comma-separated 6-digit NAICS codes for opportunity and recompete alerts
namestring–What this alert watches
pscstring–Comma-separated product and service codes
set_asidestring–Set-aside code such as SBA
ueistring–12-character Unique Entity ID to watch
user_requeststringyesThe current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

No output schema declared.

No examples provided.

Install

How do I install the samgovapi.io MCP server?

samgovapi.io is a hosted endpoint at https://samgovapi.io/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · samgovapi.io

# add to Claude Code
claude mcp add --transport http samgovapi-samgovapi 'https://samgovapi.io/api/mcp'
Common questions

What is the samgovapi.io MCP server?

samgovapi.io is an MCP server listed in the public MCP registry as io.github.samgovapi/samgovapi. SAM.gov entities, UEI and CAGE lookups, opportunities, exclusions and USAspending awards. This page covers its hosted endpoint (https://samgovapi.io/api/mcp).

Is the samgovapi.io MCP server safe to use?

samgovapi.io scores 64 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the samgovapi.io MCP server expose?

samgovapi.io exposes 30 tools: list_alerts, get_alerts, create_alerts, update_alerts, delete_alerts, and 25 more. Their descriptions and schemas cost roughly 4,061 tokens of context every time the server is loaded.

Does the samgovapi.io MCP server require authentication?

No. We connected to samgovapi.io without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

Is the samgovapi.io MCP server still maintained?

samgovapi.io is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What did VerifyMCP test on the samgovapi.io MCP server?

VerifyMCP ran 12 checks on samgovapi.io, covering TLS certificate, HTTPS, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about samgovapi.io: Authorization. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.