Skip to main content
Glama

Atlarium Habitat Database MCP

Calculate weekly dose totals

calculate_weekly_dose_totals
Read-onlyIdempotent

Calculate weekly fertilizer totals for a supplied non-persistent dosing plan.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
itemsNoOptional supplied fertilization plan items to analyze.
regimeNoOptional fertilization regime name or strategy.
targetsNoOptional target nutrient concentrations.
languageNoOptional preferred response language: it, en or es.
measurementsNoOptional current measurements for nutrient-gap calculations.
volume_litersYesTank or habitat volume in liters.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYes
toolYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed2 schema fields changed
    • removedOutput schema / properties / generated_at
      Removed value: -{
      -  "type": "string"
      -}
    • changedOutput schema / required
      Previous value: -[
      -  "data",
      -  "generated_at",
      -  "tool"
      -]New value: +[
      +  "data",
      +  "tool"
      +]
  2. Changed41 schema fields changed
    • addedInput schema / properties / items / description
      Added value: +"Optional supplied fertilization plan items to analyze."
    • addedInput schema / properties / items / items / properties / brand_name / description
      Added value: +"Optional fertilizer brand name for this dosing item."
    • addedInput schema / properties / items / items / properties / days_of_week / description
      Added value: +"Scheduled dosing days as numbers from 1 to 7."
    • addedInput schema / properties / items / items / properties / days_of_week / items / description
      Added value: +"Day of week number from 1 to 7."
    • addedInput schema / properties / items / items / properties / dose_unit / description
      Added value: +"Dose unit, defaulting to ml."
    • addedInput schema / properties / items / items / properties / dose_value / description
      Added value: +"Dose amount per scheduled application."
    • addedInput schema / properties / items / items / properties / method / description
      Added value: +"Dosing method for the fertilizer item."
    • addedInput schema / properties / items / items / properties / notes / description
      Added value: +"Optional non-persistent notes for this dosing item."
    • addedInput schema / properties / items / items / properties / product_name / description
      Added value: +"Fertilizer product name for this dosing item."
    • addedInput schema / properties / items / items / properties / sort_order / description
      Added value: +"Optional sort order for displaying plan items."
    • addedInput schema / properties / language / description
      Added value: +"Optional preferred response language: it, en or es."
    • addedInput schema / properties / measurements / description
      Added value: +"Optional current measurements for nutrient-gap calculations."
    • addedInput schema / properties / measurements / items / properties / kind / description
      Added value: +"Measured nutrient or water parameter name."
    • addedInput schema / properties / measurements / items / properties / measured_at / description
      Added value: +"Optional ISO datetime for when the measurement was taken."
    • changedInput schema / properties / measurements / items / properties / value / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / measurements / items / properties / value / description
      Added value: +"Measured numeric value; omit or use null when unknown."
    • addedInput schema / properties / regime / description
      Added value: +"Optional fertilization regime name or strategy."
    • addedInput schema / properties / targets / description
      Added value: +"Optional target nutrient concentrations."
    • changedInput schema / properties / targets / properties / boron_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / boron_mg_l / description
      Added value: +"Target boron concentration in mg/L."
    • changedInput schema / properties / targets / properties / calcium_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / calcium_mg_l / description
      Added value: +"Target calcium concentration in mg/L."
    • changedInput schema / properties / targets / properties / copper_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / copper_mg_l / description
      Added value: +"Target copper concentration in mg/L."
    • changedInput schema / properties / targets / properties / iron_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / iron_mg_l / description
      Added value: +"Target iron concentration in mg/L."
    • changedInput schema / properties / targets / properties / magnesium_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / magnesium_mg_l / description
      Added value: +"Target magnesium concentration in mg/L."
    • changedInput schema / properties / targets / properties / manganese_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / manganese_mg_l / description
      Added value: +"Target manganese concentration in mg/L."
    • changedInput schema / properties / targets / properties / molybdenum_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / molybdenum_mg_l / description
      Added value: +"Target molybdenum concentration in mg/L."
    • changedInput schema / properties / targets / properties / nitrogen_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / nitrogen_mg_l / description
      Added value: +"Target nitrogen concentration in mg/L."
    • changedInput schema / properties / targets / properties / phosphorus_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / phosphorus_mg_l / description
      Added value: +"Target phosphorus concentration in mg/L."
    • changedInput schema / properties / targets / properties / potassium_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / potassium_mg_l / description
      Added value: +"Target potassium concentration in mg/L."
    • changedInput schema / properties / targets / properties / zinc_mg_l / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "description": "Finite numeric value for advisory calculations.",
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / targets / properties / zinc_mg_l / description
      Added value: +"Target zinc concentration in mg/L."
    • addedInput schema / properties / volume_liters / description
      Added value: +"Tank or habitat volume in liters."
  3. Added

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already provide readOnlyHint=true and destructiveHint=false, and the description's 'Calculate' is consistent. It adds the behavioral constraint that the plan must be non-persistent, which is useful for selection. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no fluff or redundancy. Every word contributes to the purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the rich input schema with full descriptions, the presence of an output schema, and annotations declaring safety, the description is mostly sufficient. It could optionally mention how volume_liters factors into totals, but the schema already explains that parameter. The description covers the core intent well.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all parameters (volume_liters, items, targets, measurements, etc.) are already well-documented in the schema. The description itself adds no parameter-specific meaning, hence the baseline score of 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Calculate') with a clear resource ('weekly fertilizer totals') and a qualifier ('non-persistent dosing plan') that distinguishes it from sibling tools like calculate_fertilizer_dose or generate_fertilization_plan. It clearly conveys what the tool does.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context: it is for a supplied non-persistent dosing plan, which tells the agent when to use it. However, it does not explicitly name alternatives or state when not to use it, so it falls short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.