[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [BBB business search](https://spiral.ai/integrations/windsurf/bbb-business-search)

# How to Use BBB business search in Windsurf

Returns matching BBB businesses with grades, accreditation flags, addresses, phone numbers, and profile links, up to 15 per page. Use it to identify the right business before examining its full record.

|  |  |
| --- | --- |
| Model | BBB business search |
| Available through | Alexandria |
| Category | Maps & Reviews |
| Price | $0.001746 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with BBB business search in Windsurf

- Use BBB business search to find movers near Miami, Florida, and add their names, addresses, and profile links to my personal comparison page.
- Use BBB business search to find roofers near Denver, Colorado, and organize the returned business names and accreditation flags in a table.
- Use BBB business search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from BBB business search and tell me what changed since last week.
- Check BBB business search and summarize what you find in three bullet points.

## How to set up BBB business search in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 BBB 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": "bbb-business-profiles-ratings-complaint/businesses/search",
    "input": {
      "query": "<query>"
    }
  }'
```

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

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

## BBB business search tools and prices

- [BBB business profiles · Business search](https://spiral.ai/tools/alexandria/bbb-business-profiles-ratings-complaint/businesses/search) (Alexandria): $0.001746 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 100 | 1 | Results page, 1 to 100 (15 results per page). |
| sort | Relevance, Distance, Rating, AToZ, ZToA | Relevance | Result order. |
| country | us, ca | us | Which BBB site to search. |
| location |  | — | City and state/province (Austin, TX) or postal code, up to 120 characters. Omit for a nationwide search. |

## What can you do with BBB business search in Windsurf?

Build a personal contractor comparison that links each business to its BBB record. A coding agent can organize returned grades, complaint details, or customer feedback in your project's comparison view.

### Choose a moving company

Find movers near Miami, confirm each business's identity, and compare grades, complaint histories, customer reviews, and published responses before booking.

### Check a roofer before a deposit

Locate Denver roofing businesses, review their BBB records, and read complaints and reviews for issues to ask about before signing.

### Compare internet providers

Match providers to their BBB profiles and compare published billing disputes, customer feedback, business replies, and complaint totals before switching.

### Research a home warranty

Identify warranty providers and read their profiles, complaints, and reviews to prepare questions about repairs, service delays, and dispute handling.

### Refresh a personal contractor shortlist

Revisit matching businesses and their profiles before making a final choice, checking for changed grades, accreditation details, or alerts.

## Overview

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

## BBB business search in other agents

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

## More Windsurf guides

- [BBB business profile](https://spiral.ai/integrations/windsurf/bbb-business-profile)
- [BBB customer reviews](https://spiral.ai/integrations/windsurf/bbb-customer-reviews)
- [BBB business link lookup](https://spiral.ai/integrations/windsurf/bbb-business-link-lookup)
- [Ballotpedia address coordinates](https://spiral.ai/integrations/windsurf/ballotpedia-address-coordinates)
- [BBB business complaints](https://spiral.ai/integrations/windsurf/bbb-business-complaints)
- [Ballotpedia ballot measure details](https://spiral.ai/integrations/windsurf/ballotpedia-ballot-measure-details)

## Questions about BBB business search in Windsurf

**Can Windsurf use BBB business search?**

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

**How much does BBB business search cost in Windsurf?**

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

**Do I need an Alexandria account to use BBB business search in Windsurf?**

No. Spiral runs BBB 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 BBB business search in Windsurf?**

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

**Does Windsurf wait while BBB business search runs?**

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

**Which businesses can these endpoints cover?**

The endpoints cover BBB records in the United States and Canada. BBB publishes profiles for both accredited and non-accredited businesses.

**How fresh is a BBB rating?**

BBB says ratings update automatically as new information reaches it. The update trigger is new information, rather than a stated daily or weekly publication schedule.

**How much complaint history does BBB publish?**

BBB says complaints appear on profiles for three years from filing. For businesses with many complaints, it may publish only a representative sample of complaint text and disclose the percentage shown.

**Does a BBB letter grade include customer review stars?**

Customer reviews do not enter BBB's letter-grade calculation. Keep the customer star average separate from the business's BBB grade.

**Does BBB guarantee that customer reviews are accurate?**

BBB verifies marketplace interactions before publication, but says it cannot guarantee any individual review's accuracy or truthfulness.

