Blueprint MCP server reference
- Endpoint
- https://blueprinthome.app/mcp
- Transport
- Streamable HTTP, stateless, JSON responses
- Sign-in
- OAuth 2.1 with PKCE and dynamic client registration; needed only for home-record tools
- Scopes
- blueprint:read, blueprint:write (changes are opt-in at consent)
- Discovery
- /.well-known/oauth-protected-resource/mcp
- Scope of a connection
- one home, chosen at sign-in
Without an account (6)
- search_diy_guides
- Searches the public DIY Project library and returns up to 10 guides, each with a one-line summary and a link.
- get_diy_cost
- Returns a worked example: materials by line, the DIY total, the hired-out range when modelled, and the assumptions.
- estimate_materials
- Pass calculator fields as strings; call once without measurements to get the field names and the defaults used.
- check_diy_job
- Finds the closest job in the DIY Project checker and returns a verdict (DIY, careful DIY, call a pro, or emergency) with reasons, steps and the safety questions still worth asking.
- get_seasonal_checklist
- Returns the season's tasks with why each matters and a link to the guide, plus climate-specific tasks when a climate is given (hot-climate: Zones 1 and 2; mixed-climate: Zones 3 and 4; cold-climate: Zones 5 and 6;.
- report_feedback
- Reports the problem to the server's developers.
Read the home record (30)
- get_home_record
- Not for changes: each kind of record has its own add, update and remove tools.
- get_property
- For value, taxes and sale history use get_home_facts; for insurance use get_insurance.
- get_home_facts
- Returns those public-record facts plus the automated value estimate history, equity and completed project spending.
- list_rooms
- Returns each room with its type, size and appliance count, plus any measured floor plans (floor area, wall area, doors, windows) with their measured_room_id.
- get_emergency_info
- Returns the property's shutoffs and safety items with locations and instructions, the breaker directory by panel, and emergency contacts.
- list_paint_colors
- Returns each saved color with brand, code, finish, hex and where it is used.
- get_insurance
- Money is in cents.
- get_replacement_budget
- Returns a multi-year plan: each appliance's expected replacement year and cost, and totals by year.
- list_appliances
- Returns each one still in the home with its room, brand and model.
- get_appliance
- Shows an appliance card; do not repeat its contents.
- get_manual_excerpt
- Returns the passages that match the question.
- list_recalls
- Returns the open recalls matched to the home's appliances, each with the hazard, the remedy and a recall_id for resolve_recall.
- get_maintenance_suggestions
- Returns Blueprint's suggested tasks for it (pending, not on the calendar), each with how often and why.
- list_maintenance
- Returns tasks due in the next 90 days, overdue tasks, or recent completions, optionally narrowed to one property or appliance.
- get_maintenance_history
- Returns that task's completions, skips and misses, newest first.
- get_calendar
- Returns items between from and to (to is exclusive, at most 62 days), with the ids the edit tools take.
- list_seasonal_suggestions
- Returns at most one suggested checklist per property, with each task's key for accept_seasonal_suggestions.
- list_projects
- Returns projects with status, progress and cost.
- get_project
- Returns its details, steps, expenses, quotes, measurements, tools, supplies and recent comments, with the ids the project write tools take.
- compare_quotes
- Returns each quote side by side: scope missing from each, price outliers against the median, and each total against the estimate.
- list_project_photos
- Returns each photo's note, stage, date and a link to open it.
- search_records
- Returns matching records with their type and id.
- list_documents
- Returns up to 50 with their dates, filterable by category, property or an expiry window.
- get_document
- Returns its title, category, property, dates, notes and file details.
- list_inspection_reports
- Returns each report on file with how many of its suggested tasks are still waiting for review in Blueprint.
- list_inventory
- Returns tools and supplies with quantities, low-stock flags and costs.
- list_contacts
- Returns each with trade, phone, email, website, rating and emergency availability.
- list_utility_bills
- Returns up to 36 bills, newest first, with provider, billing period, usage, usage per day and cost, flagging any with unusually high usage.
- list_wishlist
- Returns items by priority with their retailer links and prices (link ids are needed to remove a link).
- list_receipts
- Returns up to 50, newest first, with store, date, total, project and how many lines are already in a budget.
Changes (blueprint:write) (95)
Each change is held in Blueprint for the user to confirm unless they let the connection write directly.
- update_propertyasks before changing or removing
- Only the fields sent change.
- add_room
- Confirm the details with the user first.
- update_roomasks before changing or removing
- Only the fields sent change.
- remove_roomasks before changing or removing
- Its appliances are deleted with it; to keep them, move them first with update_appliance.
- add_room_measurements
- Confirm the details with the user first.
- update_room_measurementsasks before changing or removing
- Only manually measured rooms can be re-measured.
- remove_room_measurementsasks before changing or removing
- The room itself stays.
- add_emergency_item
- Confirm the details with the user first.
- update_emergency_itemasks before changing or removing
- Get the item id from get_emergency_info.
- remove_emergency_itemasks before changing or removing
- Get the item id from get_emergency_info.
- add_breaker_circuit
- Confirm the details with the user first.
- update_breaker_circuitasks before changing or removing
- Get the breaker id from get_emergency_info.
- remove_breaker_circuitasks before changing or removing
- Get the breaker id from get_emergency_info.
- add_paint_color
- Confirm the details with the user first.
- update_paint_colorasks before changing or removing
- Get the id from list_paint_colors.
- remove_paint_colorasks before changing or removing
- Get the id from list_paint_colors.
- update_insurance_policyasks before changing or removing
- Only the fields sent change.
- add_insurance_claim
- Confirm the details with the user first.
- update_insurance_claimasks before changing or removing
- Get the claim id from get_insurance.
- remove_insurance_claimasks before changing or removing
- Get the claim id from get_insurance.
- add_appliance
- Confirm the details first.
- update_applianceasks before changing or removing
- Only the fields sent change; money is in cents.
- remove_applianceasks before changing or removing
- To keep its history, prefer update_appliance with status RETIRED.
- add_appliance_part
- Confirm the details with the user first.
- update_appliance_partasks before changing or removing
- Get the part id from get_appliance.
- remove_appliance_partasks before changing or removing
- Get the part id from get_appliance.
- set_preferred_contractorasks before changing or removing
- Get the contact id from list_contacts.
- resolve_recallasks before changing or removing
- Get the recall_id from list_recalls.
- log_appliance_service
- For a scheduled maintenance task use complete_maintenance instead.
- remove_appliance_documentasks before changing or removing
- Get the document id from get_appliance.
- accept_maintenance_suggestions
- Get the ids from get_maintenance_suggestions.
- dismiss_maintenance_suggestionsasks before changing or removing
- Get the ids from get_maintenance_suggestions.
- schedule_maintenance
- Confirm the details first.
- complete_maintenance
- Confirm which task first.
- update_maintenance_taskasks before changing or removing
- Send only what changes; null clears a field.
- delete_maintenance_taskasks before changing or removing
- Confirm with the user first.
- skip_maintenance_occurrenceasks before changing or removing
- It stays in history as skipped.
- reschedule_maintenanceasks before changing or removing
- mode "following" moves every later occurrence of a repeating task too.
- accept_seasonal_suggestions
- Pass the property, season, year and the task keys from list_seasonal_suggestions; each becomes a yearly maintenance task.
- dismiss_seasonal_suggestionsasks before changing or removing
- It is hidden for that season and year.
- add_calendar_event
- start is YYYY-MM-DD for all day, or an ISO date-time with offset like 2026-11-20T09:00:00-05:00; end is optional (the last day for all day, else one hour later).
- update_calendar_eventasks before changing or removing
- Name it by event_id from get_calendar or its exact title.
- delete_calendar_eventasks before changing or removing
- Name it by event_id from get_calendar or its exact title.
- update_project_scheduleasks before changing or removing
- Dates are YYYY-MM-DD; null clears one; an omitted one is kept.
- create_project
- Confirm the name and description first.
- update_projectasks before changing or removing
- Change a project's details: name, description, notes, difficulty, priority, costs, target date, duration, privacy, completion, which tabs are on, capital-improvement flag, or property.
- remove_projectasks before changing or removing
- Confirm with them first.
- add_project_step
- Add a step to a project's plan, optionally scheduled on the calendar.
- update_project_stepasks before changing or removing
- Rename a step, move it on the calendar, assign it, or mark it done or not done.
- complete_project_step
- Mark a step done (or not done again).
- add_project_expense
- Record money spent on a project, optionally linked to a tool, supply or contact.
- update_project_expenseasks before changing or removing
- Change whether one expense counts as a capital improvement (it feeds the home's cost-basis report).
- remove_project_expenseasks before changing or removing
- Confirm first.
- add_quote
- Record a contractor's quote on a project, for an existing contact or a new one by name, optionally with its line items for leveling.
- update_quoteasks before changing or removing
- Change a quote's total, the date it is valid until, or its scope summary.
- remove_quoteasks before changing or removing
- Confirm first.
- add_quote_line_item
- Add one line (labor, materials, a fee, an exclusion) to a quote so it can be leveled against the others.
- update_quote_line_itemasks before changing or removing
- Change a quote line's description, category, quantity, prices, included flag, notes or position.
- remove_quote_line_itemasks before changing or removing
- Delete one line from a quote.
- add_project_measurement
- Record a measurement on a project (a wall, a window opening, a deck footprint) with its dimensions and unit.
- update_project_measurementasks before changing or removing
- Change a measurement's type, description, dimensions or unit.
- remove_project_measurementasks before changing or removing
- Delete one measurement from a project.
- add_project_supply
- Put a supply on a project's list, from the home's inventory by id or as a new supply by name, with how many are needed and whether it is required.
- update_project_supplyasks before changing or removing
- Change how many of a supply a project needs, or whether it is required.
- remove_project_supplyasks before changing or removing
- Take a supply off a project's list.
- add_project_tool
- Put a tool on a project's list, from the home's inventory by id or as a new tool by name, with how many are needed and whether it is required.
- update_project_toolasks before changing or removing
- Change how many of a tool a project needs, or whether it is required.
- remove_project_toolasks before changing or removing
- Take a tool off a project's list.
- update_project_photoasks before changing or removing
- Change a photo's note, stage (before, after, progress), its before-photo pairing, or when it was taken.
- remove_project_photoasks before changing or removing
- Delete a photo from a project's log.
- add_project_comment
- Post a comment in a project's discussion as the connected member, optionally as a reply.
- remove_project_commentasks before changing or removing
- Delete one of the connected member's own comments.
- remove_project_attachmentasks before changing or removing
- Delete a file attached to a project.
- add_supply
- Records how many are on hand and when to warn that stock is low.
- update_supplyasks before changing or removing
- Only the fields sent change; null clears one.
- remove_supplyasks before changing or removing
- Confirm first: it cannot be undone.
- add_tool
- It is recorded as owned unless owned is false.
- update_toolasks before changing or removing
- Only the fields sent change; null clears one.
- remove_toolasks before changing or removing
- Confirm first: it cannot be undone.
- add_contact
- Records their trade and how to reach them.
- update_contactasks before changing or removing
- Only the fields sent change; null clears one.
- remove_contactasks before changing or removing
- Confirm first: their quotes are removed with them, and past service records lose the name.
- file_documentasks before changing or removing
- This overwrites those fields.
- upload_document
- Send the bytes as base64.
- remove_documentasks before changing or removing
- Its stored file is deleted too.
- add_wishlist_item
- Their wishlist can be shared publicly, so it may appear on their public page.
- update_wishlist_itemasks before changing or removing
- Only the fields sent change.
- mark_wishlist_ownedasks before changing or removing
- By default the change is held for the user to confirm in Blueprint.
- remove_wishlist_itemasks before changing or removing
- For a purchase use mark_wishlist_owned.
- add_wishlist_link
- The address is saved as given and not visited.
- remove_wishlist_linkasks before changing or removing
- Needs the link id from list_wishlist.
- add_receipt
- Send the image as base64 (JPEG, PNG, WebP or GIF).
- remove_receiptasks before changing or removing
- Expenses already made from it are kept.
- add_utility_billasks before changing or removing
- Dates are YYYY-MM-DD; cost in dollars.
- remove_utility_billasks before changing or removing
- Needs the bill id from list_utility_bills.
Frequently asked questions
What is the Blueprint MCP server URL?
https://blueprinthome.app/mcp. The same server also answers at https://blueprinthome.app/api/mcp; a token works on either path.
Which tools work without signing in?
6 DIY library tools: search_diy_guides, get_diy_cost, estimate_materials, check_diy_job, get_seasonal_checklist, report_feedback. A request without an Authorization header gets only these.
How does sign-in work?
OAuth 2.1 with PKCE. Clients register themselves (dynamic client registration) or use a client ID metadata document, and find everything from /.well-known/oauth-protected-resource/mcp. An invalid or expired token gets a 401 with a WWW-Authenticate header, never anonymous access.
What happens when a client calls a write tool?
Unless the user let the connection write directly, the change is held as a pending proposal and the tool returns status pending_confirmation with a confirm_url. The user confirms it in Blueprint. Tools that overwrite or delete are annotated destructiveHint true.
Can write tools take a name instead of an id?
Yes, for most records: a name that matches exactly one record within its parent is resolved to its id. If several match, the call fails and lists the candidates with their ids.
Which MCP protocol versions are supported?
Streamable HTTP, stateless, with JSON responses, for both the session-based protocol and the 2026-07-28 stateless revision. GET returns 405 with a JSON-RPC error.