Help and API

Walkthru is a punch list app for home builders, remodelers and general contractors. This page covers the app, connecting an AI assistant (MCP), and the REST API. It's written to be readable by people and by AI agents.

Quick start

1. Open walkthru.build/app on your phone and create an account with your email and a password (or Google). Every account starts with 14 days of Pro, no card.
2. Create your company and paste your website. Walkthru pulls your logo, brand color, phone and email and puts them on everything your subs see. Adjust under Settings → Brand.
3. Import your subs: Subs → Import, from Excel/CSV, a .vcf contacts file, your phone's contacts, or a pasted list. Duplicates are merged. Or just type a sub's name on an item and it's created.
4. Add teammates by email under Settings → Team; they sign in with that email and see everything.
5. Tap New job, name the house, and start walking. Tap +: pick the room, tap the trade, tap a common item or type a few words, Add. Room and trade stick between items. The first time you pick a trade it asks who does it; after that items are assigned automatically.
6. No signal? Keep going. Items, photos and check-offs save on the phone and sync on their own when you're back in range. The top of the screen says "Offline · N saved on phone" until they're up.
7. Say it. Tap the mic and say "kitchen, paint, touch up above the door": Walkthru sets the room and trade and fills in the item. Check it, tap Add.
8. Tap the share icon. Each sub with a phone or email gets a Text / Email button that sends them a read-only link to their open items with photos. No account needed on their end.
9. The sub taps Mark fixed on each item. You see "Sub says fixed" on the item and "ready to check" on the job, confirm it on your re-walk, and tap the circle to close it.
10. On iPhone: Share → Add to Home Screen for a full-screen app with camera access.

Concepts

Connect an AI assistant (MCP)

Walkthru runs an MCP server with the Streamable HTTP transport. Any MCP client can read and write your punch lists. This is the fastest way to log a walkthrough: dictate it, the assistant files the items.

Endpoint: https://walkthru.build/mcp
Auth: an API key from Settings → Connect AI, sent as Authorization: Bearer wt_live_…. Clients that can't send headers can append the key to the URL: https://walkthru.build/mcp/wt_live_….

Claude (claude.ai, desktop, mobile)

1. Settings → Connectors → Add custom connector.
2. Name: Walkthru. URL: https://walkthru.build/mcp/wt_live_YOURKEY.
3. Save. In any chat, enable the Walkthru connector and ask: "List my jobs."

Claude Code

claude mcp add --transport http walkthru https://walkthru.build/mcp \
  --header "Authorization: Bearer wt_live_YOURKEY"

ChatGPT

Settings → Connectors → create a custom connector with the MCP URL https://walkthru.build/mcp/wt_live_YOURKEY (available on plans that support custom MCP connectors). Alternatively, build a Custom GPT with Actions and import /openapi.json, using API-key auth with the Authorization header value Bearer wt_live_YOURKEY.

Cursor, Windsurf, VS Code and other MCP clients

{
  "mcpServers": {
    "walkthru": {
      "url": "https://walkthru.build/mcp",
      "headers": { "Authorization": "Bearer wt_live_YOURKEY" }
    }
  }
}

Things to say once connected

• "Add to the Denmark job, kitchen, painter: touch up above the door casing, nail holes at the crown, and the drip on the island side panel."
• "What's still open for the tile sub on Smith?"
• "Where are we on the Harper job?" → counts by sub and room, oldest open item.
• "Mark the first three done."
• "Give me the painter's link for Denmark." → a share URL you can text.

MCP tools

Tool results include both a readable text block and structuredContent JSON. GET https://walkthru.build/mcp returns a server card.

REST API

Base URL https://walkthru.build/api/v1. JSON in, JSON out. Authenticate with Authorization: Bearer wt_live_… (or X-Api-Key). CORS is open, so it works from browsers, Zapier, Make and n8n. Ids are opaque strings; keep them.

curl https://walkthru.build/api/v1/projects \
  -H "Authorization: Bearer wt_live_YOURKEY"

curl -X POST https://walkthru.build/api/v1/projects/PID/items \
  -H "Authorization: Bearer wt_live_YOURKEY" -H "Content-Type: application/json" \
  -d '{"title":"Caulk tub deck","room":"Primary Bath","sub":"Tile","priority":"high"}'

Errors are {error: "message"} with a 4xx/5xx status. A 402 includes upgrade. Machine-readable spec: /openapi.json. Summary for agents: /llms.txt.

Share links

Every job has a stable share link; ?sub=Name filters to that sub. The page carries your logo and brand color, shows open items grouped by room with photos, and lets the sub tap Mark fixed (public endpoint POST /api/share/:token/items/:iid/fixed). It refreshes on reload. It doesn't require sign-in, so don't post it publicly. The link is the same for the life of the job.

Team & plans

Everyone you add shares one company. The owner (whoever created the company) can rename it and remove members; everyone can add members, jobs, items and subs.

Every new company starts with a 14-day Pro trial (30 days if another builder referred you). Free: 1 active job, unlimited items, photos, subs, members, API and MCP. Pro ($39/month or $390/year per company): unlimited jobs. Adding a teammate gives you an invite link to text them; it works once, for 14 days. Settings → Give a month, get a month has your referral link: when a builder you sent goes Pro, you get a free month. Upgrade in Settings; billing is handled by Stripe and you can cancel anytime from the same place. Archiving a job frees up your active slot on Free.

Data & privacy

Data is stored on Netlify's infrastructure in the US. Photos are resized on your phone before upload (max 1600 px). Your company's data is yours: pull everything through the API at any time. We don't sell data and we don't train models on it. Full privacy policy and terms.

Support

Email help@walkthru.build. Built in Nashville, Tennessee by a working home building project manager.