Machine-readable booking

Book via agent

Third-party agents can book Boulder County Dryer Vent services over MCP. This page is for software that requests a visit on behalf of a homeowner.

Third-party agents can book Boulder County Dryer Vent services over MCP on behalf of a homeowner. This is an operations note, not a second booking funnel. Homeowners should keep using the normal Book flow or call (866) 494-6590.

MCP endpoint

HTTPS: https://keeps-pty-ultimately-payroll.trycloudflare.com/mcp

The hostname above is a temporary tunnel and may rotate. The stable path is /mcp on the same public ops host as book ingest. Operators publish the current URL when the tunnel changes. Primary customer booking remains the Book flow on this site.

Human book URL: https://bouldercountydryervent.com/
Phone: (866) 494-6590

Tools

Tool	Access	Notes
`list_services`	Public	Fixed prices: standard $129, difficult $169. Boulder County service area.
`check_availability`	Public	Stub: request a preferred 2-hour window. We confirm within 1 business day.
`create_booking`	Bearer token	Fields aligned with the web Book flow: `name`, `phone`, `email`, `street`, `town`, `service` (`standard` or `difficult`), `preferred_windows`, `sms_consent`. Optional honeypot `company_website` must be empty.
`get_booking_status`	Bearer token	Lookup by `public_id` (for example `BCDV-YYYY-NNNN`). The response does not include personal details.

Auth

Protected tools accept Authorization: Bearer <token> or X-BCDV-Agent-Token. Tokens are not published here. Request a booking token from ava@frostrivercapital.com with your agent name and intended use.

Example

Public JSON-RPC over HTTPS. initialize, then tools/call for list_services (no token):

curl -sS -X POST 'https://keeps-pty-ultimately-payroll.trycloudflare.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"example-agent","version":"0.1.0"}}}'

curl -sS -X POST 'https://keeps-pty-ultimately-payroll.trycloudflare.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_services","arguments":{}}}'

Non-goals

Payments are not in MCP. Nothing is charged to hold a time; payment is after the visit.
A booking created this way is still a request. A person confirms the window by text or email.
Lead time is typically 3–4 business days or more.

Book on the website if you are scheduling for yourself.