forms

Name: forms
Author: tstuckle

Canadian contractor forms + tax tools: 126 cited forms, sourced 2026 tax estimates by province.

tstuckle0 stars0 forksAI & Agents

View source

Install

mcp_config.json

{
  "mcpServers": {
    "ca-bluecraneworks-forms": {
      "url": "https://mcp.bluecraneworks.ca/mcp",
      "type": "streamable-http"
    }
  }
}

Documentation

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.

Sourced from the repository README.

Search DevTools