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:
- Open Customize > Connectors.
- Click + Add, then Add custom connector.
- Name it (for example, Cable ampacity).
- Paste the URL above, including
/mcp. Continue. - Leave authentication as No sign in. Do not add a request header.
- 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.
list_standards_packs— Lists the pinned standards packs and whether each pack’s files check out.compute_ampacity— A preliminary screening estimate. For an IEC 60287 rating, usecompute_ampacity_iec.compute_ampacity_iec— Full IEC 60287 rating. The result echoes the input and includes a snapshot hash and a ledger hash.compute_ampacity_neher_mcgrath— Neher-McGrath (AIEE 1957) rating, as an alternative to IEC 60287. It is for the cases that tool describes (identical equally loaded single-conductor cables, lead sheaths open-circuited, 60 Hz, with a daily loss factor).economic_conductor_size— Economic conductor size by IEC 60287-3-2. This is a sizing, not a rating.assign_circuits— Which circuit goes in which duct-bank or trench position so the group carries the most.rate_route— Rates a circuit section by section. The lowest section rating is the circuit rating.route_study— A cyclic, emergency, or soil-drying study on every section of a route. The lowest section governs.site_ambient— Design ambient soil temperature at cable depth for a US site, from a table of measured station data shipped with the server. It does not change the temperature you typed.short_circuit_rating— Permissible short-circuit currents of a cable’s components by IEC 60949, adiabatic and non-adiabatic.cyclic_rating_factor— Cyclic rating factor M of a buried cable by IEC 60853-1 or -2, and the cycle’s peak current.transient_temperature— Conductor temperature rise after a step of current, by IEC 60853-2.emergency_rating— Emergency current a cable may carry for a period after a steady load, by IEC 60853-2.list_iec_capabilities— What the IEC 60287 method supports, and how each item was checked, before you run it.get_run— An earlier calculation that was stored on this server: its outputs and its ledger events. You need therun_idthat call returned.health— Whether the standards packs and the database respond.rate_cable— Rates one cable from the library, or from a construction you send, in one installation. Returns amps, conductor temperature, losses, thermal resistances, the method, a verified-envelope flag, and warnings.select_cable— The smallest candidate cable that carries a load in one installation.run_study— Every cable, times every burial layout, times every load case. At most 200 runs. A larger study is refused before anything runs.list_cable_library— The cable constructions the server can rate, with the source of each value. A field the source does not give is left out, and that cable is then not rateable.
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.
- Claude reaches the connector from Anthropic’s published outbound addresses (160.79.104.0/21 and 153.61.208.0/20). All requests from those addresses share one cap of 600 requests per 60 seconds.
- Any other address is limited to 60 requests per 60 seconds.
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
- “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.”
- “For the same cable and installation, what current can it carry for 6 hours if it has been running at 800 A?”
- “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.”
- “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
- “Couldn’t reach the MCP server” when adding it. Check that the URL ends in
/mcpand that authentication is No sign in, with no request header. - HTTP 429 or “rate_limit”. The shared cap was reached. Wait the number of seconds in
Retry-After, then ask again. - A result that is an
errorobject. The message names the input that was rejected. Correct that value and ask again. get_runfinds no run. Runs are deleted after 7 days, or when the server restarts or is redeployed. Run the calculation again.- A warning on a result. Part of the input is outside the stated range of the method. Read the warning before you use the number.
- Anything else. Write to the contact below with the prompt you used and the tool result.
Contact
Questions and corrections: chedy028@cdkaisystem.com. Owner: CDK AI System.