Skip to main content
Glama
TylerIlunga

Procore MCP Server

update_prime_change_order

Modify a prime change order in Procore to update contract details, status, dates, and financial information for construction project management.

Instructions

Update Prime Change Order. [Construction Financials/Prime Contracts] PATCH /rest/v1.0/projects/{project_id}/prime_change_orders/{id}

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
project_idYesUnique identifier for the project.
idYesID of the Prime Change Order
run_configurable_validationsNoIf true, validations are run for the corresponding Configurable Field Set.
viewNoSpecifies Which view (which attributes) of the resource is going to be present in the response. the extended view includes change events data, while the default view does not.
contract_idNoUnique identifier for the contract.
batch_idNoUnique identifier for a change order batch.
change_order_change_reason_idNoUnique identifier for the change reason.
location_idNoUnique identifier for the location.
designated_reviewer_idNoUnique identifier for the designated reviewer. This field is only supported for single-tier projects. Behavior is undefined in multi-tier projects.
received_from_idNoUnique identifier for the received from entity.
descriptionNoDescription
due_dateNoDue Date
paid_dateNoPaid Date
invoiced_dateNoInvoiced Date
titleNoTitle of the Contract
statusNoStatus
referenceNoReference
numberNoNumber of the Change Order
revisionNoRevision Number
field_changeNoField Change
signature_requiredNoWhether a signature will be required for this Change Order
signed_change_order_received_dateNoSigned Change Order Received Date
schedule_impact_amountNoSchedule impact in days
executedNoWhether or not the Change Order is executed
privateNoWhether or not the Commitment Change Order is private
paidNoWhether or not the Commitment Change Order is paid
reasonNoReason for the change order
custom_field_%{custom_field_definition_id}NoValue of the custom field. The data type of the value passed in corresponds with the data_type of the Custom Field Definition. For a lov_entry data_type the value passed in should be the ID of one ...
enable_ssovNoWhether to enable SSOV on this Change Order. Only applicable to Commitment Change Orders.
change_event_attachment_idsNoList of attachment IDs to attach. These must presently be associated with Change Events.
attachment_idsNoExisting attachments to preserve on the response
drawing_revision_idsNoDrawing Revisions to attach to the response
Behavior1/5

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

No annotations are provided, so the description must fully disclose behavioral traits. It only states 'Update Prime Change Order' and an API endpoint, failing to describe that this is a mutation operation, potential side effects (e.g., modifying financial records), authentication needs, rate limits, or error conditions. The description is insufficient for a tool with 32 parameters and no output schema.

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

Conciseness2/5

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

The description is a single, poorly structured sentence that combines a tautological statement with API details. It is under-specified rather than concise, failing to convey essential information efficiently. Every sentence should earn its place, but this one adds minimal value beyond the tool name.

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

Completeness1/5

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

Given the complexity (32 parameters, no annotations, no output schema), the description is severely incomplete. It does not explain the tool's purpose, usage, behavioral traits, or return values. For a mutation tool in a financial context, this lack of information could lead to incorrect usage, making it inadequate for agent guidance.

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 input schema has 100% description coverage, providing detailed documentation for all 32 parameters. The description adds no parameter-specific information beyond what the schema already covers. According to the rules, with high schema coverage (>80%), the baseline score is 3, as the schema does the heavy lifting and the description does not compensate or add value.

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

Purpose2/5

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

The description 'Update Prime Change Order' is a tautology that restates the tool name without adding clarity. It includes a domain context '[Construction Financials/Prime Contracts]' and an API endpoint 'PATCH /rest/v1.0/projects/{project_id}/prime_change_orders/{id}', which hints at the resource but lacks a specific verb or explanation of what 'update' entails. It does not distinguish this tool from sibling tools like 'update_prime_change_order_batch' or 'update_prime_contract'.

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

Usage Guidelines1/5

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

The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites, such as needing an existing Prime Change Order, or differentiate from other update tools in the sibling list (e.g., 'update_prime_change_order_batch'). There is no explicit or implied context for usage.

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

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/TylerIlunga/procore-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server