StructuralMind

For engineers who build and integrate

Build with the StructuralMind API.

StructuralMind is API-first. Every calculation is exposed as a REST API endpoint. Call the same deterministic engine you use in the web app from inside the tools you already use every day — your structural software, your own automation, BIM models, and even Excel. Call the same REST API from your AI agents or your own MCP server.

api.structuralmind.com
POST /api/v1/rc-column/check
KEY: sm_...

{ "geometry": { "b_mm": 400, "h_mm": 400 },
  "loads": [{ "N_kN": 800, "M1_kNm": 120 }],
  "concrete": { "grade": "C30" },
  "audit": true }
{ "success": true,
  "governing_combo": {
    "dc_ratio": 0.86, "passed": true } }

Call it from the tools you already use

StructuralMind API One REST API · JSON + Glass Box Call from the tools you use: BIM platformsRevit · Archicad · Tekla · … Analysis & design softwareSAP2000 · ETABS · STAAD.Pro · … AutomationExcel · Python · Plugins … AIAI agents · MCP

How the API works

One endpoint per calculation

Every calculation is a typed REST API endpoint with explicit inputs and outputs.

Deterministic results

The same request always returns the same result. Reproducible, testable and safe for automation.

Glass Box over the API

On demand, every design step returns as JSON: a plain-text description, a LaTeX formula (symbolic + numeric substitution), the relevant code clause, and a pass/fail result. Render the formulas verbatim in your own UI.

A worked example

Send your input data; get structured results and (optionally) every intermediate step as JSON.

POST/api/v1/rc-column/checkRequest
KEY: sm_...
{
"geometry": { "section_type": "rectangular", "b_mm": 400, "h_mm": 400 },
"loads": [
{ "label": "G+Q", "forces": { "N_kN": 800, "M1_kNm": 120, "M2_kNm": 40 } }
],
"concrete": { "standard": "TS500", "grade": "C30", "model": "hognestad" },
"steel": { "standard": "TS500", "grade": "B420C", "model": "bilinear" },
"rebar": {
"layout_type": "rectangular",
"corner": { "diameter_mm": 20, "count": 4 },
"intermediate_x": { "diameter_mm": 16, "count": 2 },
"intermediate_y": { "diameter_mm": 16, "count": 2 }
},
"stirrup": { "shape": "rectangular", "diameter_mm": 8, "spacing_mm": 150 },
"audit": true,
"language": "en"
}
200 OKapplication/json
{
"success": true,
"result": {
"governing_combo": {
"label": "G+Q", "N_kN": 800, "M1_kNm": 120,
"dc_ratio": 0.86, "passed": true
},
"audit_trail": {
"steps": [
{
"step_id": "flexure_capacity_check",
"category": "flexure",
"description": "Flexural capacity (N–M interaction)",
"clause": "TS500 7.1",
"formula": "M_d / M_r = 120 / 139.5 = 0.86 ≤ 1.0",
"formula_latex": "\\dfrac{M_d}{M_r} = \\dfrac{120}{139.5} = 0.86 \\le 1.0",
"result": 0.86,
"passed": true
}
],
"code_ref": "TS500:2000"
}
}
}

The Glass Box formula, visualized

audit_trail contains each design step as 'Description', 'LaTeX formula (symbolic + numeric substitution)', 'Code clause' and 'Design status' — the same Glass Box as the web app, returned as JSON.

TS500 7.1passed
MdMr=120139.5=0.861.0\dfrac{M_d}{M_r} = \dfrac{120}{139.5} = 0.86 \le 1.0

Field names and structure are from the real API schema; the numeric values are illustrative.

Built for AI agents

We designed the StructuralMind API, so that, autonomous AI agents — not just developers — can call it with high accuracy. Agents don't have to guess: they know what to send and get consistent, verifiable results.

Right on the first tryevery endpoint is crafted so agents form correct calls.

Rules, not guessworkdeterministic, code-based, traceable results.

Ready for AI workflowsa natural fit for agent- and MCP-based automation.

Authentication & keys

Send your personal secret API key in the request header. API keys are issued on the Studio and Enterprise plans and managed in-app.

  • Header-based authentication over HTTPS
  • Multiple named keys, each with a required expiry
  • Revoke keys at any time

Rate limits & pricing

  • Studio: 2,000 API calls/month (shared across the organization)
  • Enterprise: custom limits
  • Stops when the quota is reached (no overage/extra usage yet)

Full reference for licensed API users

API documentation is available for Studio and Enterprise users; the complete, always-current reference — every calculation's parameters, schema and error codes — lives in-app, so it stays in sync with the engine.

Get API access

Start calculating in minutes.

Sign up, pick a calculation, and produce your first auditable report.