# The Decksmith API & agent resources

Public machine-readable surfaces for **The Decksmith**. Licence 272840C.

## What is available

OpenAPI documents Consultation lead intake. Browser forms keep 303 redirects; agents prefer JSON.
- OpenAPI: /openapi.json /openapi.yaml /api/openapi.json
- Consultation lead: POST/GET /api/lead
- MCP: /.well-known/mcp.json and POST /mcp
- llms.txt; CLI see cli.md (thedecksmith-cli staged)

## JSON vs form
- Browser forms: 303 /thanks/ or /contact/
- JSON clients: 200/400 JSON
- GET /api/lead returns status ok
- Fields name_1 email_1 required; botcheck honeypot; no CRM secrets in docs

## MCP tools
get_business_info, list_public_endpoints, submit_consultation_lead

## Voice
Brand The Decksmith. Consultation — never price-fishing language. Licence 272840C. Not a licensed builder; no Class 2 head-contract.