Blueprint
MCP server

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.