Blue Crane Forms & Tax MCP Server
To our knowledge, the first MCP server built for Canadian contractor compliance — and the first anywhere to combine contractor paperwork with provincial trades tax math in one agent toolkit. Built by Blue Crane Works, Hamilton, Ontario.
A remote Model Context Protocol server exposing 126 Canadian contractor forms — Ontario, Alberta, BC, Saskatchewan, and Manitoba statutory worksheets plus Canada-wide site paperwork — with regulatory citations verified against the governing acts, plus 2026 contractor tax estimates by province running the sourced math from tradestaxcalculator.ca.
Hosted endpoint (no auth, no keys):
https://mcp.bluecraneworks.ca/mcp
Transport: MCP Streamable HTTP (JSON-RPC 2.0), stateless. Built as a single-file Cloudflare Worker with zero dependencies.
Tools
| Tool | What it does |
|---|---|
search_forms | Search by keyword, form number, or alias (FLHA, form 1.2, hot work, tailgate) |
get_form | Full details for one form: fields, citation, free fill-and-print link |
which_form_do_i_need | Plain-language situations ("my GC hasn't paid my invoice") → matching forms |
list_categories | Browse the catalog (WSIB & incidents, site safety, vehicles, finance, Alberta, BC…) |
get_form_maker_pass | Pricing for the optional Form Maker Pass (clean prints + autofill) |
estimate_contractor_tax | 2026 income tax + CPP + take-home for a sole-proprietor trade, by province (12 jurisdictions, no Quebec) |
required_hourly_rate | Work backwards from target take-home to the hourly rate you must bill |
hst_quick_method | CRA Quick Method vs regular HST for Ontario contractors, with break-even |
Tax responses carry a dated-source disclaimer — planning estimates, not tax advice. Every form is free to fill and print at bluecraneworks.ca/tools — the server always returns the free link.
Connect it
Claude: Settings → Connectors → Add custom connector →
https://mcp.bluecraneworks.ca/mcp
Any MCP client: point a Streamable HTTP transport at the endpoint. Discovery: server card.
Clients that can only launch a local server
The endpoint above is the real server and pointing a client at it directly is
always the better route. For stdio-only clients, the included Dockerfile
bridges stdin and stdout to the hosted endpoint with
mcp-remote, so the tools it exposes
are the live ones rather than a copy that can drift:
docker build -t bluecrane-forms-mcp .
docker run -i --rm bluecrane-forms-mcp
Verified against the live server: initialize returns bluecrane-forms 1.1.0
and tools/list returns all eight tools.
Try it raw
curl -X POST https://mcp.bluecraneworks.ca/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"which_form_do_i_need","arguments":{"situation":"crew doing welding tomorrow"}}}'
Notes
- The forms are preparation worksheets and on-site records — Blue Crane does not file anything with any ministry or regulator.
- Statutory citations are kept at the level verified against the source regulation; guidance is not legal advice.
- This repo contains the server code. The form compendium data and the
sourced tax dataset are © Blue Crane Works Inc. and ship with the hosted
server (registry:
ca.bluecraneworks/forms, v1.1.0).
Built by Blue Crane Works — job-site software for Canadian trades. Hamilton, Ontario.