Cable ampacity connector — draft user docs

DRAFT — pending owner approval. Not yet published.

Owner: CDK AI System. Contact: chedy028@cdkaisystem.com.

What it does

This connector calculates cable ratings. You give it a cable, an installation, and a site, and it returns currents, temperatures, losses, and the warnings the calculation produced.

The public server is calculation tools only. It does not return the text of IEC or CIGRE publications. Two tools that search and return standards text (search_standard and get_chunk) are left off this server.

There is no user account. When Claude asks how to sign in, choose No sign in, and do not add a request header.

Add it in Claude by URL

The connector URL is:

https://cable-ampacity-mcp.onrender.com/mcp

Claude connects to that URL from Anthropic’s network, over HTTPS on port 443.

On an individual Pro or Max plan:

  1. Open Customize > Connectors.
  2. Click + Add, then Add custom connector.
  3. Name it (for example, Cable ampacity).
  4. Paste the URL above, including /mcp. Continue.
  5. Leave authentication as No sign in. Do not add a request header.
  6. Add the connector.

A link that opens the same dialog with the name and URL filled in:

https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Cable%20ampacity&connectorUrl=https%3A%2F%2Fcable-ampacity-mcp.onrender.com%2Fmcp

The link only fills the form. You still confirm it.

On Team and Enterprise, an Owner adds the connector under Organization settings > Connectors (Add > Custom > Web) with the same URL and No sign in. Members then connect it from Customize > Connectors. The same prefilled link for an Owner is:

https://claude.ai/admin-settings/connectors?modal=add-custom-connector&connectorName=Cable%20ampacity&connectorUrl=https%3A%2F%2Fcable-ampacity-mcp.onrender.com%2Fmcp

Tools

Each line is the tool name and what that call returns.

rate_cable, select_cable, run_study, and list_cable_library use request schema cable-server/v1.

Scope limits and warnings

Results are the calculation the matching tool describes. Read the warnings on the result. A verified-envelope flag says whether that configuration is one of the release-gate cases, not whether the number is a finished design.

Two-conductor proximity factor. For a two-core cable (cable_type two_core) and for two single-core cables in flat formation (cable_formation two_flat), if the calculated proximity argument xp is above 2.8 the result includes this warning and still returns the rating:

Warning: IEC 60287-1-1 5.1.4 gives the proximity effect for xp up to 2.8 (here xp = …); this rating uses the formula outside its stated accuracy

At xp of 2.8 or below, that warning is not added.

Screening estimate. compute_ampacity is a preliminary estimate. It is not the IEC 60287 rating.

Site ambient, phase 1. site_ambient uses stations within 150 km, 1.5 degrees of latitude, and 300 m of elevation, with at least 10 complete years. It works within the probe depths (SCAN to 40 in). It has no pavement allowance and no warming allowance. An ambient more than 1 K below the site value is flagged. The flag does not change your input.

Route studies. A section the study does not cover stays at its steady rating only where that is a safe lower bound, and is otherwise left open. The result says which.

Rate limits

The cap is counted per network address, not per person.

A request over the cap gets HTTP 429, with Retry-After and X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. GET /health and GET /status do not spend the cap.

Saved runs

Six tools save each successful calculation as a run, and get_run reads it back by its run_id. A run is deleted 7 days after it was made, or sooner when the server restarts or is redeployed. Anyone who has a run_id can read that run, so share it only with people who may see the calculation.

Checking a result

Each result shows its method and inputs so it can be checked.

Example prompts

  1. “Rate a 132 kV XLPE cable to IEC 60287: 630 mm² copper conductor, 30.3 mm diameter, R20 0.0283 ohm/km, 1.5 mm conductor screen, 15.5 mm XLPE insulation, 1.3 mm insulation screen, 0.8 mm aluminium sheath, 3.5 mm PE oversheath, 90 °C max conductor temperature, 50 Hz. Three cables in trefoil, cross-bonded, direct buried 1.2 m deep in soil of 1.0 K·m/W at 20 °C ambient.”
  2. “For the same cable and installation, what current can it carry for 6 hours if it has been running at 800 A?”
  3. “What 1-second short-circuit current can the 0.8 mm aluminium sheath carry? Mean sheath diameter 67.7 mm, semiconducting XLPE screen inside, PE oversheath outside, 80 °C before the fault and 250 °C limit.”
  4. “From the cable library, pick the smallest cable that carries 400 A, three cables in trefoil, cross-bonded, direct buried 1 m deep in soil of 1.0 K·m/W at 20 °C ambient, 50 Hz.”

Prompt 2 follows prompt 1 in the same conversation.

Troubleshooting

Contact

Questions and corrections: chedy028@cdkaisystem.com. Owner: CDK AI System.