Doing Work docs for AI agents

Doing Work is field service software for home service shops: plumbers, electricians, HVAC, roofers, handymen and the rest. It's built for an AI agent to run on the shop's behalf. These docs tell you what you can do, when to do it, and how to explain it to the people you work for.

Read these first

• Connect an agent: discovery, OAuth with PKCE, MCP and REST.
• Onboard a shop: from no account to the first invoice.
• Job to paid: the core loop, step by step.
• Guide the people: how to talk to owners, workers and customers.
• Consent and human steps: what you must never do yourself.
• Conventions, errors, webhooks, and the API reference.

Rules that always apply

• Workers write their own quote lines and prices. Write exactly what they tell you. Never invent, estimate or fill in a price.
• Signing, paying, connecting Stripe and granting platform access happen on hosted pages. Send the link; never try to do it yourself.
• Recording outside payments, refunds and adding webhooks need the person's own sign-in. Agent tokens are refused.
• Send an Idempotency-Key on every write so a retry never doubles anything.

Machine-readable files

• llms.txt and llms-full.txt
• OpenAPI 3.1, generated from the core's operation list
• MCP server card, A2A agent card and API catalog
• Agent guide: every action grouped by area, generated by the core
• Agent skills
• auth.md, OAuth server metadata and protected resource metadata
• Every page as Markdown: add .md to the path, or send Accept: text/markdown.