analyzeSldDocument
ChatGPTUse this when the user needs Voltformer to run the same engineering study delivery as the editor: validation, load flow, fault, protection, operating cases, BOM, cables and explicitly configured dynamic/harmonic/sequence/ABC/DC studies. Read limitations and readiness; never infer approval from an incomplete study.
calculateMaterialEscalation
ChatGPTUse this when the user needs Voltformer to calculate a quotation escalation scenario using explicit user-supplied or source-verified commodity reference prices; this is not a live quotation.
calculateTransformerLossRoi
ChatGPTUse this when the user needs Voltformer to calculate loss-cost difference, CO2 impact, and optional simple payback from stated baseline and candidate transformer loss values. The comparison never estimates missing losses or certifies compliance.
calculateTransformerSizing
ChatGPTUse this when the user needs Voltformer to perform preliminary transformer-only kVA sizing. Catalog matches are withheld until primary voltage, secondary voltage and phase count are supplied. Cable selection is withheld because it requires site-specific current, installation, derating, voltage-drop and short-circuit inputs.
compareTransformers
ChatGPTUse this when the user needs Voltformer to compare two catalog transformers across electrical, loss, mechanical and compliance specifications.
compare_electricity_prices
ChatGPTUse this when the user needs Voltformer to compare Voltformer's electricity price references across countries while preserving consumer scope, period, tax treatment, separate fixed charges, billing minimums and verification status. Different tariff bands and averages are not equivalent industrial quotations; unsupported FX conversions remain null. On first use, missing baseline records may be written to the shared price store using configured FX sources.
convertFluidBarrel
ChatGPTUse this when the user needs Voltformer to convert a stated insulating fluid tonne price to barrel units using the selected grade or explicit density.
createSldDocument
ChatGPTUse this when the user needs Voltformer to create a diagram in an owned project from a template or a full document. Use a stable sldId for retries.
createSldRevision
ChatGPTUse this when the user needs Voltformer to archive the current diagram as an immutable engineering revision, recording the author and advancing the storage version. Updates the current diagram status and revision code; obtain explicit instructions before recording approval.
createSpecificationUploadUrl
ChatGPTUse this when the user needs Voltformer to get a signed URL for a server-side PDF PUT with the returned uploadHeaders (Content-Type: application/pdf and x-goog-if-generation-match: 0), then call finalizeSpecificationUpload. Each URL creates one immutable object. Requires a connected member; browser uploads use the Firebase SDK.
deleteCompanyProfile
ChatGPTUse this when the user needs Voltformer to delete one of the connected member's company profiles by id. Requires a connected member.
deleteProject
ChatGPTUse this when the user needs Voltformer to delete one of the connected member's projects by id. Requires a connected member.
deleteSldDocument
ChatGPTUse this when the user needs Voltformer to delete a diagram only after the user requests deletion. Immutable revisions are retained. Requires the last read version.
duplicateSldDocument
ChatGPTUse this when the user needs Voltformer to copy a diagram as a new draft in its project. Use a stable newSldId for retries.
exportSldDocument
ChatGPTUse this when the user needs Voltformer to export the saved drawing as SVG, DXF, PNG, PDF, JSON, pandapower Python, BOM/cable CSV, or a study HTML/JSON report. PNG/PDF content is base64; other formats return text. Files remain private.
finalizeSpecificationUpload
ChatGPTUse this when the user needs Voltformer to validate an uploaded technical-specification PDF so its path can be attached to an RFQ. Requires a connected member.
getBrand
ChatGPTUse this when the user needs Voltformer to get a represented equipment brand with its total catalog product count and sample products across all equipment families.
getCatalogTaxonomy
ChatGPTUse this when the user needs Voltformer to get the complete versioned hierarchy: product domain, engineering product families, main categories, subcategories and technical specializations.
getCategory
ChatGPTUse this when the user needs Voltformer to get a main category by slug or ID.
getCompatibleTransformersForSwitchgear
ChatGPTUse this when the user needs Voltformer to assess preliminary transformer candidates against switchgear voltage and numeric current ratings. Prospective fault current is optional; without it, short-circuit compatibility is unknown.
getCountryGridStandard
ChatGPTUse this when the user needs Voltformer to get a country engineering profile with grid data, safe project defaults and explicit site/utility unknowns. It is not regulatory approval.
getGeneratorBySlug
ChatGPTUse this when the user needs Voltformer to get a generator set (genset) by slug.
getGovernmentTender
ChatGPTUse this when the user needs Voltformer to read a selected government or intergovernmental procurement notice by ID, including source evidence, unknowns, current effective status, reviewed source status, snapshot dates and localized title/summary. Verify amendments on the authoritative portal before acting.
getGridEquipmentBySlug
ChatGPTUse this when the user needs Voltformer to get a grid-equipment product (metering, power quality, conductor, motor, UPS/BESS/PV or EVSE) by slug.
getProductBySlug
ChatGPTUse this when the user needs Voltformer to get full transformer specifications by slug, SKU, or ID.
getProject
ChatGPTUse this when the user needs Voltformer to get a project with its linked RFQs (project management view). Requires a connected member.
getProtectionControlBySlug
ChatGPTUse this when the user needs Voltformer to get a protection and control product by slug.
getRawMaterialData
ChatGPTUse this when the user needs Voltformer to read transformer materials, CRGO, insulating fluid indices, methodology, data availability and price history. Preserve source dates and estimated/unavailable labels.
getRfqSpecificationDownloadUrl
ChatGPTUse this when the user needs Voltformer to get a short-lived download URL for one of the connected member's uploaded technical-specification PDFs. Requires a connected member.
getSldCapabilities
ChatGPTUse this when the user needs Voltformer to discover SLD templates, symbol library, editing contract, export formats and example document. Use before drawing.
getSldDocument
ChatGPTUse this when the user needs Voltformer to read a complete editable SLD snapshot: equipment, positions, connections, annotations, sheets and study settings.
getSolarBySlug
ChatGPTUse this when the user needs Voltformer to get a solar module by slug, SKU or ID, including stated electrical ratings, localized descriptions and manufacturer sources.
getSubCategory
ChatGPTUse this when the user needs Voltformer to get a sub-category by main and sub slug or ID.
getSwitchgearBySlug
ChatGPTUse this when the user needs Voltformer to get a switchgear product by slug.
getTechnicalArticle
ChatGPTUse this when the user needs Voltformer to read the complete canonical technical article with its source URL and metadata.
get_electricity_price
ChatGPTUse this when the user needs Voltformer to read Voltformer's latest available electricity price reference with its consumer scope, period, tax treatment, separate fixed charges, billing minimums and verification status. Tariff bands are not national averages; unsupported FX conversions remain null. On first use, missing baseline records may be written to the shared price store using configured FX sources.
get_electricity_price_history
ChatGPTUse this when the user needs Voltformer to read historical electricity prices for a country. On first use, missing baseline records may be written to the shared price store using configured FX sources.
linkSldCatalogProduct
ChatGPTUse this when the user needs Voltformer to link an exact catalog product to a compatible diagram element, replacing its catalog reference and synchronizing engineering properties. Read the drawing first; expectedVersion rejects concurrent edits.
listBrands
ChatGPTUse this when the user needs Voltformer to list brands represented across all six equipment catalog families and their total catalog product counts.
listCategories
ChatGPTUse this when the user needs Voltformer to list categories within the Power & Energy Equipment product domain.
listCompanyProfiles
ChatGPTUse this when the user needs Voltformer to list the connected member's saved company profiles (used to prefill RFQ customer data). Requires a connected member.
listCountryGridStandards
ChatGPTUse this when the user needs Voltformer to list or search preliminary country engineering profiles: grid voltages, frequency, transformer standards, operators, climate basis, project defaults and mandatory verification items. Read the returned collection for current coverage.
listFavorites
ChatGPTUse this when the user needs Voltformer to list the connected member's saved shortlist of catalog product ids. Requires a connected member.
listProjects
ChatGPTUse this when the user needs Voltformer to list the connected member's projects. Requires a connected member.
listRfqs
ChatGPTUse this when the user needs Voltformer to list the connected member's RFQ requests with their current status (results). Use projectId for the project-management view. Requires a connected member.
listSldDocuments
ChatGPTUse this when the user needs Voltformer to list diagram IDs, names, status and storage versions in one owned project.
listSldRevisions
ChatGPTUse this when the user needs Voltformer to list immutable engineering revisions for a diagram.
list_electricity_prices
ChatGPTUse this when the user needs Voltformer to list Voltformer's electricity price references with their consumer scope, periods, tax treatment, separate fixed charges, billing minimums and verification status. Unverified legacy records are explicitly marked and unsupported FX conversions remain null. On first use, missing baseline records may be written to the shared price store using configured FX sources.
queryGenerators
ChatGPTUse this when the user needs Voltformer to search generator sets by power range, brand, product type and text matching names, engines or applications.
queryGovernmentTenders
ChatGPTUse this when the user needs Voltformer to search selected source-reviewed government and intergovernmental procurement notices by text, country, buyerType, noticeType, sector, current effective status and publication month. Coverage is a bounded curated snapshot, not exhaustive or live. Preserve authoritative sources, evidence and unknowns.
queryGridEquipment
ChatGPTUse this when the user needs Voltformer to search instrument transformers, meters, surge arresters, compensation, conductors, motors, UPS/BESS/PV and EVSE products by brand, type and stated connection-voltage envelope.
queryProtectionControl
ChatGPTUse this when the user needs Voltformer to search transformer and feeder protection, control and substation automation products.
querySolar
ChatGPTUse this when the user needs Voltformer to search solar modules by name, brand, cell technology and stated power in watts. Solar panels are separate from grid-equipment PV inverters.
querySwitchgear
ChatGPTUse this when the user needs Voltformer to search and filter switchgear products. Use q, brand, productType, maxVoltageKV, and limit.
queryTransformers
ChatGPTUse this when the user needs Voltformer to search and filter the transformer catalog.
runSldStudy
ChatGPTUse this when the user needs Voltformer to run an editor study on a saved diagram. contingency uses no settings. motorStarting: motorId, minimumTerminalVoltagePU; motorScenario: motorIds; motorSchedule: entries[{motorId,startAtSeconds,lockedRotorDurationSeconds}], sourceNote. swing: inertiaHSeconds, mechanicalPowerPU, preFaultTransferPU, faultTransferPU, postFaultTransferPU, dampingPU, faultDurationSeconds, simulationSeconds, stepSeconds, sourceNote. sequenceFault: nominalVoltageKV, faultType(3PH/LG/LL/LLG), voltageFactor, positiveOhms/negativeOhms/zeroOhms/faultOhms({r,x}), sourceNote. protectionSweep: upstream/downstream relay profiles, ratio, minPrimaryCurrentA, maxPrimaryCurrentA, upstreamTolerancePercent, downstreamTolerancePercent, upstreamAbsoluteToleranceS, downstreamAbsoluteToleranceS, breakerClearingTimeS, safetyMarginS. All assumptions must be supplied by the user or verified engineering sources.
saveSldDocument
ChatGPTUse this when the user needs Voltformer to replace a complete diagram snapshot after reading it. Supports arbitrary editor changes, sheets, wiring, annotations and saved study settings. Preserve unedited fields; expectedVersion prevents overwriting concurrent edits. Editing an approved or reviewed drawing returns it to DRAFT; use createSldRevision for a new issue.
searchTechnicalArticles
ChatGPTUse this when the user needs Voltformer to find technical engineering article summaries by query or category; use getTechnicalArticle for the full source.
setFavorites
ChatGPTUse this when the user needs Voltformer to replace the connected member's shortlist with a new list of catalog product ids. Requires a connected member.
submitRfqQuoteRequest
ChatGPTUse this when the user needs Voltformer to create a durable quotation request for known catalog products. Before calling: prefill from the member profile/project, ask for missing operational details and whether a PDF specification exists, show a final summary, and obtain explicit user confirmation. Omit unknown optional properties.
syncSldProjectEquipment
ChatGPTUse this when the user needs Voltformer to merge procurement items from the selected saved SLD into project equipment, retaining existing items and replacing quantities with the greater quantity for each product, as the editor does.
uploadSpecificationInline
ChatGPTUse this when the user needs Voltformer to upload PDF bytes available to the MCP client (for example a chat attachment) as base64. Maximum decoded size is 5 MiB; larger PDFs up to 80 MiB use createSpecificationUploadUrl. Requires a connected member.
upsertCompanyProfile
ChatGPTUse this when the user needs Voltformer to create or replace company/contact fields in a connected member profile. On update, omitted optional fields are cleared; read the existing profile and preserve required values.
upsertProject
ChatGPTUse this when the user needs Voltformer to create or update a connected member project, including engineering inputs, equipment and status. Supplied fields overwrite existing values; changing country clears unstated connection-dependent values.
validateTransformerCountryCompatibility
ChatGPTUse this when the user needs Voltformer to screen stated transformer frequency, primary kV, secondary V and vector group against preliminary country reference data. This does not verify regulatory compliance or utility approval.
