Skip to content
ForewitDocsOpen app
On this page

Give this to your agent

Paste this prompt into your agent to connect Forewit.

Read https://surfside-software.com/llms.txt and follow its setup guide to connect this client to Forewit's MCP server. Preserve my existing MCP servers. Verify the connection by calling list_projects without changing any project data. If setup needs a manual step or restart, tell me what's required.

Manual setup

If your agent cannot configure the connection, choose your client and follow these steps.

Remote MCP serverPublic demo
https://mcp.surfside-software.com/mcp
Transport
Streamable HTTP
Authentication
None for this demo

Everyone using the demo can read and change its projects. Use fictional data. Other visitors will see your changes.

Choose your MCP client

Run this command from your project directory to add the demo server to Claude Code.

Terminal
claude mcp add --transport http forewit https://mcp.surfside-software.com/mcp

Run /mcp in Claude Code to check the connection. If Forewit is missing, start a new session.

Claude Code documentation

Your first prompt

Paste this prompt into your connected agent. It should return the names and links of projects saved in the demo.

List demo projects

Read only

Read a project and get links to its panels.

List the projects in Forewit. Open a project whose name starts with DEMO and summarize its panel schedules. Include links to the project and panels. Do not change any data.

Open a returned link to review the schedule in the app.

Prompts to try

Copy a prompt below. Each label tells you whether the task changes demo data.

Check an existing panel

Read only

Check loads, phase balance, and sizing results without changing the panel.

Find DEMO - Lantern House in Forewit and read panel H-1. Run analyze_panel on the complete draft. Report connected VA, phase currents, imbalance, and all errors and warnings. Use search_docs to explain any blocked or not-sized conductor results. Include the panel link. Do not save changes.

Create a demo panel

Creates demo data

Create a fictional project and save a panel with two circuits.

Create a fictional project in Forewit with a unique name starting with DEMO - Agent Trial. Use project number DEMO-AGENT, building type Single-family residence, location Example City, phase Schematic design, and description Fictional agent demo. Create panel LP-1 with a 120/240-1PH-3W system, 200 A main, 200 A bus, and 24 positions. Add two 1-pole, 20 A circuits on different phases: Lighting with 1,200 VA and Receptacles with 1,800 VA. Leave conductor sizing as not-sized because I have not supplied sizing evidence. Analyze the complete draft and fix structural errors. Save the panel, then read it again to verify the saved data. Include the project and panel links.

Add a circuit to a copy

Creates and saves a copy

Compare phase loads before and after adding a circuit.

Find DEMO - Lantern House in Forewit. Duplicate H-1 with a unique name starting with H-1 Option, then read the complete copy. Add a 1-pole, 20 A circuit named Study receptacles with 1,200 connected VA in an available position on the least-loaded phase. Keep every existing circuit. Do not invent conductor sizing inputs. Analyze the complete draft and fix structural errors. Save the copy, then read it again to verify the saved data. Compare phase loads and imbalance with the original. Include both panel links.

Link a feeder tree

Creates demo data

Create a fictional project, connect a service panel and a sub-panel, and read the riser notes.

Create a fictional project in Forewit with a unique name starting with DEMO - Feeder Trial. Use project number DEMO-FEEDER, building type Office, location Example City, phase Schematic design, and description Fictional feeder tree demo. Create panel MDP with a 120/208-3PH-4W system, a 200 A main breaker, and 42 positions, and panel LP-1 with a 120/208-3PH-4W system, a 100 A main breaker, and 30 positions. Add a 3-pole, 100 A circuit to MDP named Feeder to LP-1, with one load named LP-1 placeholder of 1,000 VA, and leave its conductor sizing as not-sized. Add a utility source named U-1 on 120/208-3PH-4W with create_distribution_node. With update_panel, link MDP to U-1 with the service conductor left unspecified, and link LP-1 to the MDP feeder circuit. Do not enter a fault current basis, impedance, run length, or rating, because I have not supplied them. Call get_distribution and confirm that both panels are connected and MDP is the service equipment. Then call get_riser and list each REQ note it prints. Include the Feeder tree link.

Read calculated loads

Read only

Report the Article 220 load at each panel and at the service.

Find DEMO - Signal Ridge Workshop in Forewit and call get_loads. Report the service total, then each panel and transformer's calculated VA, maximum load current, and continuous-adjusted current, in feeder order. List every warning, including unreviewed table values, and use search_docs to explain each issue code. Include the Loads link. Do not change any data.

Check voltage drop

Read only

Find the worst combined feeder and branch drop, then size a longer run.

Find DEMO - Signal Ridge Workshop in Forewit and call get_voltage_drop. Say whether the 5 percent combined check is mandatory or advisory, and why. Report each feeder's drop, the branch circuit with the worst combined drop, and any run that fails its allowance. Then use calculate_voltage_drop for a 1-pole, 20 A branch circuit at 120 V carrying 1,200 VA, 150 ft one way in PVC raceway, on the branch default current, and report its minimum copper size. Include the Voltage drop link. Do not change any data.

Check available fault current

Read only

Report the fault current and rating checks at every bus, with the date and fingerprint.

Find DEMO - Signal Ridge Workshop in Forewit and call get_fault_current. For each bus, report the available fault current, its motor contribution, and the interrupting rating and short-circuit current rating checks. Name the service equipment. Quote the calculation date and fingerprint, which print beside any value used on drawings. List the C values still marked unreviewed. Then call export_fault_current and give me the file name. Include the Fault current link. Do not change any data.

Read the riser diagram

Read only

Summarize the feeder tree and riser, and export the drawing.

Find DEMO - Lantern House in Forewit. Call get_distribution and list the equipment from the utility source down, with what feeds each panel. Call get_riser and summarize each box, each feeder tag, and every note, including each input a note says is missing. Then call export_riser and give me the file name and calculation date. Include the Feeder tree link. Do not change any data.

Edit and save a schedule

Ask your agent to follow these steps when changing a panel. Forewit runs the calculations and saves the schedule.

  1. Read the panel

    Find the project with list_projects, then use get_project to find its panels. Read the complete panel with get_panel before editing it so you can preserve existing circuits.

  2. Edit and check the draft

    Edit the draft, then call analyze_panel to check circuit positions, connected loads, phase balance, and conductor sizing. This step does not save changes.

  3. Fix errors and save

    Fix every structural error before calling save_panel. Send the complete panel and circuit list with the updatedAt from your read, since saving replaces the stored draft. For individual changes, use the focused editing tools; they save immediately. Report any warnings and missing sizing inputs.

  4. Check the saved panel

    Call get_panel again to verify the saved data. Share the returned URL so the user can review the schedule in the app.

Tool reference

The server provides 32 tools. When your client connects, it gets the tool definitions and the inputs each accepts.

Available remote MCP tools and their behavior
ToolAccessWhat it does
list_projectsReadList projects with IDs and links.
get_projectReadRead a project's details and panel summaries.
export_projectReadExport a project as a project document: the JSON file the forewit library and command read, with every authored input, the ids the project holds, and a list of anything the library's reader refuses in it.
create_projectWriteCreate a project and return its link.
update_projectWriteReplace all editable project fields. Read the project first and include unchanged fields. Omit energyCodeScope to keep the stored scope.
get_panelReadRead a complete panel draft, including its circuits and app link.
analyze_panelReadCheck circuit positions, loads, phase balance, and conductor sizing without saving.
create_panelWriteCreate an empty panel. Its name must be unique within the project.
save_panelWriteReplace the complete panel and circuit list, including its supply link and ratings. The server recalculates voltage drop and conductor sizing.
duplicate_panelWriteCopy a panel and its circuits within the same project. The copy starts unlinked.
update_panelWriteChange supplied panel settings while preserving its circuits.
add_circuitWriteAdd a load circuit or spare to a panel.
update_circuitWriteEdit breaker sizes, loads, or supplied circuit fields.
move_circuitWriteMove a circuit or explicitly swap matching breakers.
remove_circuitDestructiveRemove a circuit and its loads and sizing. Names any equipment it supplied.
autosize_panelWriteEnable automatic conductor sizing for unsized load circuits, with feeder defaults where a circuit supplies linked equipment.
export_panelReadExport the saved schedule as SVG, with each circuit's VD%, the worst combined voltage drop, the panel's calculated load from get_loads, and its available fault current from get_fault_current with the rating checks, date and fingerprint.
delete_panelDestructivePermanently delete a panel and all its circuits.
get_distributionReadRead a project's feeder tree: nodes, panel supplies and ratings, feeder circuits, and each node's path, state, service equipment and topology issues.
create_distribution_nodeWriteAdd a source, transformer, meter, disconnect or transfer switch with its supply. Omitted fault-current fields are stored as not entered.
update_distribution_nodeWriteReplace a node, which may change its kind. Send every field, including fault-current fields, and the updatedAt you read.
delete_distribution_nodeDestructiveDelete a node. Names the equipment it supplied, which keeps its link and reports supply-target-missing.
get_riserReadRead the riser diagram's text: each node's box lines, each feeder tag, and every note, including each REQ explanation and warning, with the calculation date.
export_riserReadExport the riser diagram as SVG, with the calculation date.
get_loadsReadRead each node's Article 220 calculated load, both currents, category breakdown and service totals, with REQ, -- and unreviewed-data warnings.
export_loadsReadExport the loads sheet for the drawings as SVG: the service totals, then each piece of equipment in feeder order with its connected and calculated load and both currents, and the calculation date in its title block.
search_docsReadFind calculation methods, sizing states, issue codes, and code references.
get_fault_currentReadRead the available fault current at every bus, its point-to-point steps, and the 110.9 and 408.6 rating checks, with the calculation date and fingerprint to print beside any value.
export_fault_currentReadExport the available fault current table for the drawings as SVG: one row per bus with its rating checks and 110.24 service tag, and the calculation date and fingerprint in its title block.
calculate_voltage_dropReadCalculate one copper run's voltage drop at every size 14 AWG through 4/0, its minimum size and an installed size, without a project.
get_voltage_dropReadRead a project's feeder hops and branch circuits with each run's drop and the combined drop against 5 percent, mandatory on commercial projects.
export_voltage_dropReadExport the voltage drop sheet for the drawings as SVG: the combined check and why it is mandatory or advisory, each feeder hop, then the branch circuits by panel, and the calculation date in its title block.

Project, panel, and calculation results include links to the app. Write tools change the shared demo data. Your client controls whether to ask for approval. Circuit removal, panel deletion, and equipment deletion are marked destructive.

Supported calculations

Forewit calculates on read, from the saved schedules and the project's feeder tree, so every page, tool result, and export shows the same values. Each value traces to an entered input or a cited table value.

Panel analysis

Checks circuit placement, connected loads, overloads, and phase imbalance. Supported systems are 120/240 V single-phase, 120/208 V three-phase, and 277/480 V three-phase.

Conductor sizing

Sizes or checks one set of copper THHN/THWN-2 conductors, 14 AWG through 4/0, from a stated current basis: the breaker rating, a reviewed manual current, or, for a feeder, the calculated load of the panel or transformer it feeds. Connected current is for reference and cannot serve as the sizing current. Missing inputs leave sizing blocked. Use not-sized when you choose to omit sizing.

Feeder tree

Links each panel to the panel circuit or equipment that feeds it: utility and generator sources, transformers, meters, disconnects, and transfer switches. Forewit finds the service equipment from the tree and checks it for loops and system mismatches. Calculations follow a transfer switch's normal input.

Load calculations

The NEC Article 220 standard calculation for non-dwelling occupancies, at every panel, transformer, meter, disconnect, and transfer switch, and the total at each service. Demand factors apply once to each node's whole subtree. Each node reports two currents: the maximum load, and the load with 125 percent of its continuous loads.

Voltage drop

Each branch circuit and feeder run's drop at every conductor size and its minimum size for its allowance, 3 percent for branch circuits and 2 percent for feeders by default. The combined feeder and branch drop is checked against 5 percent: mandatory on a commercial project under the Florida Building Code, Energy Conservation, C405.5.3, and advisory otherwise.

Fault current

Available fault current at every bus by the point-to-point method, with motor contribution from a stated basis, and each panel's interrupting rating (110.9) and short-circuit current rating (408.6) checked against it. Every value prints with its calculation date and input fingerprint.

Riser diagram

Drawn from the feeder tree, with each panel's ratings and calculated values, each feeder's tag, and a note for every REQ value and warning. Export it as SVG.

Review before you rely on a result

  • REQ means an input is missing, and the result names it. Forewit never fills in an engineering input. A value shown as -- is not calculated: the equipment is not connected to the feeder tree, the value does not apply to it, or it is a generator that feeds only a transfer switch's alternate input, or a meter or disconnect between them, which Forewit does not evaluate.
  • Table values not yet checked against the printed code book still compute, and every result that uses one carries an unreviewed data warning: NEC Chapter 9 Table 9 for voltage drop, the C values for fault current, and the Article 220 tables for loads.
  • Dwelling-unit load calculations are not available yet. Leave a dwelling load without a load category; it reads REQ.
  • Fault current reads installed conductor sizes only. A feeder whose size is auto-selected reads RUN_CONDUCTOR_MISSING until you enter the installed size.
  • A feeder of 250 kcmil or larger on a panel circuit reads RUN_CONDUCTOR_MISSING, because conductor sizing stops at 4/0. A run entered on a link between equipment accepts sizes up to 1,000 kcmil and parallel sets for fault current.
  • Voltage drop calculates one set of copper conductors, 14 AWG through 4/0. A run with parallel sets, aluminum conductors, or a larger size reads REQ for voltage drop, with VOLTAGE_DROP_UNSUPPORTED_CONFIGURATION.
  • Interrupting ratings are checked for each panel, not for each breaker. Disconnect, meter, and transfer switch ratings are not checked.
  • Conduit fill is not calculated.

Use search_docs to look up calculation methods, issue codes, result states, and National Electrical Code references. The docs do not reproduce NEC text or tables.

Troubleshooting

My agent cannot find the tools

Enable Forewit for the current conversation and start a new session if needed. Ask the agent to call list_projects.

My client asks me to sign in

The demo does not require a login. Remove old bearer-token headers or OAuth settings and reconnect with the full URL ending in /mcp. A 401 response means the server requires authentication. Ask the server operator to enable demo mode or provide credentials.

The MCP URL shows an error in my browser

The /mcp address accepts requests from MCP clients. Add it in your agent's MCP settings, then ask the agent to list projects to test the connection. The /health URL confirms only that the server is reachable. If you get 500 server_misconfigured, ask the server operator to check the Worker configuration.

A value reads REQ or --

REQ means an input is missing. The tool result lists an issue code for it, and the riser prints a note. Enter the value from your source document, never a guess, and use search_docs to look up the code. A value shown as -- is not calculated. Usually the equipment is not connected to the feeder tree: link it with update_panel or on the Feeder tree tab. Linked equipment also shows -- where the value does not apply, such as a rating check on a transformer, and on a generator that feeds only a transfer switch's alternate input, with the meters and disconnects between them. Read the result's issues before you change a link.

The panel will not save, or sizing is blocked

Run analyze_panel and fix every issue with severity error. You can save a panel with blocked or failed conductor sizing, but those results remain unresolved. Use search_docs to look up each issue code and the inputs it requires.

The app does not show a change the agent saved

Read the panel again with get_panel, follow the returned link, and refresh the app. Edit in one place at a time. Stale saves return PANEL_WRITE_CONFLICT; read the latest panel and reapply the intended changes.