[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Arizona ROC contractor search](https://spiral.ai/integrations/opencode/arizona-roc-contractor-search)

# How to Use Arizona ROC contractor search in opencode

Returns matching contractors from Arizona's public license register. Use it to find businesses by name or locate a trade in an Arizona city, then examine the individual license records.

|  |  |
| --- | --- |
| Model | Arizona ROC contractor 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 Arizona ROC contractor search in opencode

- Use Arizona ROC contractor search to find electrical contractors in Phoenix and add the returned businesses to a review table in this project.
- Use Arizona ROC contractor search to find roofing businesses in Mesa and export the returned matches into a CSV for our procurement review.
- Use Arizona ROC contractor search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Arizona ROC contractor search and tell me what changed since last week.
- Check Arizona ROC contractor search and summarize what you find in three bullet points.

## How to set up Arizona ROC contractor 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 Arizona ROC contractor 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": "azroc-my-site-com/licenses/search_contractors",
    "input": {
      "city": "<city>"
    }
  }'
```

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

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

## Arizona ROC contractor search tools and prices

- [Arizona Registrar of Contractors license register (azroc.my.site.com) · Search contractors](https://spiral.ai/tools/alexandria/azroc-my-site-com/licenses/search_contractors) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| city |  | — | Arizona city of the licensee (e.g. 'Flagstaff'). |
| query |  | — | Business name, person name ('First Last') or ROC license number ('084810' or 'ROC 084810'). Optional when classifications or city is given. |
| cursor |  | — | `next_cursor` of the previous page (an offset into the same search). |
| page_size | 1 to 100 | 25 | Accounts per page (client-side paging over the full server result). |
| classifications |  | — | License classifications to filter by, spelled as list_classifications returns them (e.g. 'C-37 Plumbing'). |

## What can you do with Arizona ROC contractor search in opencode?

Build an Arizona contractor review feature that connects trade categories with license evidence and permitted work. Use the ROC classification labels, license records, and scope descriptions to populate project screens with source data.

### Build a shortlist for a commercial project

Choose the relevant commercial trade classifications, find contractors in Phoenix, examine their license records, and compare the official scope descriptions with the bid requirements.

### Review vendors for residential maintenance

Identify residential trade categories, find businesses in Tucson, and assemble license details alongside the permitted work for each proposed maintenance assignment.

### Prepare a subcontractor review

Use the classification list to organize required trades, locate candidate businesses, and collect their license status, bonds, public complaint information, and scope descriptions for review.

### Compare trade coverage across cities

Apply consistent classification labels to searches in Flagstaff and Prescott, inspect the returned licenses, and use scope descriptions to explain differences in the work represented.

### Recheck an approved vendor roster

Find the businesses on an Arizona vendor roster and compare their current license status and public complaint information with earlier checks.

### Explain a contractor's permitted work

Locate a contractor's license and turn its official classification scope into a project-specific explanation, identifying work that needs further review.

## Overview

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

## Arizona ROC contractor search in other agents

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

## More opencode guides

- [Arizona ROC contractor license details](https://spiral.ai/integrations/opencode/arizona-roc-contractor-license-details)
- [Arizona ROC license classifications](https://spiral.ai/integrations/opencode/arizona-roc-license-classifications)
- [Apple repair estimates](https://spiral.ai/integrations/opencode/apple-repair-estimates)
- [Arizona ROC license scope description](https://spiral.ai/integrations/opencode/arizona-roc-license-scope-description)
- [Apple product technical specifications](https://spiral.ai/integrations/opencode/apple-product-technical-specifications)
- [Ashby job board overview](https://spiral.ai/integrations/opencode/ashby-job-board-overview)

## Questions about Arizona ROC contractor search in opencode

**Can opencode use Arizona ROC contractor search?**

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

**How much does Arizona ROC contractor 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 Arizona ROC contractor search in opencode?**

No. Spiral runs Arizona ROC contractor 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 Arizona ROC contractor search in opencode?**

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

**Does opencode wait while Arizona ROC contractor search runs?**

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

**Does the register distinguish residential and commercial work?**

Yes. Arizona ROC issues separate residential and commercial licenses, while dual licenses cover both categories. Check the classification's scope against the proposed work.

**How fresh is Arizona ROC license information?**

ROC says its license data can change daily. That statement does not establish a fixed refresh time or promise that every change appears immediately.

**How far back does the online complaint history go?**

ROC says closed complaints remain on its website for two years after closure. Complaint and license files can also be requested through its public records process.

**Does an empty complaint section prove a contractor has never had complaints?**

No. The search excludes canceled and dismissed complaints, plus complaints resolved or settled without a corrective work order.

**Can I look for a particular trade in my area?**

Yes. ROC describes Contractor Search as a way to find a specific contractor or a certain type of contractor in an area. The classification list supplies the trade labels used by the register.

