# BC FOI Agent Toolplane
> Structured index of published British Columbia provincial FOI packages.
> Not the official Open Information catalogue. Always cite request_id + catalogue URL.
> Licence: statistics OGL-BC; packages are Crown records under Open Information directives.

This service is for AI agents. Humans should use https://www2.gov.bc.ca open information.

## What you can do
- Corpus census including Do Not Publish counts (GET https://foi.itsthesheet.ca/v1/stats) — free
- Metadata catalogue page / export (GET https://foi.itsthesheet.ca/v1/releases , GET https://foi.itsthesheet.ca/v1/releases/export)
- Search released FOI text, tables, and OCR (POST https://foi.itsthesheet.ca/v1/search_releases)
- Fetch one request (GET https://foi.itsthesheet.ca/v1/releases/{request_id}) — DNP returns metadata + empty files, never 404
- Parcel / PID / address lookup for bc.itsthesheet.ca (GET https://foi.itsthesheet.ca/v1/related_to_place?pid=)
- Format a citation (GET https://foi.itsthesheet.ca/v1/cite?request_id=)

## Machine endpoints
- [OpenAPI](https://foi.itsthesheet.ca/openapi.json)
- [HTTP MCP](https://foi.itsthesheet.ca/mcp)
- [MCP server card](https://foi.itsthesheet.ca/.well-known/mcp/server-card.json)
- [Agent catalog](https://foi.itsthesheet.ca/.well-known/ai-catalog.json)
- [Health](https://foi.itsthesheet.ca/v1/health)

## Payments
x402 USDC (Base first, Solana second) on search, catalogue list/export, get_release, and related_to_place.
Health, cite, and /v1/stats stay free. Originals stay in a private Spaces bucket.

## Publication status
DNP / Not in Scope rows are first-class catalogue objects (status, request wording, URL).
get_release on DNP: HTTP 200, package_available=false, files=[]. We do not store those packages.
Quote tokens in search (example: "HIFIS") to reduce OCR false-friends.

## Do not
- Treat this as gov.bc.ca
- Omit request_id / catalogue URL in answers
- Ask for Personal / Do Not Publish package bytes (we do not store those)