Verified calculation capability

Shear and moment Calculation Capability

Shear and bending moment at a cut in a simply supported span with point forces and concentrated moments. Reactions use math.linear_algebra solve. Not deflection and not a distributed load.

Mechanical · Statics Capability ID mechanical.statics.shear_moment version 1.0.0 UNPUBLISHED

Model

Reactions

Reactions: Ay + By + ΣFy = 0, By L + Σ(Fy x) + ΣM = 0
Section: V and M balance the left side of the cut

Inputs / Outputs

Canonical symbols for this capability. Agent schemas remain the contract.

Symbol	Quantity	Unit	Role
`L`	Span between supports, length	—	input / output
`s`	Section position from the left support	—	input / output
`forces`	Rows Fy,x	—	input
`moments`	Rows M,x	—	input
`Ay`	—	—	output
`By`	—	—	output
`V`	—	—	output
`M`	—	—	output
`model`	—	—	output
`solver`	—	—	output

Assumptions / Validity

Declared scope for this capability. Do not use it outside this domain.

Assumptions

Simply supported span
Point forces and concentrated moments only
Upward force and CCW moment are positive
A load exactly at the cut stays on the right
Not distributed load, deflection, or an indeterminate beam

Example

One numerical check. The calculator page holds worked steps and FAQ.

L=4, s=1, forces=-10,2 → V=-5 N, M=5 N·m

Open this example in the calculator

Trust

Review-policy: engine tested — automated tests, sources, version lock, and evidence published. Supplemental to CVP; not Domain Expert Review. See CVP and Review policy.

Tier: Engine tested — catalog token engine_tested
Calculation version: 1.0.0
Evidence tests: 6/6 calculation tests · golden 2/2 · boundary 4/4 · property 0/0
Engine tested: Yes
Source checked: Yes
Supplemental domain review: Not performed
Named expert review: Not performed
Version lock: Supported (409 VERSION_MISMATCH)
Artifact consistency: Build verified · 1.0.0 (workspace artifacts agree)

Production attestation: Embedded snapshot: unpublished · Build schema 1.0.0 ready · Semantic contract ✓ · Attestation report not published on origin · Live production status STALE (3 capabilities; 189 remain CURRENT) @ 2026-09-23T10:40:38.140Z
Semantic contract: PASS
Evidence attested at: 2026-09-23T02:27:54.588Z
Last production check: 2026-09-23T02:27:54.588Z
Public / cache: —
Origin: —

Call this capability

Human page, REST, and MCP share the same engine and calculation_version. Build verified hashes workspace artifacts only. After deploy, attest:production GETs canonical URLs twice — the public/cached view an Agent actually hits, and origin — including every /capabilities/{id} HTML page. Public Capability HTML version must match catalog before production attestation passes. Live Trust rows above fetch /.well-known/calculatorx-production-attestation.json and the output schema const. Build hashes: release integrity. That proves currently published page / engine / schema / evidence / MCP agree — not that a historical version is independently immutable. Reference Calculation Standard — Production surface contract 6/6.

curl -sS -X POST 'https://www.calculatorx.com/api/v1/calc/shear-moment' \
  -H 'Content-Type: application/json' \
  -d '{"inputs":{"L":4,"s":1,"forces":"-10,2"},"calculation_version":"1.0.0"}'

{
  "inputs": {
    "L": 4,
    "s": 1,
    "forces": "-10,2"
  },
  "calculation_version": "1.0.0"
}

POST /api/v1/calc/shear-moment. This is a POST calculate endpoint — do not GET it.

Full REST contract: REST API docs.

Tool id: shear-moment
Engine: shear-moment
REST: POST /api/v1/calc/shear-moment
MCP: execute_calculation with capability_id: "mechanical.statics.shear_moment"
Agent input schema: Canonical (MCP / Agent)
Output schema: JSON Schema (latest)
Versioned input schema: Immutable pin (1.0.0)
Versioned output schema: Immutable pin (1.0.0)

References

Human-readable sources plus CVP reference evidence classes.

Sources

Hibbeler, Engineering Mechanics: Statics — Internal loadings

Try with an agent

Inspect, then execute. Same engine as REST and the human calculator.

curl -sS -X POST 'https://www.calculatorx.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: inspect_capability' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"inspect_capability","arguments":{"capability_id":"mechanical.statics.shear_moment"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"calculatorx-docs-example","version":"1.0.0"},"io.modelcontextprotocol/clientCapabilities":{}}}}'

curl -sS -X POST 'https://www.calculatorx.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: execute_calculation' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"execute_calculation","arguments":{"capability_id":"mechanical.statics.shear_moment","inputs":{"L":4,"s":1,"forces":"-10,2"},"calculation_version":"1.0.0"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"calculatorx-docs-example","version":"1.0.0"},"io.modelcontextprotocol/clientCapabilities":{}}}}'

Pin calculation_version (1.0.0) when the result must stay reproducible.

Inspect the trust tier and required assurance level before execution. Full protocol notes: MCP docs.