Skip to main content
Glama

Analyze a 3D steel frame (finite elements, returns the numbers)

analyze_frame
Read-onlyIdempotent

Runs a 3D finite-element frame analysis and returns the numbers: equilibrium check, largest deflection along the members, largest joint displacement and sway in X and Y, every support reaction, the axial force, shears and moments of every member (the envelope with the governing combination when there are several), and natural periods with mass participation (modal analysis); linear or second order (P-Delta). The model is either a template (a pitched portal frame building, an open mono-pitch canopy, or a multi-storey frame, from a few dimensions, sections and loads) or a full model in JSON (nodes, members, sections, supports, loads, combinations). It is solved by the code of Structomat's free 3D frame analysis page, so the result also has a link that shows the same model and results in 3D (deflected shape, force diagrams, mode shapes). Use it to check a frame, compare sections or see how loads flow, and run it again with changed sections or loads. The result also has a preliminary member check to AISC 360-16 LRFD (results.member_check): the demand-to-capacity ratio of each member with the governing check, combination and point, for IPE, HEA, HEB, CHS and SHS sections and I or tube sections with dimensions; effective length factor K = 1 and unbraced length Lb = member length unless set (beam_unbraced_m, column_unbraced_m, or "check" on a model member). The forces are elastic second order without notional loads or stiffness reduction (not the direct analysis method): K = 1 holds only when the second-order sway is at most 1.1 times the linear sway, otherwise K must come from a stability analysis; a linear run gives no valid check; connections, seismic provisions and fire are not covered, and code load combinations only through combination_set. The model is not stored.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "analyze_frame"
  }
}

Input Schema

NameRequiredDescriptionDefault
basesNoColumn bases (default fixed).
modalNoAlso run a modal analysis: natural periods, mode shapes and mass participation (default true).
modelNoInstead of a template: a full model, units kN and m, Z vertical. {"up":"Z", "nodes":{"N1":[x,y,z],...}, "members":[{"id":"M1","i":"N1","j":"N2","sec":"S1","rot":0,"pinned":false}], "sections":{"S1":{"A":m2,"Iy":m4 weak,"Iz":m4 strong,"J":m4}}, "supports":{"N1":"fixed"|"pinned"}, "nodeLoads":[{"node":"N2","case":"G"|"Q"|"W","F":[Fx,Fy,Fz]}], "memberLoads":[{"member":"M1","case":"G","dir":"FX"|"FY"|"FZ","w":kN_per_m}], "combos":[{"name":"ULS1","factors":{"G":1.35,"Q":1.5}}], "selfWeight":true, "analysis":"pdelta"|"linear", "modal":{"modes":12,"G":1,"Q":0.3}}. Load cases may have any name; several combinations are solved and shown with their envelope (a single "combo":{...} is still accepted). Gravity loads act in -FZ. A member load may vary from w to w2 between x1 and x2 (m from the i end). "pinned": true releases bending at both ends, "i" or "j" at one end. The modal mass may use any load case, e.g. {"modes":12,"G":1,"S":0.3}. A vertical member has its web (local axis 2) along X; "rot":90 turns it to Y. Without "up":"Z" the older format with Y vertical is read and converted. Steel E = 210 GPa. Member check: give each section a standard "name" (e.g. "HEA 300", "CHS 139.7x5", "SHS 100x100x5") or it is analysed but not checked; a member may carry "check":{"Lcx":m,"Lcy":m,"Lcz":m,"Lb":m} (Lcx about the strong axis, Lcz torsional, default the member length); a member with a free end is checked as a cantilever (Cb = 1.0).
bays_xNostorey: bays in X.
bays_zNostorey: bays in Y (the second horizontal direction; Z is vertical).
framesNoportal, mono: number of frames.
span_mNoportal (4-60) or mono (3-30): frame span, m.
bay_x_mNostorey: bay width in X, m.
bay_z_mNostorey: bay width in Y, m.
factorsNoCombination factors {"G":1.0,"Q":1.0,"W":1.0} (default all 1.0).
storeysNostorey: number of storeys.
analysisNoSecond order (default) or linear.
templateNoportal = pitched portal frame building; mono = open mono-pitch canopy; storey = multi-storey frame. Omit when sending model.
column_webNoDirection of the column webs: x (default) = strong axis resists sway in X, the frame direction; y = strong axis resists sway in Y.
dead_kN_m2NoDead load on roof/floor, kN/m2 (self-weight of members is added).
live_kN_m2NoLive or snow load, kN/m2.
wind_kN_m2Noportal, storey: wind pressure on the windward face (see wind_direction); mono: net wind pressure on the roof, positive upward (uplift); kN/m2.
steel_gradeNoSteel for the member check: S235, S275, S355 (default; S..H for tubes) or ASTM (A992 for I-sections, A500 Gr. C for tubes).
beam_sectionNoHot-rolled I-section for beams / rafters.
low_height_mNomono: height of the low side, m.
ridge_rise_mNoportal: ridge rise above eave, m.
brace_sectionNoportal, mono: hollow section for the bracing (default CHS 139.7x5).
eave_height_mNoportal: eave height, m.
high_height_mNomono: height of the high side, m.
leeward_kN_m2Noportal, storey: leeward suction, kN/m2 (not used for mono).
column_sectionNoHot-rolled I-section for columns.
wind_directionNoportal, storey: x (default) = wind on the long wall / the face at X = 0; y = wind on the gable / the face at Y = 0; xy = both together in the same combination (conservative).
beam_unbraced_mNoportal, mono, storey: unbraced length Lb of the beams / rafters for lateral-torsional buckling in the member check, m (spacing of purlins or other restraints of the compression flange; default the member length).
combination_setNosingle (default) = one combination with the factors given; en = a typical EN 1990 ultimate set (expression 6.10); asce = ASCE 7 LRFD basic combinations. en and asce are solved as an envelope.
frame_spacing_mNoportal, mono: frame spacing, m.
storey_height_mNostorey: storey height, m.
modal_live_shareNoShare of the live or snow load in the modal mass, psi (default 0.3); mass = self-weight + dead + psi x live.
column_unbraced_mNoportal, mono, storey: unbraced length Lb of the columns in the member check, m (spacing of girts or other restraints; default the member length).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / model / description
      Previous value: -"Instead of a template: a full model, units kN and m, Z vertical. {\"up\":\"Z\", \"nodes\":{\"N1\":[x,y,z],...}, \"members\":[{\"id\":\"M1\",\"i\":\"N1\",\"j\":\"N2\",\"sec\":\"S1\",\"rot\":0,\"pinned\":false}], \"sections\":{\"S1\":{\"A\":m2,\"Iy\":m4 weak,\"Iz\":m4 strong,\"J\":m4}}, \"supports\":{\"N1\":\"fixed\"|\"pinned\"}, \"nodeLoads\":[{\"node\":\"N2\",\"case\":\"G\"|\"Q\"|\"W\",\"F\":[Fx,Fy,Fz]}], \"memberLoads\":[{\"member\":\"M1\",\"case\":\"G\",\"dir\":\"FX\"|\"FY\"|\"FZ\",\"w\":kN_per_m}], \"combos\":[{\"name\":\"ULS1\",\"factors\":{\"G\":1.35,\"Q\":1.5}}], \"selfWeight\":true, \"analysis\":\"pdelta\"|\"linear\", \"modal\":{\"modes\":12,\"G\":1,\"Q\":0.3}}. Load cases may have any name; several combinations are solved and shown with their envelope (a single \"combo\":{...} is still accepted). Gravity loads act in -FZ. A member load may vary from w to w2 between x1 and x2 (m from the i end). \"pinned\": true releases bending at both ends, \"i\" or \"j\" at one end. The modal mass may use any load case, e.g. {\"modes\":12,\"G\":1,\"S\":0.3}. A vertical member has its web (local axis 2) along X; \"rot\":90 turns it to Y. Without \"up\":\"Z\" the older format with Y vertical is read and converted. Steel E = 210 GPa. Member check: give each section a standard \"name\" (e.g. \"HEA 300\", \"CHS 139.7x5\", \"SHS 100x100x5\") or it is analysed but not checked; a member may carry \"check\":{\"Lcx\":m,\"Lcy\":m,\"Lb\":m} (Lcx about the strong axis)."New value: +"Instead of a template: a full model, units kN and m, Z vertical. {\"up\":\"Z\", \"nodes\":{\"N1\":[x,y,z],...}, \"members\":[{\"id\":\"M1\",\"i\":\"N1\",\"j\":\"N2\",\"sec\":\"S1\",\"rot\":0,\"pinned\":false}], \"sections\":{\"S1\":{\"A\":m2,\"Iy\":m4 weak,\"Iz\":m4 strong,\"J\":m4}}, \"supports\":{\"N1\":\"fixed\"|\"pinned\"}, \"nodeLoads\":[{\"node\":\"N2\",\"case\":\"G\"|\"Q\"|\"W\",\"F\":[Fx,Fy,Fz]}], \"memberLoads\":[{\"member\":\"M1\",\"case\":\"G\",\"dir\":\"FX\"|\"FY\"|\"FZ\",\"w\":kN_per_m}], \"combos\":[{\"name\":\"ULS1\",\"factors\":{\"G\":1.35,\"Q\":1.5}}], \"selfWeight\":true, \"analysis\":\"pdelta\"|\"linear\", \"modal\":{\"modes\":12,\"G\":1,\"Q\":0.3}}. Load cases may have any name; several combinations are solved and shown with their envelope (a single \"combo\":{...} is still accepted). Gravity loads act in -FZ. A member load may vary from w to w2 between x1 and x2 (m from the i end). \"pinned\": true releases bending at both ends, \"i\" or \"j\" at one end. The modal mass may use any load case, e.g. {\"modes\":12,\"G\":1,\"S\":0.3}. A vertical member has its web (local axis 2) along X; \"rot\":90 turns it to Y. Without \"up\":\"Z\" the older format with Y vertical is read and converted. Steel E = 210 GPa. Member check: give each section a standard \"name\" (e.g. \"HEA 300\", \"CHS 139.7x5\", \"SHS 100x100x5\") or it is analysed but not checked; a member may carry \"check\":{\"Lcx\":m,\"Lcy\":m,\"Lcz\":m,\"Lb\":m} (Lcx about the strong axis, Lcz torsional, default the member length); a member with a free end is checked as a cantilever (Cb = 1.0)."
  2. Changed4 schema fields changed
    • addedInput schema / properties / beam_unbraced_m
      Added value: +{
      +  "description": "portal, mono, storey: unbraced length Lb of the beams / rafters for lateral-torsional buckling in the member check, m (spacing of purlins or other restraints of the compression flange; default the member length).",
      +  "maximum": 60,
      +  "minimum": 0.1,
      +  "type": "number"
      +}
    • addedInput schema / properties / column_unbraced_m
      Added value: +{
      +  "description": "portal, mono, storey: unbraced length Lb of the columns in the member check, m (spacing of girts or other restraints; default the member length).",
      +  "maximum": 60,
      +  "minimum": 0.1,
      +  "type": "number"
      +}
    • changedInput schema / properties / model / description
      Previous value: -"Instead of a template: a full model, units kN and m, Z vertical. {\"up\":\"Z\", \"nodes\":{\"N1\":[x,y,z],...}, \"members\":[{\"id\":\"M1\",\"i\":\"N1\",\"j\":\"N2\",\"sec\":\"S1\",\"rot\":0,\"pinned\":false}], \"sections\":{\"S1\":{\"A\":m2,\"Iy\":m4 weak,\"Iz\":m4 strong,\"J\":m4}}, \"supports\":{\"N1\":\"fixed\"|\"pinned\"}, \"nodeLoads\":[{\"node\":\"N2\",\"case\":\"G\"|\"Q\"|\"W\",\"F\":[Fx,Fy,Fz]}], \"memberLoads\":[{\"member\":\"M1\",\"case\":\"G\",\"dir\":\"FX\"|\"FY\"|\"FZ\",\"w\":kN_per_m}], \"combos\":[{\"name\":\"ULS1\",\"factors\":{\"G\":1.35,\"Q\":1.5}}], \"selfWeight\":true, \"analysis\":\"pdelta\"|\"linear\", \"modal\":{\"modes\":12,\"G\":1,\"Q\":0.3}}. Load cases may have any name; several combinations are solved and shown with their envelope (a single \"combo\":{...} is still accepted). Gravity loads act in -FZ. A member load may vary from w to w2 between x1 and x2 (m from the i end). \"pinned\": true releases bending at both ends, \"i\" or \"j\" at one end. The modal mass may use any load case, e.g. {\"modes\":12,\"G\":1,\"S\":0.3}. A vertical member has its web (local axis 2) along X; \"rot\":90 turns it to Y. Without \"up\":\"Z\" the older format with Y vertical is read and converted. Steel E = 210 GPa."New value: +"Instead of a template: a full model, units kN and m, Z vertical. {\"up\":\"Z\", \"nodes\":{\"N1\":[x,y,z],...}, \"members\":[{\"id\":\"M1\",\"i\":\"N1\",\"j\":\"N2\",\"sec\":\"S1\",\"rot\":0,\"pinned\":false}], \"sections\":{\"S1\":{\"A\":m2,\"Iy\":m4 weak,\"Iz\":m4 strong,\"J\":m4}}, \"supports\":{\"N1\":\"fixed\"|\"pinned\"}, \"nodeLoads\":[{\"node\":\"N2\",\"case\":\"G\"|\"Q\"|\"W\",\"F\":[Fx,Fy,Fz]}], \"memberLoads\":[{\"member\":\"M1\",\"case\":\"G\",\"dir\":\"FX\"|\"FY\"|\"FZ\",\"w\":kN_per_m}], \"combos\":[{\"name\":\"ULS1\",\"factors\":{\"G\":1.35,\"Q\":1.5}}], \"selfWeight\":true, \"analysis\":\"pdelta\"|\"linear\", \"modal\":{\"modes\":12,\"G\":1,\"Q\":0.3}}. Load cases may have any name; several combinations are solved and shown with their envelope (a single \"combo\":{...} is still accepted). Gravity loads act in -FZ. A member load may vary from w to w2 between x1 and x2 (m from the i end). \"pinned\": true releases bending at both ends, \"i\" or \"j\" at one end. The modal mass may use any load case, e.g. {\"modes\":12,\"G\":1,\"S\":0.3}. A vertical member has its web (local axis 2) along X; \"rot\":90 turns it to Y. Without \"up\":\"Z\" the older format with Y vertical is read and converted. Steel E = 210 GPa. Member check: give each section a standard \"name\" (e.g. \"HEA 300\", \"CHS 139.7x5\", \"SHS 100x100x5\") or it is analysed but not checked; a member may carry \"check\":{\"Lcx\":m,\"Lcy\":m,\"Lb\":m} (Lcx about the strong axis)."
    • addedInput schema / properties / steel_grade
      Added value: +{
      +  "description": "Steel for the member check: S235, S275, S355 (default; S..H for tubes) or ASTM (A992 for I-sections, A500 Gr. C for tubes).",
      +  "enum": [
      +    "S235",
      +    "S275",
      +    "S355",
      +    "ASTM"
      +  ],
      +  "type": "string"
      +}
  3. First observed

TDQS

A4.1/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare a read-only, idempotent, non-destructive call, and the description goes well beyond them: the model is not stored, results come with a 3D viewer link, solves are elastic second order without notional loads or stiffness reduction (explicitly not the direct analysis method), K=1 holds only when second-order sway is at most 1.1x linear sway, connections/seismic/fire are not covered, and code combinations only come from combination_set. These are exactly the caveats an agent needs before trusting results.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One long paragraph, but it is front-loaded: outputs first, then input modes, then the member-check caveats. Every clause carries content relevant to a 33-parameter tool, though the heavy parenthetical nesting (e.g. the K/Lb sentence, the 'not the direct analysis method' aside) makes it harder to scan than a bulleted structure would.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, so the description carries the full burden of describing returns, and it does so thoroughly: equilibrium check, deflections, sway, reactions, force envelopes with governing combination, modal periods with mass participation, plus the results.member_check demand-to-capacity structure. Combined with the limitation disclosures, an agent has enough to call and interpret the tool without further context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the schema descriptions are already very detailed (template names, units, local axes, rot, pinned releases, combination factors), so the schema does the heavy lifting. The description reinforces a few points (Z up, gravity in -FZ, combo envelope with single-combo backwards compatibility, Lb defaults, K=1) but adds little that is not already in the nested model/template schemas. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource: 'Runs a 3D finite-element frame analysis and returns the numbers', then enumerates the outputs (equilibrium, deflections, reactions, member forces, modal periods). It also distinguishes the two input modes (template vs full JSON model). It does not name siblings such as check_steel_members or estimate_portal_frame_steel, so the boundary with the standalone member-check tool is left to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete usage contexts: 'Use it to check a frame, compare sections or see how loads flow, and run it again with changed sections or loads.' It also states when the built-in member check is NOT valid (linear run, sway ratio above 1.1, K needing a stability analysis), which is strong conditional guidance. It stops short of explicitly routing to alternatives, so no exclusion list.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources