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.

Claude CodeCodexCursorOther clients

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.

Edit and save a schedule

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

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.
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.
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.
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 18 tools. When your client connects, it gets the tool definitions and the inputs each accepts.

Available remote MCP tools and their behavior
Tool	Access	What it does
`list_projects`	Read	List projects with IDs and links.
`get_project`	Read	Read a project's details and panel summaries.
`create_project`	Write	Create a project and return its link.
`update_project`	Write	Replace all editable project fields. Read the project first and include unchanged fields.
`get_panel`	Read	Read a complete panel draft, including its circuits and app link.
`analyze_panel`	Read	Check circuit positions, loads, phase balance, and conductor sizing without saving.
`create_panel`	Write	Create an empty panel. Its name must be unique within the project.
`save_panel`	Write	Replace the complete panel and circuit list. The server recalculates conductor sizing.
`duplicate_panel`	Write	Copy a panel and its circuits within the same project.
`update_panel`	Write	Change supplied panel settings while preserving its circuits.
`add_circuit`	Write	Add a load circuit or spare to a panel.
`update_circuit`	Write	Edit breaker sizes, loads, or supplied circuit fields.
`move_circuit`	Write	Move a circuit or explicitly swap matching breakers.
`remove_circuit`	Destructive	Remove a circuit and its loads and sizing.
`autosize_panel`	Write	Enable automatic conductor sizing for unsized load circuits.
`export_panel`	Read	Export the saved schedule as SVG.
`delete_panel`	Destructive	Permanently delete a panel and all its circuits.
`search_docs`	Read	Find calculation methods, sizing states, issue codes, and code references.

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

Supported calculations

Panel analysis checks circuit placement, connected loads, overloads, and phase imbalance. It supports 120/240 V single-phase, 120/208 V three-phase, and 277/480 V three-phase systems.

Conductor sizing needs a stated current basis and reviewed inputs for each circuit. Calculated connected current is for reference and cannot serve as the required sizing current. Missing required inputs leave sizing blocked. Use not-sized when you choose to omit sizing.

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

Review unresolved checks

Review the assumptions and unresolved checks in the saved schedule. Leave missing engineering inputs unfilled. Forewit does not yet calculate whole-building demand, voltage drop, or conduit fill.

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.

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.