Buildern API and MCP server Let your AI agent price, schedule and log the job.

ToolWhat it doesAccess

• manage_projects List, open, create or update a project in Buildern. writeAsks first

  Most tools take a project, so this is usually the first call: `list` finds the project, `get` reads it. `create` and `update` save the fields you give and leave the rest as they are. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_projects

  REST endpointPOST https://cotlet.dev/api/v1/buildern/projects/manage

  Parameters

  Parameters: manage_projects

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `update`. `list` and `get` only read.
  project string	string	Project name or ID, for `get` and `update`.
  fields object	object	For `create` and `update`: name, client, address and the other project fields you want set, in Buildern's own labels.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "client": "Example Homeowner",
    "address": "12 Oak Lane, Springfield",
    "saved": true
  }

• view_dashboards Read a Buildern dashboard, for the whole company or one project. read

  Returns the figures and lists the dashboard shows to your signed-in user, as text. Nothing is changed, so it runs without asking.

  MCP callbuildern_read → view_dashboards

  REST endpointGET https://cotlet.dev/api/v1/buildern/dashboards/view

  Parameters

  Parameters: view_dashboards

  Name	Type	Description
  dashboard string	string	Dashboard to open, by the name Buildern shows. Leave empty for the first one your role sees.
  project string	string	Project name or ID. Leave empty to cover every project your role can open.

  Example response

  {
    "dashboard": "Company overview",
    "project": null,
    "widgets": [
      {
        "title": "Open projects",
        "value": 3
      },
      {
        "title": "To-dos due this week",
        "value": 7
      }
    ]
  }

• manage_budget_tab Read the Budget tab of one Buildern project, line by line. read

  Returns the rows of the project's Budget tab as your role sees them. Use it before a client meeting or at the end of a week to compare with bills and purchase orders. It changes nothing and runs without asking.

  MCP callbuildern_read → manage_budget_tab

  REST endpointGET https://cotlet.dev/api/v1/buildern/budget-tabs/manage

  Parameters

  Parameters: manage_budget_tab

  Name	Type	Description
  project string required	string	Project name or ID, as list in manage_projects returns it.

  Example input

  {
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "rows": [
      {
        "cost_code": "Cabinetry",
        "budget": 4340
      },
      {
        "cost_code": "Countertops",
        "budget": 3570
      },
      {
        "cost_code": "Tile",
        "budget": 720
      }
    ]
  }

ToolWhat it doesAccess

• perform_takeoff List or read a project's takeoffs, or record a new quantity takeoff. writeAsks first

  The agent enters the quantities you hand it; it does not measure drawings by itself. Read a saved takeoff back with `get` to price it in create_estimates. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → perform_takeoff

  REST endpointPOST https://cotlet.dev/api/v1/buildern/takeoff/perform

  Parameters

  Parameters: perform_takeoff

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  takeoff string	string	Takeoff name, for `get` and `create`.
  items array	array	For `create`: measured items, each with description, quantity and unit, as you or your estimator give them.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "takeoff": "Kitchen, base scope",
    "items": [
      {
        "description": "Base cabinets",
        "quantity": 14,
        "unit": "lf"
      },
      {
        "description": "Quartz countertop",
        "quantity": 42,
        "unit": "sq ft"
      },
      {
        "description": "Backsplash tile",
        "quantity": 30,
        "unit": "sq ft"
      }
    ],
    "saved": true
  }

• create_estimates List or read a project's estimates, or create one from lines or a takeoff. writeAsks first

  Each line can carry a cost code from manage_cost_codes. The agent shows you the lines and the total before it saves. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → create_estimates

  REST endpointPOST https://cotlet.dev/api/v1/buildern/estimates

  Parameters

  Parameters: create_estimates

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  name string	string	Estimate name, for `get` and `create`.
  lines array	array	For `create`: description, cost_code, quantity, unit and unit_cost per line.

  Example input

  {
    "action": "create",
    "project": "Oak Lane kitchen remodel",
    "name": "Kitchen remodel, base scope",
    "lines": [
      {
        "description": "Base cabinets, supply and install",
        "cost_code": "CAB",
        "quantity": 14,
        "unit": "lf",
        "unit_cost": 310
      },
      {
        "description": "Quartz countertop",
        "cost_code": "CTP",
        "quantity": 42,
        "unit": "sq ft",
        "unit_cost": 85
      },
      {
        "description": "Backsplash tile",
        "cost_code": "TIL",
        "quantity": 30,
        "unit": "sq ft",
        "unit_cost": 24
      }
    ]
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "estimate": "Kitchen remodel, base scope",
    "lines": 3,
    "total": 8630,
    "saved": true
  }

• manage_cost_codes List your Buildern cost codes, add one or rename one. writeAsks first

  Run `list` first to see the codes you already have, so the list does not grow duplicates. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_cost_codes

  REST endpointPOST https://cotlet.dev/api/v1/buildern/cost-codes/manage

  Parameters

  Parameters: manage_cost_codes

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`. `list` and `get` only read.
  code string	string	The cost code, for `create` and `update`.
  name string	string	What the code covers, for example Cabinetry.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "cost_codes": [
      {
        "code": "CAB",
        "name": "Cabinetry"
      },
      {
        "code": "CTP",
        "name": "Countertops"
      },
      {
        "code": "TIL",
        "name": "Tile"
      }
    ]
  }

• create_proposals List or read a project's proposals, or create one for the client. writeAsks first

  A proposal is what your client reads, so the agent shows you its title and the estimate behind it before saving. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → create_proposals

  REST endpointPOST https://cotlet.dev/api/v1/buildern/proposals

  Parameters

  Parameters: create_proposals

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  title string	string	Proposal title, for `get` and `create`.
  estimate string	string	For `create`: the estimate the proposal is based on.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "proposal": "Kitchen remodel proposal",
    "estimate": "Kitchen remodel, base scope",
    "saved": true
  }

• manage_templates List your Buildern templates or save a new one. writeAsks first

  A template is reused on future projects, so the agent shows you its name and source before saving. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_templates

  REST endpointPOST https://cotlet.dev/api/v1/buildern/templates/manage

  Parameters

  Parameters: manage_templates

  Name	Type	Description
  action string required	string	One of `list`, `create`. `list` and `get` only read.
  name string	string	Template name, for `create`.
  from_record string	string	For `create`: an existing Buildern record to start the template from, by name.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "template": "Kitchen remodel, standard scope",
    "from_record": "Kitchen remodel, base scope",
    "saved": true
  }

ToolWhat it doesAccess

• manage_schedule Read a project's schedule, add a task or move its dates. writeAsks first

  Your crews and subcontractors plan around these dates, so every move waits for your OK and the agent tells you which item it changed. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_schedule

  REST endpointPOST https://cotlet.dev/api/v1/buildern/schedule/manage

  Parameters

  Parameters: manage_schedule

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  task string	string	Schedule item, for `create` and `update`.
  start_date string	string	ISO date.
  end_date string	string	ISO date.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "task": "Drywall",
    "start_date": "2026-11-19",
    "end_date": "2026-11-21",
    "saved": true
  }

• manage_to_dos List a project's to-dos, add one, reassign it or mark it done. writeAsks first

  An assigned to-do is work for a teammate, so new ones and reassignments wait for your OK. Without a project, `list` covers every project you can open. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_to_dos

  REST endpointPOST https://cotlet.dev/api/v1/buildern/dos/manage

  Parameters

  Parameters: manage_to_dos

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`. `list` and `get` only read.
  project string	string	Project name or ID. Leave empty to cover every project your role can open.
  title string	string	The to-do, for `create` and `update`.
  assignee string	string	Team member it is for.
  due_date string	string	ISO date.
  done boolean	boolean	Set true to mark it done.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "title": "Confirm tile start with the tile crew",
    "assignee": "Site lead",
    "due_date": "2026-11-20",
    "done": false
  }

• record_daily_logs_site_diary Read a project's daily logs, or add today's site diary entry. writeAsks first

  Buildern's Help Center calls this Daily Logs / Site diary. The agent writes your notes as given and adds nothing you did not say. Run `list` for the date first so the same day is not logged twice. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → record_daily_logs_site_diary

  REST endpointPOST https://cotlet.dev/api/v1/buildern/daily-logs-site-diaries

  Parameters

  Parameters: record_daily_logs_site_diary

  Name	Type	Description
  action string required	string	One of `list`, `create`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  date string	string	ISO date of the log. Defaults to today.
  notes string	string	What happened on site, in your words.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "date": "2026-11-13",
    "notes": "Base cabinets set and levelled. Countertop template booked for Monday.",
    "saved": true
  }

• track_timesheets Read timesheets, or enter hours for a team member on a project. writeAsks first

  Hours feed what you pay your crew, so each entry waits for your OK. `list` reads the hours already entered for a person, project or week. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → track_timesheets

  REST endpointPOST https://cotlet.dev/api/v1/buildern/timesheets/track

  Parameters

  Parameters: track_timesheets

  Name	Type	Description
  action string required	string	One of `list`, `create`. `list` and `get` only read.
  project string	string	Project name or ID. Leave empty to cover every project your role can open.
  person string	string	Team member the hours are for.
  date string	string	ISO date.
  hours number	number	Hours worked.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "person": "Carpenter A",
    "date": "2026-11-13",
    "hours": 8,
    "saved": true
  }

• manage_files List a project's files or upload one to it. writeAsks first

  The file goes to the project in Buildern under the name you give. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_files

  REST endpointPOST https://cotlet.dev/api/v1/buildern/files/manage

  Parameters

  Parameters: manage_files

  Name	Type	Description
  action string required	string	One of `list`, `upload`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  file_url string	string	For `upload`: a link the Cloud Browser can download the file from.
  name string	string	File name to show in Buildern.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "file": "Kitchen layout rev B.pdf",
    "uploaded": true
  }

ToolWhat it doesAccess

• manage_bid_requests_request_for_quote List bid requests or send a request for quote to subcontractors and vendors. writeAsks first

  A request for quote reaches people outside your company, so the agent lists the recipients and the scope before it goes out. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_bid_requests_request_for_quote

  REST endpointPOST https://cotlet.dev/api/v1/buildern/bid-requests-request-for-quote/manage

  Parameters

  Parameters: manage_bid_requests_request_for_quote

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  scope string	string	The work or materials you want priced.
  vendors array	array	Subcontractors or vendors from manage_subcontractors_vendors.
  due_date string	string	ISO date the bids are due.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "scope": "Kitchen rewiring",
    "vendors": [
      "Example Electric",
      "Sample Sparks"
    ],
    "due_date": "2026-11-27",
    "created": true
  }

• manage_purchase_orders List or read a project's purchase orders, or create one for a vendor. writeAsks first

  A purchase order commits money to a vendor, so the agent shows the vendor, lines and total before it creates one. `list` is the quick way to see what is already ordered on a project. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_purchase_orders

  REST endpointPOST https://cotlet.dev/api/v1/buildern/purchase-orders/manage

  Parameters

  Parameters: manage_purchase_orders

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  vendor string	string	Vendor from manage_subcontractors_vendors, for `create`.
  lines array	array	For `create`: description, cost_code, quantity and unit_cost per line.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "purchase_orders": [
      {
        "vendor": "Example Lumber Co",
        "title": "Framing lumber package",
        "amount": 18400
      },
      {
        "vendor": "Sample Windows",
        "title": "Window order",
        "amount": 9650
      }
    ]
  }

• manage_bills List a project's bills or add a vendor or subcontractor bill. writeAsks first

  Bills are costs against the project budget, so the agent checks the vendor and amount with you before adding one. With `list` it reads what is already entered, which avoids adding the same bill twice. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_bills

  REST endpointPOST https://cotlet.dev/api/v1/buildern/bills/manage

  Parameters

  Parameters: manage_bills

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  vendor string	string	Who sent the bill, for `create`.
  amount number	number	Bill total.
  bill_date string	string	ISO date on the bill.
  reference string	string	The vendor's bill or invoice number.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "vendor": "Example Lumber Co",
    "amount": 18400,
    "bill_date": "2026-11-10",
    "reference": "EL-2231",
    "saved": true
  }

ToolWhat it doesAccess

• manage_selections_and_allowances Read or set a project's selections and the allowance for each. writeAsks first

  Allowances are money your client has agreed to, so a new or changed allowance waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_selections_and_allowances

  REST endpointPOST https://cotlet.dev/api/v1/buildern/selections-and-allowances/manage

  Parameters

  Parameters: manage_selections_and_allowances

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  item string	string	The selection, for example Kitchen faucet.
  allowance number	number	The allowance amount in your account currency.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "item": "Kitchen faucet",
    "allowance": 450,
    "saved": true
  }

• manage_change_orders_variations List a project's change orders or variations, or add one. writeAsks first

  A change order changes what the client pays, so it waits for your OK. Buildern's Help Center files them under Change Orders / Variations. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_change_orders_variations

  REST endpointPOST https://cotlet.dev/api/v1/buildern/change-orders-variations/manage

  Parameters

  Parameters: manage_change_orders_variations

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  title string	string	Short name of the change, for `create`.
  description string	string	What changes in the work.
  amount number	number	Price of the change.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "change_order": "Extra outlet run",
    "amount": 640,
    "saved": true
  }

• manage_client_invoices List or read client invoices, prepare one or send it to the client. writeAsks first

  Preparing and sending are separate calls, so you can read the invoice before it goes out. A sent invoice has reached your client and cannot be pulled back by the agent. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_client_invoices

  REST endpointPOST https://cotlet.dev/api/v1/buildern/client-invoices/manage

  Parameters

  Parameters: manage_client_invoices

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `send`. `list` and `get` only read.
  project string required	string	Project name or ID, as list in manage_projects returns it.
  invoice string	string	Invoice name or number, for `get` and `send`.
  lines array	array	For `create`: description and amount per line.

  Example input

  {
    "action": "action",
    "project": "project"
  }

  Example response

  {
    "project": "Oak Lane kitchen remodel",
    "invoice": "Progress invoice, November",
    "lines": [
      {
        "description": "Cabinet install, completed",
        "amount": 4340
      },
      {
        "description": "Extra outlet run",
        "amount": 640
      }
    ],
    "total": 4980,
    "sent": false
  }

ToolWhat it doesAccess

• manage_clients List or read your Buildern clients, or add a new one. writeAsks first

  Add the client before manage_projects creates their project. Run `list` first so the same homeowner is not added twice. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_clients

  REST endpointPOST https://cotlet.dev/api/v1/buildern/clients/manage

  Parameters

  Parameters: manage_clients

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  client string	string	Client name, for `get`.
  fields object	object	For `create`: name, email, phone and address.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "client": "Example Homeowner",
    "email": "homeowner@example.com",
    "phone": "+1 555 0100",
    "saved": true
  }

• manage_subcontractors_vendors List your subcontractors and vendors, or add one. writeAsks first

  Bid requests, purchase orders and bills point at these records, so add a new subcontractor here before you send them anything. By default you confirm each call; you can switch that off for this tool.

  MCP callbuildern_write → manage_subcontractors_vendors

  REST endpointPOST https://cotlet.dev/api/v1/buildern/subcontractors-vendors/manage

  Parameters

  Parameters: manage_subcontractors_vendors

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  name string	string	Company name.
  trade string	string	Trade or what they supply, for example Electrical.
  email string	string	Contact email for bid requests and orders.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "name": "Example Electric",
    "trade": "Electrical",
    "email": "bids@example.com",
    "saved": true
  }