[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [PennBid open bids](https://spiral.ai/integrations/opencode/pennbid-open-bids)

# How to Use PennBid open bids in opencode

Returns public opportunities currently open on PennBid, with project names, agency references, closing times, and listing links. Use it to find solicitations to review before their deadlines.

|  |  |
| --- | --- |
| Model | PennBid open bids |
| 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 PennBid open bids in opencode

- Use PennBid open bids to find sewer solicitations and add a table to this project's procurement page with project names, agency references, closing times, and source links.
- Use PennBid open bids to find paving solicitations and update our existing dashboard to sort the returned records by closing time.
- Use PennBid open bids to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from PennBid open bids and tell me what changed since last week.
- Check PennBid open bids and summarize what you find in three bullet points.

## How to set up PennBid open bids 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 PennBid open bids**: 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": "pennbid-bonfirehub-com/public-tenders/list_open_opportunities",
    "input": {
      "q": "<q>"
    }
  }'
```

Then paste one of the prompts above: opencode finds PennBid open bids on Spiral, shows the price and runs it.

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

## PennBid open bids tools and prices

- [PennBid (Bonfire) public procurement portal · List open opportunities](https://spiral.ai/tools/alexandria/pennbid-bonfirehub-com/public-tenders/list_open_opportunities) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| q |  | — | Case-insensitive substring matched against the project name and the reference (awarding agency / county) text. |
| limit | 1 to 200 | 50 | Page size applied locally (default 50). |
| offset | 0 to … | 0 | Zero-based position in the filtered, sorted list; pass `next_offset` from the previous page. |
| closing_to |  | — | Keep opportunities closing at or before this UTC instant. A date alone means the end of that day (23:59:59Z). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}:[0-9]{2}Z)?$. |
| closing_from |  | — | Keep opportunities closing at or after this UTC instant. A date alone means the start of that day (00:00:00Z). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(T[0-9]{2}:[0-9]{2}:[0-9]{2}Z)?$. |

## What can you do with PennBid open bids in opencode?

Build a procurement view that combines PennBid project names, agency references, closing times, and public-award flags. A coding agent can add open-bid searches, past-bid research, and individual listing checks to the project's existing interface.

### Prepare an agency procurement brief

Combine an agency's open solicitations with its past listings, then check selected projects individually. Give the team a dated list of current work and previous procurement activity.

### Research recurring purchases

Compare current and previous listings for work such as paving, sewer replacement, or treatment chemicals. Check individual records before describing similar titles as repeat purchases.

### Investigate possible rebids

Compare open project names with closed solicitations from the same agency. Review the corresponding listing records to build a shortlist of possible rebids for a procurement analyst.

### Map a contractor's local market

Build a county-level view of current and past public solicitations in a contractor's trade. Use agency references, project names, closing dates, and individual listing checks to organize the research.

### Prioritize upcoming deadlines

Find open solicitations relevant to an estimating team and order them by closing time. Check shortlisted records before assigning staff to review the source documents.

## Overview

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

## PennBid open bids in other agents

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

## More opencode guides

- [PNCP tender search](https://spiral.ai/integrations/opencode/pncp-tender-search)
- [PennBid opportunity lookup](https://spiral.ai/integrations/opencode/pennbid-opportunity-lookup)
- [PNCP tender details](https://spiral.ai/integrations/opencode/pncp-tender-details)
- [PennBid past bids](https://spiral.ai/integrations/opencode/pennbid-past-bids)
- [OregonBuys open bids](https://spiral.ai/integrations/opencode/oregonbuys-open-bids)
- [Public Purchase agency directory](https://spiral.ai/integrations/opencode/public-purchase-agency-directory)

## Questions about PennBid open bids in opencode

**Can opencode use PennBid open bids?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run PennBid open bids like any built-in tool.

**How much does PennBid open bids 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 PennBid open bids in opencode?**

No. Spiral runs PennBid open bids on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up PennBid open bids in opencode?**

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

**Does opencode wait while PennBid open bids runs?**

PennBid open bids runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does PennBid cover only Pennsylvania?**

PennBid's current service-area page lists Delaware, Maryland, New York, Ohio, and Pennsylvania. These tools cover public listings on PennBid's Bonfire portal, without establishing complete procurement coverage for those states.

**Do these records include the full bid documents?**

The data provider reads listing records and explicitly excludes the opportunity detail page. PennBid places supporting documents and requested submission information on that separate details screen.

**When does an opportunity become closed?**

PennBid automatically closes the bidding period when the project's due date and time pass. Closing ends the period in which bidders can submit or alter their submissions.

**How soon after closing are bid results public?**

PennBid leaves the timing and content of public bid results to the agency manager. There is no single publication schedule that applies to every closed solicitation.

**Does a missing public award mean the project was never awarded?**

PennBid's awarding guide tells agencies to select Post Award Statement Publicly to publish an award statement. A listing without a public award therefore does not prove that the agency made no award.

