Deterministic
Same input, same result — the engines that power the public pages.
CalculatorX Developers
Deterministic engines with formulas, version locking, and verifiable evidence. One calculation layer for REST, MCP, and human-checkable results.
Call deterministic calculation engines over HTTP. Same results as the public calculators.
Learn more →Agent-native calculation: search_capabilities → inspect_capability → execute_calculation.
Connect →Embed supported calculators on your website with an iframe and optional theme parameters.
Learn more →The public, versioned protocol behind CalculatorX verification evidence and Trust Summary. Provenance · independent references · numerical policy · coverage · attestation.
Explore CVP →Computational verification is defined by the Calculator Verification Protocol (CVP). 88 capabilities also carry expert domain review — a supplemental signal under the Review policy, not a substitute for CVP.
For AI agents
Search a capability, inspect its schemas and limitations, then execute with a pinned
calculation_version.
Search → Inspect → Execute → Pin → Verify → Stay in scope.
POST JSON. A typical calculator API returns a number. CalculatorX also returns formula, version, and verification.
curl -X POST 'https://www.calculatorx.com/api/v1/calc/amps-to-va' \
-H 'Content-Type: application/json' \
-H 'CalculatorX-Spec-Version: 1.4.3' \
-d '{"inputs":{"mode":"amps-va","primary":12,"volts":230,"phase":"single"}}'const res = await fetch('https://www.calculatorx.com/api/v1/calc/amps-to-va', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'CalculatorX-Spec-Version': '1.4.3' },
body: JSON.stringify({
"inputs": {
"mode": "amps-va",
"primary": 12,
"volts": 230,
"phase": "single"
}
})
});
const data = await res.json();
console.log(data.result_detail, data.formula);import json, urllib.request
req = urllib.request.Request(
'https://www.calculatorx.com/api/v1/calc/amps-to-va',
data=json.dumps({
"inputs": {
"mode": "amps-va",
"primary": 12,
"volts": 230,
"phase": "single"
}
}).encode(),
headers={'Content-Type': 'application/json', 'CalculatorX-Spec-Version': '1.4.3'},
method='POST',
)
with urllib.request.urlopen(req) as r:
print(json.load(r))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":1,"method":"tools/call","params":{"name":"execute_calculation","arguments":{"capability_id":"electrical.apparent_power","inputs":{"mode":"amps-va","primary":12,"volts":230,"phase":"single"},"calculation_version":"1.4.3"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"calculatorx-docs-example","version":"1.0.0"},"io.modelcontextprotocol/clientCapabilities":{}}}}'{
"result": 2760,
"result_detail": {
"value": 2760,
"unit": "VA",
"formatted": "2,760 VA"
},
"formula": {
"expression": "S = V_RMS × I_RMS"
},
"calculation_version": "1.4.3",
"verification": {
"engine_tested": true,
"expert_reviewed": false
}
}Trimmed success body for 12 A × 230 V → 2,760 VA. Full responses also include assumptions, warnings, evidence, and the resolved engine. verification.engine_tested is not expert review.
Use capability_id when you need a stable semantic identity. REST tool_id is a human-friendly alias. engine is the implementation that ran — do not couple client logic to it.
| Kind | Example | Role |
|---|---|---|
capability_id | electrical.apparent_power | Canonical semantic ID — MCP and the catalog |
tool_id | amps-to-va | REST / page alias — POST /api/v1/calc/amps-to-va |
engine | amps-va | Resolved implementation in the response — do not bind to this |
Same input, same result — the engines that power the public pages.
Pin calculation_version so formula changes cannot silently shift production numbers.
Inspectable artifacts — formulas, schemas, tests, digests — published with each capability.
CVP defines which evidence is sufficient. Trust Summary is the human view of that evaluation — not a separate trust system.