Skip to main content
Glama
tstuckle

Blue Crane Forms & Tax MCP Server

by tstuckle

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.

Related MCP server: Construction Cost Calculator MCP

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.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides construction cost estimation tools using data from a public Google Sheet for items like concrete, framing, and electrical. It allows users to search items, filter by category, and calculate total project costs including labor and material expenses.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents and procurement systems to verify contractor licenses against official state boards, search contractors by trade and location, audit workers' comp, surety bonds and OSHA safety records, and check SAM.gov federal debarment status. It returns a deterministic ALLOW/WARN/BLOCK compliance decision plus registry health metrics for US trade contractors.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 1099 gig workers and freelancers to calculate 2026 quarterly federal estimates, self-employment tax, safe-harbor minimum payments, and mileage or actual-expense deductions, including the mid-year business mileage rate change from 72.5 to 76 cents. It also compares standard mileage against actual vehicle costs and exposes every tax constant with its source.
    MIT