[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [SAM.gov registration changes](https://spiral.ai/integrations/opencode/sam-gov-registration-changes)

# How to Use SAM.gov registration changes in opencode

Returns entity registrations updated since the previous run. Use it to refresh a supplier directory incrementally and identify business records that need another review.

|  |  |
| --- | --- |
| Model | SAM.gov registration changes |
| Available through | Alexandria |
| Category | Public Records |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with SAM.gov registration changes in opencode

- Use SAM.gov registration changes to collect updated Virginia business registrations since the previous run and reconcile them with the project's supplier records.
- Use SAM.gov registration changes to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from SAM.gov registration changes and tell me what changed since last week.
- Check SAM.gov registration changes and summarize what you find in three bullet points.
- Pull the newest data from SAM.gov registration changes and give me the result as a table.

## How to set up SAM.gov registration changes in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run SAM.gov registration changes**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "sam-gov/opportunities/entities_changes",
    "input": {
      "updated_to": "<updated_to>",
      "updated_from": "<updated_from>"
    }
  }'
```

Then paste one of the prompts above: opencode finds SAM.gov registration changes on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## SAM.gov registration changes tools and prices

- [SAM.gov · Entities changes](https://spiral.ai/tools/alexandria/sam-gov/opportunities/entities_changes) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 0 to 9999 | — | 0-based page (default 0); page * size may not exceed 10,000. |
| size | 1 to 10 | — | Records per page, 1 to 10 (SAM.gov's hard limit; default 10). |
| state |  | — | Physical-address state code, to split a window above 10,000 records. Pattern: ^[A-Za-z]{2}$. |
| registration_status | A, E, a, e | — | A (active) or E (expired); default both. |

## What can you do with SAM.gov registration changes in opencode?

Build a procurement dashboard that combines federal notices, public business registrations, and business exclusion checks. Use the project's saved records to compare notice revisions, apply registration updates, and manage extract refreshes.

### Review a daily bid watch

Find notices worth reviewing, inspect their details, and collect registration updates affecting the supplier roster. Check exclusions publication status before refreshing individual business checks.

### Maintain a supplier directory

Check for a new monthly registration baseline, collect subsequent registration changes, and resolve business records through searches and identifier lookups. Refresh business exclusion matches when a new exclusions snapshot appears.

### Compile a monthly procurement review

Summarize relevant notices and their detailed requirements alongside registration changes affecting the business supplier roster. Identify the entity and exclusions publications used for the review.

### Assemble procurement review evidence

Collect notice descriptions, attachment links, known supplier registrations, and business exclusion records for a procurement review. Include registration updates and extract publication metadata to explain the evidence available.

### Reconcile supplier data imports

Compare imported business records with registration searches, identifier lookups, and subsequent changes. Check which extract publications underlie the import, then investigate firm exclusion matches individually.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## SAM.gov registration changes in other agents

- [Amp](https://spiral.ai/integrations/amp/sam-gov-registration-changes)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/sam-gov-registration-changes)
- [Claude](https://spiral.ai/integrations/claude-desktop/sam-gov-registration-changes)
- [Claude Code](https://spiral.ai/integrations/claude-code/sam-gov-registration-changes)
- [Cline](https://spiral.ai/integrations/cline/sam-gov-registration-changes)
- [Codex](https://spiral.ai/integrations/codex/sam-gov-registration-changes)
- [Cursor](https://spiral.ai/integrations/cursor/sam-gov-registration-changes)
- [Devin](https://spiral.ai/integrations/devin/sam-gov-registration-changes)
- [dots](https://spiral.ai/integrations/dots/sam-gov-registration-changes)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/sam-gov-registration-changes)
- [Gemini](https://spiral.ai/integrations/gemini/sam-gov-registration-changes)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/sam-gov-registration-changes)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/sam-gov-registration-changes)
- [goose](https://spiral.ai/integrations/goose/sam-gov-registration-changes)
- [Grok](https://spiral.ai/integrations/grok/sam-gov-registration-changes)
- [Grok Build](https://spiral.ai/integrations/grok-build/sam-gov-registration-changes)
- [Hermes](https://spiral.ai/integrations/hermes/sam-gov-registration-changes)
- [Instinct](https://spiral.ai/integrations/instinct/sam-gov-registration-changes)
- [Manus](https://spiral.ai/integrations/manus/sam-gov-registration-changes)
- [Muse](https://spiral.ai/integrations/muse/sam-gov-registration-changes)
- [Muse Code](https://spiral.ai/integrations/muse-code/sam-gov-registration-changes)
- [n8n](https://spiral.ai/integrations/n8n/sam-gov-registration-changes)
- [Notion](https://spiral.ai/integrations/notion/sam-gov-registration-changes)
- [OpenClaw](https://spiral.ai/integrations/openclaw/sam-gov-registration-changes)
- [Perplexity](https://spiral.ai/integrations/perplexity/sam-gov-registration-changes)
- [Raycast](https://spiral.ai/integrations/raycast/sam-gov-registration-changes)
- [VS Code](https://spiral.ai/integrations/vscode/sam-gov-registration-changes)
- [Windsurf](https://spiral.ai/integrations/windsurf/sam-gov-registration-changes)
- [Zapier](https://spiral.ai/integrations/zapier/sam-gov-registration-changes)

## More opencode guides

- [SAM.gov registered business search](https://spiral.ai/integrations/opencode/sam-gov-registered-business-search)
- [Socrata dataset details](https://spiral.ai/integrations/opencode/socrata-dataset-details)
- [SAM.gov monthly entity extract status](https://spiral.ai/integrations/opencode/sam-gov-monthly-entity-extract-status)
- [Socrata dataset records](https://spiral.ai/integrations/opencode/socrata-dataset-records)
- [SAM.gov entity registration lookup](https://spiral.ai/integrations/opencode/sam-gov-entity-registration-lookup)
- [Socrata dataset search](https://spiral.ai/integrations/opencode/socrata-dataset-search)

## Questions about SAM.gov registration changes in opencode

**Can opencode use SAM.gov registration changes?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run SAM.gov registration changes like any built-in tool.

**How much does SAM.gov registration changes cost in opencode?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use SAM.gov registration changes in opencode?**

No. Spiral runs SAM.gov registration changes on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up SAM.gov registration changes in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while SAM.gov registration changes runs?**

SAM.gov registration changes runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**What does SAM.gov cover?**

SAM.gov publishes federal procurement notices, entity registrations, and exclusions. Its contract notices include presolicitations, solicitations, award notices, and sole-source notices; it directs grant searches to Grants.gov.

**What information is public in entity registrations?**

Public registration data includes business names, UEIs, registration details, addresses, business types, and industry classifications such as NAICS. These are registration records for entities doing business with the federal government.

**Can an entity search return every matching registration?**

The Entity Management API returns ten records per page and stops at the first 10,000 matches. For a broad business search, narrow the geography or industry before collecting additional pages.

**When does the monthly entity extract change?**

GSA processes monthly entity extracts on the first Sunday of each month. A monthly publication is a baseline for that publication date, rather than a continuous stream of registration changes.

**Does the exclusions extract include past exclusions?**

The extract contains currently open exclusions. It is suitable for reviewing the published active list, but it does not provide a complete history of terminated exclusions.

