omni_universal_query
Query any OmniOperand deterministic calculator by category and slug when no dedicated tool exists; pass solver parameters to get computed metrics.
Instructions
Universal OmniOperand Dynamic Dispatcher: Dynamic calculation gateway allowing AI agents to query any of OmniOperand's 428+ deterministic engines across all 15 disciplines (finance, construction, engineering, geometry, biotech, logistics, health, legal, energy, crypto, agriculture, math).
USAGE GUIDELINES & SIBLING ROUTING:
SIBLING ROUTING (CRITICAL MANDATE): Always PREFER dedicated specialist tools (such as 'omni_octagon_solver', 'omni_regular_polygon_solver', 'omni_hvac_manual_j_solver', 'omni_sepp_72t_solver', 'omni_mortgage', 'omni_concrete_volume') when available. Dedicated tools provide native parameter validation, zero network latency, and compiled typing.
WHEN TO USE: Use omni_universal_query ONLY as a fallback dispatcher when querying an edge calculator slug that does not have a dedicated wrapper or when discovering parameters across disciplines dynamically.
PARAMETER KEY DISCOVERY: The 'params' object accepts a key-value dictionary matching the input fields of the target solver (e.g. for category='construction', slug='concrete-volume': { length_ft: 20, width_ft: 12, depth_in: 4 }; for category='finance', slug='mortgage': { loan_amount: 400000, interest_rate_pct: 6.5, loan_term_years: 30 }). Parameter names follow snake_case with explicit unit suffixes.
EXECUTION SAFETY & ERROR BEHAVIOR:
Pure deterministic query dispatch via HTTPS POST to Cloudflare Pages edge isolates (https://omnioperand.com/api/v1/[category]/[slug]/).
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Error Handling: If parameter keys are missing or invalid, returns a structured JSON object with status 'error' or 'fallback' detailing the field error and providing the canonical interactive solver URL. Never throws uncaught exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success", "error", or "fallback"
calculator (string): Target calculator slug
category (string): Discipline category
name (string): Human-readable calculator title
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Key-value dictionary of computed numerical metrics and unit-formatted display strings
execution_time_ms (number): Edge isolate execution latency in milliseconds
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"category": "<category>",
"slug": "<slug>",
"params": "<params>"
},
"name": "omni_universal_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Exact calculator URL slug (e.g. 'concrete-volume', 'wire-gauge-voltage-drop', 'centrifuge-rcf-g-force', 'gutter-downspout-sizing'). | |
| params | Yes | Key-value parameter dictionary matching the target solver's input requirements (e.g. { length_ft: 20, width_ft: 12, depth_in: 4 }). | |
| category | Yes | Discipline category directory (e.g. 'finance', 'engineering', 'biotech', 'construction', 'geometry', 'logistics', 'legal', 'energy'). |