Home Developers Capabilities Numerical derivative

CVP verified calculation capability

Numerical derivative Calculation Capability

Forward, backward, or central finite difference of a polynomial, sin, or exp, plus a numeric two-sided limit. Discovery /two-sided-limit. Not symbolic d/dx.

Math · Numerical Capability ID math.numerical.derivative version 1.1.4 CVP VERIFIED CURRENT Core

Model

Forward

Inputs / Outputs

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

SymbolQuantityUnitRole
methodcentral/center/centred/centered; forward/fwd; backward/back/bwd; limit/lim/two_sided/twosided/two_sided_limit—input / output
integrandpoly/polynomial, sin, exp/e^x—input / output
fAlias of integrand; supplied aliases must agree—input
coeffs——input / output
coefficients——input
x——input / output
h——input / output
value——output
abs_err——output
left——output
right——output
gap——output
quantity——output

Trusted Math contract

Inspectable numeric contract for this Capability@Version. Not a rewrite of the engine.

FieldDeclaration
numeric_domainreal
exactnessfloat64
algorithmforward / backward / central finite difference; bounded-degree exact dyadic polynomial finite-step identities; sin addition identities and expm1/sinh stabilize elementary stencils; stable two-sided probe mean; 12 significant digits without nonzero clamping
valid_domainfinite decimal x; 0<h≤1, default1e-6 only when absent; poly degree≤8 with2–9 coefficients, sin/exp; supplied aliases agree
singularity_policyh ≤ 0 → VALUE_MUST_BE_POSITIVE; h > 1 → VALUE_OUT_OF_RANGE; non-finite probes, result or signed error and exp underflow to zero → NUMERICAL_RANGE_ERROR
branch_policynot applicable — real iterate
tolerancenote: step h is an input; truncation vs roundoff is not auto-balanced
convergencenot applicable — one-shot stencil, not an adaptive tableau
conditioningMathematical x±h retains supplied binary64 h even when rounded nodes collapse; polynomial intermediates are exact dyadic. Too-large h gives truncation error. Nonzero primary value/baseline underflow rejects; subnormal probes/gap/error may quantize to zero. abs_err is signed published value minus analytic binary64 baseline, not a bound.
roundingieee754_round_ties_to_even
overflowieee754_nonfinite_or_coded_error
reproducibilitydeterministic algorithm + Capability@Version
independent_oraclecvp:math.numerical.derivative O2 / Evidence published cases
golden_vectorsEvidence golden + boundary + property (and published_reference_case when listed)

Assumptions / Validity

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

Assumptions

Example

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

central poly 0,0,1 at x=3 → 6

Open this example in the calculator

Trust

CVP VERIFIED · CVP protocol 1.0.0-proposed · Core assurance · all published methods. Computational verification is defined by CVP. Supplemental domain review (internal) and named expert review are defined by the Review policy and do not by themselves determine CVP conformance.

CVP
CVP VERIFIED · CVP protocol 1.0.0-proposed · Core assurance · all published methods· View Manifest · CVP overview · Specification
Verified scope
all published methods
Assurance
Core
Declared partition coverage
PASS · 7/7 declared partitions (tiny-step, subnormal-exp, central, forward, backward, limit, invalid-domain)
Calculation version
1.1.4
Verification
14/14 calculation tests · 4/4 legacy golden · 3/3 legacy boundary · 7/7 legacy property
Production surface contract
6/6
Versions
Calculation 1.1.4 · CVP protocol 1.0.0-proposed · Evidence 2026-10-28.metric-scope-v3
Verification revision
2026-10-28.metric-scope-v3 · 1/1 property · digest 2f8a7989f6c9
Reference
O1 model · O2 expected_values · O2 numerical_behavior
Interfaces
PASS · UI (SSR) / REST / MCP
ui-ssr is query-result HTML, not a live browser session. Error-path engine·REST·MCP 3/3 (status, code, calculation_version). SSR compared on URL-canonical requested calculations; empty query is idle (not an error) and JSON-typed object/array inputs are REST/MCP-only. Raw HTTP REST/JSON-RPC transport rejection 5/5; raw-number source and conflicting pins are transport-only checks, not engine/SSR input-source parity.
CVP suite
255/255 golden · 2/2 CVP boundary · 16/16 invalid · 1/1 property · 2/2 metamorphic · 16/16 cross-interface · 1/1 cross-calculator · 6/6 CVP contract
Supplemental domain review
Not performed
Named expert review
Not performed
Version lock
Supported (409 VERSION_MISMATCH)
Artifact consistency
Build verified · 1.1.4 (workspace artifacts agree)
Review-policy tier
Engine tested — catalog token engine_tested; supplemental; not CVP status
This calculator CURRENT · Public schema 1.1.4 matches · Semantic contract ✓ · Production attested · 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/numerical-derivative' \
  -H 'Content-Type: application/json' \
  -d '{"inputs":{"method":"central","integrand":"poly","coeffs":[0,0,1],"x":3},"calculation_version":"1.1.4"}'

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

Full REST contract: REST API docs.

Tool id
numerical-derivative
Engine
numerical-derivative
REST
POST /api/v1/calc/numerical-derivative
MCP
execute_calculation with capability_id: "math.numerical.derivative"
Agent input schema
Canonical (MCP / Agent)
Output schema
JSON Schema (latest)
Versioned input schema
Immutable pin (1.1.4)
Versioned output schema
Immutable pin (1.1.4)

References

Human-readable sources plus CVP reference evidence classes.

Sources

Reference evidence classes: O1 model · O2 expected_values · O2 numerical_behavior

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":"math.numerical.derivative"},"_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.1.4) when the result must stay reproducible.

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