Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

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

NameRequiredDescriptionDefault
slugYesExact calculator URL slug (e.g. 'concrete-volume', 'wire-gauge-voltage-drop', 'centrifuge-rcf-g-force', 'gutter-downspout-sizing').
paramsYesKey-value parameter dictionary matching the target solver's input requirements (e.g. { length_ft: 20, width_ft: 12, depth_in: 4 }).
categoryYesDiscipline category directory (e.g. 'finance', 'engineering', 'biotech', 'construction', 'geometry', 'logistics', 'legal', 'energy').

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changedv0.1.2
    • changedInput schema / properties / category / description
      Previous value: -"Discipline category (e.g. 'finance', 'engineering', 'biotech', 'construction')"New value: +"Discipline category directory (e.g. 'finance', 'engineering', 'biotech', 'construction', 'geometry', 'logistics', 'legal', 'energy')."
    • changedInput schema / properties / params / description
      Previous value: -"Key-value parameters for the solver calculation"New value: +"Key-value parameter dictionary matching the target solver's input requirements (e.g. { length_ft: 20, width_ft: 12, depth_in: 4 })."
    • changedInput schema / properties / slug / description
      Previous value: -"Solver slug (e.g. 'itin-mortgage', 'wire-gauge-voltage-drop', 'centrifuge-rcf-g-force', 'gutter-downspout-sizing')"New value: +"Exact calculator URL slug (e.g. 'concrete-volume', 'wire-gauge-voltage-drop', 'centrifuge-rcf-g-force', 'gutter-downspout-sizing')."
  2. First observedv0.1.0

TDQS

Score is being calculated.

Deploy Server

Other Tools