Skip to main content
Glama

Proper Job

Server Details

Calculate and compare indicative UK building-work budgets from supplied scope using Proper Job.

If you are the author of this connector, you can claim ownership with GitHub, an HTTP challenge, or a DNS record. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
falsalama/properjob-claude-plugin
GitHub Stars
0

Available Tools

3 tools
calculate_guide_priceCalculate a UK building budgetA
Read-onlyIdempotent
Inspect

Use this when a user asks how much UK building work could cost, needs a renovation budget, or wants to recalculate a supplied scope. Calculate an indicative GBP range for supported work such as extensions, loft conversions, kitchens, bathrooms and refurbishment using Proper Job's pricing engine. Use only conversation-supplied scope, area in square metres and outward postcode. Missing details return needs_input; ask the user rather than guessing. Returns a rich budget card with VAT, assumptions and exclusions. Not for property valuations, mortgages, non-UK work, fixed contractor quotes, private project lookup or drawing extraction.

ParametersJSON Schema
NameRequiredDescriptionDefault
scopeNo
jobTypeNo
postcodeAreaNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNo
statusYes
requestIdYes
schemaVersionYes

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (read-only, idempotent, non-destructive), the description discloses that missing details return 'needs_input' and that the tool returns a 'rich budget card with VAT, assumptions and exclusions'. It also states it uses only conversation-supplied data, providing extra behavioral context without contradicting annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and front-loaded with usage conditions. It covers purpose, supported work, constraints, output, and exclusions in five sentences without unnecessary detail, making it easy to parse and act on.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description includes explicit exclusions that help route away from non-applicable requests, and it summarizes the output format and error behavior. However, it does not explicitly reference sibling tools like 'compare_guide_scenarios' or 'get_estimate_requirements', so some differentiation relies on inference. The output schema is indicated but not shown, so the description's summary is sufficient but not exhaustive.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description mentions 'scope, area in square metres and outward postcode', giving a partial hint about inputs, but it does not explicitly explain the 'jobType' top-level enum parameter. The nested scope object contains many fields with limited descriptions, so the parameter semantics are not fully addressed. The note about 'needs_input' mitigates some ambiguity, but the description could be more precise about which parameters are required for different job types.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states when to use the tool ('when a user asks how much UK building work could cost...'), what it calculates ('an indicative GBP range'), and lists supported work types. It also explicitly distinguishes from excluded use cases ('Not for property valuations, mortgages, non-UK work...'), making the purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit when-to-use ('Use this when...') and when-not-to-use ('Not for...') guidance. It also instructs the agent to ask the user rather than guessing when details are missing, which is a clear behavioral directive for usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

compare_guide_scenariosCompare size, scope and finishA
Read-onlyIdempotent
Inspect

Calculate a baseline and up to three user-supplied scope alternatives on the same pricing policy, including server-calculated price differences. Supply baseline inputs from the conversation; saved estimates cannot be retrieved.

ParametersJSON Schema
NameRequiredDescriptionDefault
baselineYes
scenariosYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNo
statusYes
requestIdYes
schemaVersionYes

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds behavioral context beyond the annotations by stating that price differences are server-calculated and that saved estimates cannot be retrieved, meaning inputs must be supplied from the conversation. This aligns with the readOnlyHint and idempotentHint annotations without contradicting them.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, directly addresses the core function, and contains no redundant or extraneous information. It is well-structured and easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While the description does not explain the output format, an output schema is provided, so that omission is acceptable. It adequately conveys the inputs (baseline from conversation, up to three alternatives) and the core functionality. It could be slightly more explicit about the number of scenarios, but the schema already constrains that.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has no descriptions for the many parameters (coverage 0%), and the tool description only mentions 'baseline' and 'scope alternatives' without explaining their structure or any individual fields. Since the schema is highly complex and the description does not compensate, parameter semantics are severely lacking.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: calculating a baseline and up to three scope alternatives on the same pricing policy, including server-calculated price differences. It specifies the verb 'Calculate' and the resource (baseline and alternatives), and it distinguishes this from a single-price tool by emphasizing comparison and price differences.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use the tool (when you have a baseline from the conversation and want to compare alternatives), but it does not explicitly mention sibling tools like calculate_guide_price or get_estimate_requirements, nor does it state conditions when not to use this tool. Guidance is present but not fully explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_estimate_requirementsClarify building budget inputsB
Read-onlyIdempotent
Inspect

Start a conversation about a UK extension, loft, kitchen, bathroom or refurbishment budget. Returns supported scope choices, missing inputs and useful questions. No account or saved project required.

ParametersJSON Schema
NameRequiredDescriptionDefault
scopeNo
jobTypeNo
postcodeAreaNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
dataNo
errorNo
statusYes
requestIdYes
schemaVersionYes

TDQS

B3.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare read-only, idempotent, and non-destructive behavior. The description adds behavioral context beyond the annotations by specifying that the tool returns scope choices, missing inputs, and questions, and that it requires no account or saved project. This is useful supplementary context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, concise and front-loaded with the primary action ('Start a conversation...'). It avoids unnecessary detail and is easy to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (3 top-level parameters, a large nested scope object with over 80 fields, and an output schema), the description is far too brief. It does not explain the shape of the return value, how to map user inputs into the nested object, or what 'supported scope choices' means in practice. This leaves significant gaps for an agent trying to use the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is effectively zero (only approximateSize has a brief description). The tool description does not compensate by explaining the parameters (jobType, postcodeArea, scope) or how to populate the nested scope object. Parameter names and enum values give some clues, but the description adds no semantic guidance for a complex input structure.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: starting a conversation to gather estimate requirements and returning supported scope choices, missing inputs, and questions. It does not explicitly name sibling tools (calculate_guide_price, compare_guide_scenarios) to differentiate, but the focus on gathering inputs rather than calculating or comparing makes the intended use evident.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for initial requirements clarification ('Start a conversation about... budget') but does not explicitly state when to use this tool versus the sibling tools (calculate_guide_price, compare_guide_scenarios) or provide conditions for when it is not appropriate. No alternative guidance is given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 3 tool updates
    • First observedcalculate_guide_price
    • First observedcompare_guide_scenarios
    • First observedget_estimate_requirements

Frequently Asked Questions

Discussions

No comments yet. Be the first to start the discussion!

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Audits Japanese construction and renovation estimates for overcharge. Fair price ranges by work type, red flag checks for sales tactics, and signed recomputable verdicts. Backed by the open JCCDB dataset (65,729 items, CC BY 4.0).
    14
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Plans domestic jobs around your available hours by scheduling work and unavoidable waiting, then tracks progress and reschedules as conditions change. It answers deadline questions honestly, suggests what to buy, and tells you the next thing to do.
    1,047
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Provides construction-supervision tools for small-to-medium building projects, including stage guidance, inspection checklists, progress tracking, next-stage recommendations, and quotation analysis. It enables local, standards-based MCP interaction over stdio without third-party MCP SDKs.
    5
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides construction cost estimation tools using data from a public Google Sheet for items like concrete, framing, and electrical. It allows users to search items, filter by category, and calculate total project costs including labor and material expenses.
    -
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A3.9/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose: calculate a single price, compare scenarios, and gather requirements. There is no meaningful overlap that would cause an agent to select the wrong tool.

Naming Consistency4/5

All names follow a clear verb_noun pattern (calculate_guide_price, compare_guide_scenarios, get_estimate_requirements). Minor inconsistency exists between 'guide_' and 'estimate_' prefixes, but the pattern remains predictable.

Tool Count5/5

With three tools, the set is compact and well-suited to the domain of guide pricing. Each tool serves a necessary step in the user journey without redundancy.

Completeness5/5

The tool set covers requirements gathering, single price calculation, and scenario comparison, which are the core operations for this pricing assistant. No obvious missing functionality is needed for the stated use cases.