[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Colorado business search](https://spiral.ai/integrations/opencode/colorado-business-search)

# How to Use Colorado business search in opencode

Finds Colorado registry records by business name, ID, or document number. Use it to identify the right record before requesting entity details or filing history.

|  |  |
| --- | --- |
| Model | Colorado business search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Colorado business search in opencode

- Use Colorado business search to find records matching New Belgium Brewing, then add the returned names and entity IDs to a review table in this project.
- Use Colorado business search for Denver Zoo and show the matching registry records beside the nonprofit entries in our project.
- Use Colorado business search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Colorado business search and tell me what changed since last week.
- Check Colorado business search and summarize what you find in three bullet points.

## How to set up Colorado business search 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 Colorado business search**: 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": "sos-state-co-us/entities/search",
    "input": {
      "name": "<name>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Colorado business search on Spiral, shows the price and runs it.

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

## Colorado business search tools and prices

- [Colorado Secretary of State business database · Search](https://spiral.ai/tools/alexandria/sos-state-co-us/entities/search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 200 | 1 | 1-based results page (about 20 rows per page). Each page costs a fresh search session on the site. |

## What can you do with Colorado business search in opencode?

Add Colorado registry evidence to company records in your project. A coding agent can match entity IDs, display registry summaries, and attach filing links to a review screen.

### Review a supplier’s registration

Find the supplier’s Colorado record, inspect its entity summary, and review filed documents before completing a supplier review.

### Match a contract to a registry record

Resolve the business name on a proposed contract, compare the entity summary, and collect relevant filing links for the contract reviewer.

### Prepare a company research brief

Identify a business’s Colorado registration and combine its summary with a dated filing timeline and document links.

### Review a nonprofit partner

Find the nonprofit’s registry record, inspect its summary, and gather filing history for a partnership review.

### Reconcile duplicate company records

Resolve similar business names to Colorado entity IDs, then compare the corresponding summaries before merging company records.

## Overview

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

## Colorado business search in other agents

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

## More opencode guides

- [Colorado business filing history](https://spiral.ai/integrations/opencode/colorado-business-filing-history)
- [Companies House PSC snapshot status](https://spiral.ai/integrations/opencode/companies-house-psc-snapshot-status)
- [Colorado business entity details](https://spiral.ai/integrations/opencode/colorado-business-entity-details)
- [Companies House advanced company search](https://spiral.ai/integrations/opencode/companies-house-advanced-company-search)
- [Canadian patent search](https://spiral.ai/integrations/opencode/canadian-patent-search)
- [Companies House alphabetical company search](https://spiral.ai/integrations/opencode/companies-house-alphabetical-company-search)

## Questions about Colorado business search in opencode

**Can opencode use Colorado business search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Colorado business search like any built-in tool.

**How much does Colorado business search 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 Colorado business search in opencode?**

No. Spiral runs Colorado business search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Colorado business search in opencode?**

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

**Does opencode wait while Colorado business search runs?**

Colorado business search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does Colorado’s online registry include all historical records?**

Colorado says all records filed since 1997 are online. Some older records were removed from the searchable database, so an unsuccessful search does not settle whether an older entity existed.

**How quickly do online filings appear?**

Documents filed online become available immediately after successful payment at the source. That is the registry’s publication timing, not a separate freshness guarantee for an API response.

**How many search matches appear on a page?**

The source website splits results into pages when a search finds more than 20 possible matches. A broad name search can therefore require several pages to review.

**Does Good Standing mean Colorado verified the business’s claims?**

Good Standing means the business met statutory filing requirements. The Secretary of State does not review or verify the information submitted in those filings.

**Why might an older filing document be missing?**

Colorado explicitly provides a request process for missing documents and records filed before January 2001. An online filing history should not be treated as proof that every historical document is available.

