bluecrane-forms-mcp

# Blue Crane Forms MCP Server

A remote [Model Context Protocol](https://modelcontextprotocol.io) server
exposing **115 Canadian contractor forms** — Ontario, Alberta, and BC
statutory worksheets plus Canada-wide site paperwork — with regulatory
citations verified against the governing acts.

**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) |

Every form is free to fill and print at
[bluecraneworks.ca/tools](https://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](https://bluecraneworks.ca/.well-known/mcp/server-card.json).

## Try it raw

```bash
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 is
  © Blue Crane Works Inc. and ships with the hosted server.

Built by [Blue Crane Works](https://bluecraneworks.ca) — job-site software
for Canadian trades. Hamilton, Ontario.