[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [BidNet Direct bid categories](https://spiral.ai/integrations/windsurf/bidnet-direct-bid-categories)

# How to Use BidNet Direct bid categories in Windsurf

Returns the category directory with live open-bid counts. Use it to compare sectors before researching individual procurement notices.

|  |  |
| --- | --- |
| Model | BidNet Direct bid categories |
| 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 BidNet Direct bid categories in Windsurf

- Use BidNet Direct bid categories to create a project report comparing returned open-bid counts for construction and utilities. Include the category labels exactly as returned.
- Use BidNet Direct bid categories to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from BidNet Direct bid categories and tell me what changed since last week.
- Check BidNet Direct bid categories and summarize what you find in three bullet points.
- Pull the newest data from BidNet Direct bid categories and give me the result as a table.

## How to set up BidNet Direct bid categories 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 BidNet Direct bid categories**: 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": "bidnetdirect-com/public-tenders/list_categories",
    "input": {}
  }'
```

Then paste one of the prompts above: Windsurf finds BidNet Direct bid categories on Spiral, shows the price and runs it.

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

## BidNet Direct bid categories tools and prices

- [BidNet Direct · List categories](https://spiral.ai/tools/alexandria/bidnetdirect-com/public-tenders/list_categories) (Alexandria): $0.00873 per call.

## What can you do with BidNet Direct bid categories in Windsurf?

Build a procurement research report that combines BidNet Direct's market counts, participating buyers, and selected notices. Your coding agent can add the returned data to project files while preserving the 25-row search limit and first-page agency boundary.

### Choose a new sales territory

Compare location and sector counts, identify buyers in the returned agency directory, and inspect relevant notices before choosing where to expand government sales.

### Research demand for a new service

For an offering such as water-system maintenance, compare category and location counts, identify prospective public buyers, and read matching notices to assess the work being requested.

### Prepare an education procurement brief

Find school districts or universities in the returned agency list, compare geographic and sector activity, and assemble relevant notices with public dates and available scope details.

### Build a closed-bid research file

Use the directories to define a market and identify buyers, then search closed notices and read available scope and classifications. Compare past requirements with current category and location activity.

### Compare current procurement activity

Track open-bid counts by category and location to decide which markets deserve a closer search. Describe the comparison as activity on BidNet Direct rather than total government demand.

## Overview

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

## BidNet Direct bid categories in other agents

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

## More Windsurf guides

- [Alberta legislation text](https://spiral.ai/integrations/windsurf/alberta-legislation-text)
- [BidNet Direct bid locations](https://spiral.ai/integrations/windsurf/bidnet-direct-bid-locations)
- [Alberta legislation search](https://spiral.ai/integrations/windsurf/alberta-legislation-search)
- [BidNet Direct participating agencies](https://spiral.ai/integrations/windsurf/bidnet-direct-participating-agencies)
- [Alberta Gazette issue text](https://spiral.ai/integrations/windsurf/alberta-gazette-issue-text)
- [BidNet Direct solicitation details](https://spiral.ai/integrations/windsurf/bidnet-direct-solicitation-details)

## Questions about BidNet Direct bid categories in Windsurf

**Can Windsurf use BidNet Direct bid categories?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run BidNet Direct bid categories like any built-in tool.

**How much does BidNet Direct bid categories cost in Windsurf?**

$0.00873 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 BidNet Direct bid categories in Windsurf?**

No. Spiral runs BidNet Direct bid categories on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up BidNet Direct bid categories in Windsurf?**

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

**Does Windsurf wait while BidNet Direct bid categories runs?**

BidNet Direct bid categories runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**Where does BidNet Direct get its procurement notices?**

Participating state and local agencies publish notices directly through BidNet Direct. Its statewide coverage also aggregates notices from websites, newspapers, and other sources across each state.

**How much of a solicitation is public?**

The documented public coverage limits open bid details to title, location, and dates. Closed BidNet-hosted solicitations can expose the full public notice, including NIGP or NAICS classifications.

**How many notices does a search return?**

Search returns 25 rows per page and covers both open and closed bids. A first-page shortlist can therefore omit additional matching notices.

**Is the participating-agency directory complete?**

The agency lookup returns only the first page of a purchasing group's participating agencies. It does not establish that an unlisted buyer is absent from BidNet Direct.

**What freshness does BidNet Direct document?**

The location and category directories expose live open-bid counts. For education procurement, BidNet Direct separately says thousands of additional school districts and universities are monitored daily for new opportunities.

