Proper Job Building Cost Calculator

io.github.falsalamaPublished by GitHub account falsalamav1.0.2Updated Oct 24, 2026

Free UK building-cost estimates, US beta estimates and scenario comparisons. No account needed.

The publisher's own server: Calculator Tools MCP

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

A hosted Proper Job server that lets an assistant produce indicative UK and US beta building-work cost estimates and compare guide-price scenarios.

What you can do
Calculate indicative building, extension, renovation and remodelling budgets in local currency using versioned country benchmarks, with assumptions, exclusions and tax treatment explained. Retrieve UK or US input requirements and labelled reference examples. Calculate a GB or US Guide Price contract from required project inputs. Compare up to three size, finish or scope alternatives and return the comparison card with deltas. Render an optional result card where the host supports MCP Apps.
When to use it
Useful when someone wants an early, indicative budget for building, extending or renovating a home, or wants to compare size, finish or scope alternatives before talking to contractors. It is not a substitute for a fixed contractor quotation.
Requirements
A remote Streamable HTTP endpoint; no account, subscription, API key or bearer token is required. UK estimates need an outward postcode such as BS3; US beta estimates need a two-letter state and optional five-digit ZIP. Network access to the hosted service.
Before you install
Scope details typed in the conversation are sent to the third-party hosted service; do not send an exact address. Results are indicative guide prices, not fixed quotations, and US beta results exclude sales and use taxes. Calculations are not saved as projects, and some items such as patios, sliding-door specifications and new underfloor heating are not separately priced.

Installation

In SourceWeft

  1. Open Proper Job Building Cost Calculator in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.falsalama%2Fproper-job/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "proper-job-building-cost-calculator": {
      "type": "http",
      "url": "https://www.proper-job.uk/api/mcp"
    }
  }
}

README

Proper Job for Claude

Calculate and compare indicative UK and US beta building-work budgets with Proper Job from Claude Code or Cowork. The plugin connects Claude to Proper Job’s hosted, deterministic pricing service and adds a focused estimating workflow. It contains no pricing engine, internal rates or customer database.

Proper Job is owned and operated by SR3H Ltd. See the calculator documentation, privacy policy, terms and support.

What Claude can do

  • Ask for the material scope details needed for a supported UK or US beta estimate.
  • Calculate a new indicative GBP or USD guide-price range using calculate_guide_price.
  • Compare up to three supplied size, finish or scope alternatives using compare_guide_scenarios.
  • Explain country-specific tax treatment, assumptions, exclusions and items still to confirm.
  • Render the optional Proper Job result card where the host supports MCP Apps.

No Proper Job account, subscription, API key or bearer token is required. Ordinary calculations have no Proper Job payment gate or free-use allowance. Short-window abuse controls and the host’s own limits remain. Proper Job still pays its normal hosting and database costs.

Data and security boundary

The plugin connects only to https://www.proper-job.uk/api/mcp over Streamable HTTP. It sends typed scope supplied in the conversation. For the UK, use an outward postcode such as BS3. For the US, use a two-letter state and optional five-digit ZIP. Do not send an exact address.

There are no tools for customer accounts, jobs, saved estimates, exact addresses, drawings, payments, email, SQL, file access, source code or full rate-table exports. Calculations are not saved as projects. The package has no executable scripts, hooks, dependency installation, local-file access or telemetry. Public requests may produce standard operational logs and short-lived abuse counters as described in Proper Job’s privacy policy.

Example

Ask Claude:

Use Proper Job to calculate a guide price for a 30 m² rear extension in BS3, good domestic finish, balanced scope, semi-detached house, no kitchen work and no bathroom work. Then compare 40 m² with everything else unchanged.

A Guide Price is an early indicative budget, not a fixed contractor quotation. UK results state VAT treatment; US beta results use square feet and exclude sales and use taxes.

Card and scope support

Release 1.0.2 restores Claude sandbox compatibility in the hosted MCP Apps card and keeps the older resource aliases available. The same account-free endpoint continues to return structured and textual results to hosts without MCP Apps support.

An area range needs a chosen size or explicitly agreed size scenarios. Do not silently use its midpoint or assume structural steel is required. Patios, sliding-door specifications and new underfloor heating are not separately priced by the public calculator. Only named returned inclusions are confirmed: a finish band or allowance total does not establish coverage of those extras.

Publication status

This public repository is the reviewable source for a Claude community-plugin-directory submission. A submitted or installed plugin is separate from Anthropic’s verified Connectors Directory. Directory acceptance and recommendation are not guaranteed.

License

The connector configuration and documentation are MIT licensed. The Proper Job logo and brand marks are excluded and remain their owner’s property; the included logo may be displayed to identify this integration. No rights to the hosted service, pricing data or source code are granted.

Source: README.md at commit 83cb291

Tools

4

calculate_building_work

Calculate building work

Use this when a user asks the cost of building, extending or renovating a home, remodelling a kitchen/bathroom, refining a budget or costing drawings, even without naming Proper Job. Computes repeatable local-currency estimates using versioned country-specific construction benchmarks, scope and allowance rules, checked measurement conversions and source-cited drawing quantities. Returns an interactive budget card, tax basis, exclusions and a refinementQuestion. After the card, ask that question in one short sentence when present; keep unknown details optional and do not repeat the country checklist. Supported work: GB, US, AU, NZ, IE, DE, FR, ES, CA, JP, IN; exact scope limits are in the schema and market-coverage resource. Do not substitute UK rates or exchange-rate conversions. Read the drawing skill before host-only attachment analysis; send reconciled structured facts in one call. Detailed trade costing is GB-only; other countries still accept drawing quantities. Reuse unchanged results and use the returned price without inventing or narrowing it. Country, language and units are independent. Do not use for property valuations, land-price discovery, account/project lookup, purchases, issued quotes or legal/safety certification.

ParameterslandscopestatecountryjobTypezipCodecurrencydrawingslanguageukDetailsusDetailslocalScope+8 more

get_estimate_requirements

Get a rough building cost example

Retrieve UK/US input requirements or labelled reference examples when specifically requested. For a project budget, vague cost question or drawings, use calculate_building_work. Reference examples are not the user's project price. No account or drawing-file access.

ParametersscopestatecountryjobTypezipCodepostcodeArea

calculate_guide_price

Calculate building cost estimate

Calculate the established GB/US Guide Price contract with its required project inputs, when explicitly requested or used with guide comparisons. For the conversational building budget, other countries or drawings, use calculate_building_work. Returns the original guide card and does not read files, save projects or issue quotes.

ParametersscopestatecountryjobTypezipCodepostcodeArea

compare_guide_scenarios

Compare building cost scenarios

Compare GB/US Guide Price scenarios when the user explicitly asks to compare alternatives within those existing policies. Returns the original comparison card and deltas. For other countries or drawing-based refinements, use calculate_building_work with each requested scenario. No foreign-rate conversion or saved-project access.

Parametersbaselinerequiredscenariosrequired

Version history

2
  1. v1.0.2LatestSep 30, 2026
  2. v1.0.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Calculator integrations