Skip to main content
Glama
README.md
# Northbid

Search Government of Canada procurement data from your AI assistant. Northbid is a local [Model Context Protocol](https://modelcontextprotocol.io) server that loads the open data published by [CanadaBuys](https://canadabuys.canada.ca/en/procurement-and-contracting-data) into a small database on your computer and gives the assistant tools to search it, in English or French.

It works with Claude Code and Cowork, Codex and the ChatGPT desktop app, Gemini CLI, and any other client that can run a local MCP server. It is free, needs no account, and has no dependencies beyond Node.js.

> **Unofficial.** Northbid is not affiliated with or endorsed by the Government of Canada, CanadaBuys or Public Services and Procurement Canada. The CanadaBuys website is the authoritative source; confirm every detail there before you bid.

## What you can ask

- "Find open federal tenders for translation services I could deliver in Ontario."
- "What IT security opportunities close in the next three weeks? Show the selection criteria for the top three."
- "Quels appels d'offres fédéraux sont ouverts pour des travaux de construction au Québec ?"
- "Which suppliers hold standing offers for light duty vehicles, and when do they expire?"

## What it covers

| Dataset | Records | Source refresh |
|---|---|---|
| Open tender notices | about 950 | daily, plus new notices every 2 hours |
| Active standing offers and supply arrangements | about 4,000 agreements | weekly |

Federal organizations only. Awards, contract history, closed tenders and the 2009–2022 archives are on the [roadmap](#roadmap). See [docs/data.md](docs/data.md) for the schema and known quirks.

## Requirements

Node.js **22.16 or newer** (24 or newer recommended). Check with `node --version`. Node 23 is not supported because its built-in SQLite lacks full-text search.

## Install

### Claude Code and Cowork

```
/plugin marketplace add hexacron/northbid
/plugin install northbid@northbid
```

The plugin adds the server and a `find-opportunities` skill. Local MCP servers do not run in claude.ai chat on the web; there you get the skill only.

### Codex and the ChatGPT desktop app

```bash
git clone https://github.com/hexacron/northbid.git
codex mcp add northbid -- node /absolute/path/to/northbid/server/index.js
```

Codex and the ChatGPT desktop app share this configuration.

### Gemini CLI

```bash
gemini extensions install https://github.com/hexacron/northbid
```

### Any other MCP client

Clone the repository and register a stdio server that runs `node /absolute/path/to/northbid/server/index.js`. [docs/clients.md](docs/clients.md) has the configuration for each client and notes on what has been tested.

## Tools

| Tool | What it does |
|---|---|
| `search_tenders` | Search open tenders by keyword, buyer, category, UNSPSC code, delivery region and dates |
| `get_tender` | Full record for one tender: description, criteria, trade agreements, contact, attachments |
| `search_standing_offers` | Search standing offers and supply arrangements by keyword, supplier, department, commodity |
| `data_status` | Show what is loaded and how current it is |
| `refresh_data` | Check CanadaBuys for newer files now |

Search matches English and French text at once and ignores accents. Full parameters and sample output are in [docs/tools.md](docs/tools.md).

## What it does on your computer

- **Downloads** three CSV files from `canadabuys.canada.ca` and `sosa.canadabuys.canada.ca`, about 10 MB in total, on first use, then re-checks them on a schedule and downloads only what changed. One of those hosts serves an incomplete certificate chain, so the missing issuer certificate is fetched from the address named in the certificate (currently `crt.sectigo.com`) and verified against Node's trusted roots.
- **Stores** the data in one SQLite file in the plugin's data directory, or your operating system's cache directory when run outside Claude. Deleting the file is safe; it is rebuilt on next use.
- **Sends nothing else.** Your searches and conversations stay on your machine. There is no telemetry and no account. See [PRIVACY.md](PRIVACY.md).

Settings, all optional environment variables:

| Variable | Effect |
|---|---|
| `NORTHBID_DATA_DIR` | Where to keep the database |
| `NORTHBID_OFFLINE=1` | Never contact the network; use the data already downloaded |

## Troubleshooting

- **"northbid needs Node.js 22.16 or newer"**: the `node` on your PATH is too old, or is a 23.x release. Install a current LTS release.
- **"Could not download …"**: the source site was unreachable. Searches keep working on the last downloaded data and say so in a `warnings` field. Ask the assistant to run `refresh_data` to retry.
- **A tender is missing**: new notices can take up to a day to reach the open data files. Check `data_status` for the data date.
- **Something else**: [open an issue](https://github.com/hexacron/northbid/issues).

## Roadmap

1. Award notices and contract history, with supplier and buyer profiles.
2. Aggregations, a read-only SQL tool, and optional download of the full history back to 2009.
3. Proactive disclosure of contracts over $10,000 from all departments.

## Documentation

- [docs/clients.md](docs/clients.md): setup for each client
- [docs/tools.md](docs/tools.md): tool reference
- [docs/data.md](docs/data.md): datasets, schema and caveats
- [docs/architecture.md](docs/architecture.md): how it is built
- [CONTRIBUTING.md](CONTRIBUTING.md): development and tests

## Licence and attribution

Code is released under the [MIT licence](LICENSE).

Contains information licensed under the [Open Government Licence – Canada](https://open.canada.ca/en/open-government-licence-canada). The data is published by Public Services and Procurement Canada through CanadaBuys.