Portravo Construction Takeoff

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Review construction plan takeoffs and download reviewed estimates with Portravo account linking.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Portravo Construction Takeoff": {
      "url": "https://portravo.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• preflight_takeoff read-only

  Before creating or starting a takeoff, inspect current automatic/team-assisted trades, the exact existing-credit requirement, balance, upload limits and review link. Supply either project_id or proposed trades, or neither to discover availability. Does not reserve credits, start work, buy anything or bill overage. Reviewer scope is identified separately.

  Parameters:

  • trades — array
  • project_id — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_takeoff_status read-only

  Read an owned project and its latest asynchronous takeoff progress, completion limitations and review link. Never advances or restarts a run, uses credits or changes billing. Poll this tool after run_takeoff returns a running result.

  Parameters:

  • project_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_profile read-only

  Identify the signed-in Portravo account after OAuth account linking.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_projects read-only

  Find construction projects in the connected Portravo account, including draft, review, priced and final estimates. Returns 50 projects per page; nextOffset is the offset of the next page, or null on the last page.

  Parameters:

  • offset — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_takeoff read-only

  Read an owned construction project's plan files (attached from chat or uploaded in Portravo) and extracted takeoff quantities, trades, confidence and human review status. reviewRequired reports whether any line still needs estimator review. Quantities require estimator review before pricing or bidding.

  Parameters:

  • project_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_pricing_markets read-only

  List the regional construction pricing markets supported by Portravo. The returned markets are the accepted metro_code values for create_project.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• create_project

  Create a new construction estimate project in the connected Portravo account from a project name, an explicit trades selection returned by preflight_takeoff, an optional address and an optional supported metro_code. Trades are required for customer projects; only the isolated synthetic reviewer may omit them. Repeating a call with the same idempotency_key returns the original project instead of creating another. Returns reviewUrl, the project page where the user can also upload a plan PDF in the browser. Does not run extraction or consume estimate credits.

  Parameters:

  • name (required) — string
  • idempotency_key (required) — string
  • trades — array
  • address — string
  • metro_code — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• attach_plan_pdf

  Attach a PDF the user selected in this conversation as the first plan for a new Portravo project. Plan PDFs must be 10 MiB or smaller. Accepts exactly one of plan, a host-provided download_url and file_id, or plan_inline, canonical base64 of the exact user-uploaded PDF bytes with file_name and application/pdf mime_type, up to 32 KiB. A PDF with no file link above 32 KiB, or any PDF above the direct limit, is uploaded in the browser at the project's reviewUrl instead. That browser path streams up to 50 MiB for the selected automatic trades. Projects that already have a plan or review work are refused, so existing work is never replaced. Repeating a call with the same idempotency_key returns the original result. Stores the selected PDF privately in the connected account; does not extract or consume credits.

  Parameters:

  • project_id (required) — string
  • idempotency_key (required) — string
  • plan — object — Host-provided signed file link for a PDF the user attached (PDF up to 10 MiB).
  • plan_inline — object — Exact bytes of a user-uploaded PDF as canonical base64, only when no file link exists. PDF up to 32 KiB.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• run_takeoff

  Run the initial AI takeoff for a new project whose plan PDF was attached with attach_plan_pdf or uploaded by the user on the project page in Portravo. Call preflight_takeoff first and obtain approval for its selected trades and creditsRequired. Set confirmed_trades to the approved selection and max_credits to that approved ceiling (defaults to one for older clients). Uses only existing plan allowance and purchased credits, never billed overage; a changed selection/cost or insufficient balance is refused before starting. The isolated synthetic reviewer retains its bounded one-credit standard fixture. Repeating a call with the same idempotency_key does not charge again. Returns asynchronous progress; use get_takeoff_status until done, then get_takeoff for source-linked human review. A completed run is not a bid-ready estimate. Failed provider runs refund the reservation; existing review work cannot be overwritten.

  Parameters:

  • project_id (required) — string
  • confirm_credit_use (required) — boolean
  • idempotency_key (required) — string
  • max_credits — integer
  • confirmed_trades — array

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• export_reviewed_estimate read-only

  Get a short-lived Excel XLSX download for an owned Portravo estimate after every takeoff line has been reviewed and the estimate is priced or final. If review is incomplete, the call returns a review_required error with the Portravo review link, where quantities, assembly mappings and pricing are completed. Never exports unreviewed estimates.

  Parameters:

  • project_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.