# samgovapi.io (remote · samgovapi.io)

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

- Trust score: 64/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `samgovapi.io`: 64/100 (this document), [markdown](https://verifymcp.io/servers/samgovapi-samgovapi/api-mcp.md), [page](https://verifymcp.io/servers/samgovapi-samgovapi/api-mcp)
- npm · `samgovapi-mcp`: 67/100, [markdown](https://verifymcp.io/servers/samgovapi-samgovapi/samgovapi-mcp.md), [page](https://verifymcp.io/servers/samgovapi-samgovapi/samgovapi-mcp)

## Channel facts

- Endpoint: `https://samgovapi.io/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.0`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation 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.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 66/100
  - AI-judged instruction clarity (good).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 17/100
  - Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 98/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 94% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 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.
  - An AI judge read all 31 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

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

### Claude

```bash
claude mcp add --transport http samgovapi-samgovapi 'https://samgovapi.io/api/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "samgovapi-samgovapi": {
      "url": "https://samgovapi.io/api/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "samgovapi-samgovapi": {
      "type": "http",
      "url": "https://samgovapi.io/api/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.samgovapi-samgovapi]
url = "https://samgovapi.io/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "samgovapi-samgovapi": {
      "type": "remote",
      "url": "https://samgovapi.io/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add samgovapi-samgovapi --url 'https://samgovapi.io/api/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  samgovapi-samgovapi:
    url: "https://samgovapi.io/api/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "samgovapi-samgovapi": {
      "Transport": "http",
      "Url": "https://samgovapi.io/api/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add samgovapi-samgovapi -t streamable-http -u 'https://samgovapi.io/api/mcp'
```

### Other

```json
{
  "mcpServers": {
    "samgovapi-samgovapi": {
      "type": "http",
      "url": "https://samgovapi.io/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-20 (score 64, +1)

- [security] Tool “search_opportunities” rewrote its description, which is the text the model reads

### 2026-11-18 (score 63, +1)

- [security] 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
- [functional] New tool “get_sample_data”
- [cosmetic] “start_signup” added an optional parameter “email”

### 2026-11-17 (score 62, 0)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-16 (score 62)

First indexed and scored.

## MCP tools (30)

### `list_alerts` (~86 tokens)

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.

Input parameters:

- `limit` (number)
- `offset` (number)
- `user_request` (string, required): The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

### `get_alerts` (~56 tokens)

Read one of your Alerts by id.

Input parameters:

- `id` (string, required)
- `user_request` (string, required): The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

### `create_alerts` (~155 tokens)

Create one of your Alerts.

Input parameters:

- `agency` (string): Department or agency name to limit matches to
- `kind` (string, required): Which change fires the alert
- `naics` (string): Comma-separated 6-digit NAICS codes for opportunity and recompete alerts
- `name` (string, required): What this alert watches
- `psc` (string): Comma-separated product and service codes
- `set_aside` (string): Set-aside code such as SBA
- `uei` (string): 12-character Unique Entity ID to watch
- `user_request` (string, required): The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

### `update_alerts` (~164 tokens)

Change fields on one of your Alerts.

Input parameters:

- `agency` (string): Department or agency name to limit matches to
- `id` (string, required)
- `kind` (string): Which change fires the alert
- `naics` (string): Comma-separated 6-digit NAICS codes for opportunity and recompete alerts
- `name` (string): What this alert watches
- `psc` (string): Comma-separated product and service codes
- `set_aside` (string): Set-aside code such as SBA
- `uei` (string): 12-character Unique Entity ID to watch
- `user_request` (string, required): The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

### `delete_alerts` (~65 tokens)

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

Input parameters:

- `id` (string, required)
- `user_request` (string, required): The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data.

### `send_feedback` (~48 tokens)

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

Input parameters:

- `contact` (string)
- `kind` (string, required)
- `message` (string, required)

### `get_onboarding_questions` (~40 tokens)

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.

### `answer_onboarding` (~105 tokens)

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.

Input parameters:

- `answers` (object, required): Question id to answer. A select question takes one of its options.
- `client` (string): Your name, such as Claude Code or Cursor.

### `cancel_subscription` (~194 tokens)

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.

Input parameters:

- `client` (string): Your name, such as Claude Code or Cursor.
- `comment` (string): Your user's own words about why. Required when reason is other.
- `reason` (string, required): Why your user is cancelling, in their words mapped to one id. Ask them; never guess.

### `keep_subscription` (~32 tokens)

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

### `get_subscription` (~31 tokens)

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

### `registration_status` (~117 tokens)

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.

Input parameters:

- `id` (string, required): A 12-character UEI or a 5-character CAGE code.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `get_entity` (~132 tokens)

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.

Input parameters:

- `cage` (string): 5-character CAGE code, if there is no UEI.
- `uei` (string): 12-character UEI.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `search_entities` (~243 tokens)

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.

Input parameters:

- `business_type` (string): SAM.gov business type code.
- `cursor` (string): next_cursor from the previous answer.
- `expiring_within_days` (integer): Registrations expiring within this many days.
- `limit` (integer): Rows to return, 1 to 100. Default 25.
- `naics` (string): 6-digit NAICS code.
- `psc` (string): PSC code.
- `q` (string): Name, UEI or CAGE.
- `set_aside` (string): Business type or SBA program code, such as 8A.
- `state` (string): 2-letter state.
- `status` (string): active or expired.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `search_opportunities` (~389 tokens)

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.

Input parameters:

- `active` (boolean): true for open notices only.
- `agency` (string): Department or sub-tier name.
- `agency_code` (string): Department or sub-tier code from the agencies list.
- `cursor` (string): next_cursor from the previous answer.
- `deadline_from` (string): YYYY-MM-DD.
- `deadline_to` (string): Response deadline on or before, YYYY-MM-DD.
- `limit` (integer): Rows to return, 1 to 100. Default 25.
- `naics` (string): NAICS code or prefix.
- `open` (boolean): true for open bids: deadline not passed, award notices left out.
- `posted_from` (string): YYYY-MM-DD.
- `posted_to` (string): YYYY-MM-DD.
- `psc` (string): PSC code.
- `q` (string): Title words or solicitation number.
- `set_aside` (string): Set-aside code, such as SBA, 8A, WOSB, SDVOSBC.
- `sort` (string): posted (newest first) or deadline (closing soonest).
- `state` (string): Place of performance state.
- `type` (string): Notice type.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `get_opportunity` (~100 tokens)

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.

Input parameters:

- `notice_id` (string, required): SAM.gov notice ID.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `exclusion_check` (~102 tokens)

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.

Input parameters:

- `q` (string, required): UEI, CAGE code or exact name.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `search_awards` (~270 tokens)

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.

Input parameters:

- `action_from` (string): YYYY-MM-DD.
- `action_to` (string): YYYY-MM-DD.
- `agency` (string): Awarding agency name.
- `agency_code` (string): Awarding agency or sub-agency code.
- `cursor` (string): next_cursor from the previous answer.
- `expiring_within_days` (integer): Potential end date within this many days.
- `fiscal_year` (integer): Fiscal year.
- `limit` (integer): Rows to return, 1 to 100. Default 25.
- `min_amount` (number): Obligated at least this many dollars.
- `naics` (string): NAICS code or prefix.
- `psc` (string): PSC code.
- `recipient` (string): Recipient name contains.
- `recipient_uei` (string): Recipient UEI.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.
- `vehicle` (string): Contract vehicle name.

### `recompetes` (~217 tokens)

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.

Input parameters:

- `agency` (string): Awarding agency name.
- `agency_code` (string): Awarding agency or sub-agency code.
- `cursor` (string): next_cursor from the previous answer.
- `limit` (integer): Rows to return, 1 to 100. Default 25.
- `min_value` (number): Potential value at least this many dollars.
- `months_ahead` (integer): 1 to 36. Default 12.
- `naics` (string): NAICS code or prefix.
- `set_aside` (string): Set-aside code or comma list, such as SBA,SBP.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `naics_lookup` (~115 tokens)

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.

Input parameters:

- `code` (string): NAICS code, such as 541512.
- `q` (string): Words or a code prefix to search.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `size_standard_check` (~124 tokens)

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.

Input parameters:

- `code` (string, required): 6-digit NAICS code.
- `employees` (number): Average employees.
- `revenue_usd` (number): Average annual receipts in dollars.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `labor_rates` (~155 tokens)

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.

Input parameters:

- `education` (string): Minimum education.
- `limit` (integer): 1 to 100.
- `min_years` (integer): Minimum years of experience.
- `q` (string, required): Labor category words, such as software engineer.
- `schedule` (string): Schedule name.
- `stats` (boolean): Return summary statistics instead of rows.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `teaming_partners` (~239 tokens)

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.

Input parameters:

- `certification` (string): 8a, hubzone, wosb, edwosb or sdvosb.
- `cursor` (string): next_cursor from the previous answer.
- `limit` (integer): Rows to return, 1 to 100. Default 25.
- `naics` (string): NAICS code; a 2 to 5 digit prefix works with small=true.
- `set_aside` (string): SBA program or business type code.
- `small` (boolean): true for small businesses ranked by award volume.
- `state` (string): 2-letter state.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `expiring_registrations` (~175 tokens)

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.

Input parameters:

- `cursor` (string): next_cursor from the previous answer.
- `days` (integer): 1 to 365. Default 30.
- `limit` (integer): Rows to return, 1 to 100. Default 25.
- `naics` (string): NAICS code or 2 to 5 digit prefix.
- `state` (string): 2-letter state.
- `user_request` (string, required): The current user task in one sentence. Leave out secrets and personal data.

### `get_sample_data` (~136 tokens)

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

Input parameters:

- `dataset` (string, required): Dataset name, any case.
- `params` (object): Filters for that dataset, such as {"q":"lockheed"} or {"naics":"541512","open":"true"}. Codes are matched in any case.

### `search` (~80 tokens)

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.

Input parameters:

- `query` (string, required): Words to look for: a company name, a UEI, a NAICS code or a question.

### `fetch` (~79 tokens)

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.

Input parameters:

- `id` (string, required): An id from search, such as entity:ABCDEFGH1234 or naics:541512.

### `start_signup` (~187 tokens)

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.

Input parameters:

- `agent` (string): Your agent or client name.
- `data_wanted` (string, required): What SAM.gov or contracting data they want, 3 to 1000 characters.
- `email` (string): Your user's email, for an instant starter key. Optional.
- `found_us` (string): How your user says they found this API, if they said.
- `use_case` (string, required): What they will do with it, 3 to 1000 characters.

### `finish_signup` (~52 tokens)

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.

Input parameters:

- `device_code` (string, required): The device_code from start_signup.

### `give_feedback` (~173 tokens)

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.

Input parameters:

- `agent` (string): Your agent or client name.
- `blocking` (boolean): True if this stops the task.
- `endpoint` (string): The tool or endpoint involved.
- `kind` (string): Feedback kind.
- `message` (string): 3 to 2000 characters. Name the UEI, notice, field or endpoint.
- `rating` (integer): 1 to 5: how well the last result served the task.
- `use_case` (string): What you are building.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/samgovapi-samgovapi/api-mcp#diagnostics

## Score history

- 2026-11-21: 64
- 2026-11-20: 64
- 2026-11-19: 63
- 2026-11-18: 63
- 2026-11-17: 62
- 2026-11-16: 62

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

## Links

- Remote endpoint: https://samgovapi.io/api/mcp
- Website: https://samgovapi.io/
- Changelog RSS feed: https://verifymcp.io/servers/samgovapi-samgovapi/api-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/samgovapi-samgovapi/api-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/samgovapi-samgovapi/api-mcp.json
- HTML version of this page: https://verifymcp.io/servers/samgovapi-samgovapi/api-mcp
