Atlarium Habitat Database MCP

Official39 toolsLive

by techgardeners · TypeScript

Structured habitat data and advisory tools for aquariums, marine tanks, terrariums and paludariums.

bio.atlarium/habitat-database MCP Server

This Model Context Protocol (MCP) server provides structured habitat data and advisory tools for aquariums, marine tanks, terrariums, and paludariums. It is public and read-only, covering diagnostics, products, calculators, and advisory planning, as indicated by the repository excerpt.

🛠️ Key Features

Structured habitat data
Advisory tools
Diagnostics
Products
Calculators
Advisory planning
Public read-only access
39 tools

🚀 Use Cases

Habitat data lookup for aquariums and marine tanks
Planning support for terrariums and paludariums
Running diagnostics and using calculators as part of habitat planning

⚡ Developer Benefits

MCP server for remote integration (MCP, remote-MCP)
Topics aligned to developer workflows: model-context-protocol, mcp-server, streamable-http
Focused domain coverage for aquarium-data and habitat-planning

⚠️ Limitations

Public read-only MCP server (no write operations implied)

Topics

ai-agentsaquariumhabitat-datamarinemcpmodel-context-protocolpaludariumstreamable-httpterrariumai-toolsmcp-serverremote-mcpaquarium-datahabitat-planning

Captured live from the server via tools/list.

search_fish

Search fish and aquatic animal profiles in the Atlarium habitat database.

Parameters16

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
min_tank_liters	number	optional	Minimum tank volume filter in liters.
max_tank_liters	number	optional	Maximum tank volume filter in liters.
ph_min	number	optional	Minimum acceptable pH filter.
ph_max	number	optional	Maximum acceptable pH filter.
gh_min	number	optional	Minimum general hardness filter.
gh_max	number	optional	Maximum general hardness filter.
kh_min	number	optional	Minimum carbonate hardness filter.
kh_max	number	optional	Maximum carbonate hardness filter.
temperature_min	number	optional	Minimum temperature filter in Celsius.
temperature_max	number	optional	Maximum temperature filter in Celsius.
temperament	string	optional	Temperament filter, for example peaceful or aggressive.
care_level	string	optional	Care-level filter, for example easy, moderate or expert.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "min_tank_liters": {
      "description": "Minimum tank volume filter in liters.",
      "type": "number",
      "minimum": 0,
      "maximum": 100000
    },
    "max_tank_liters": {
      "description": "Maximum tank volume filter in liters.",
      "type": "number",
      "minimum": 0,
      "maximum": 100000
    },
    "ph_min": {
      "description": "Minimum acceptable pH filter.",
      "type": "number",
      "minimum": 0,
      "maximum": 14
    },
    "ph_max": {
      "description": "Maximum acceptable pH filter.",
      "type": "number",
      "minimum": 0,
      "maximum": 14
    },
    "gh_min": {
      "description": "Minimum general hardness filter.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "gh_max": {
      "description": "Maximum general hardness filter.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "kh_min": {
      "description": "Minimum carbonate hardness filter.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "kh_max": {
      "description": "Maximum carbonate hardness filter.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "temperature_min": {
      "description": "Minimum temperature filter in Celsius.",
      "type": "number",
      "minimum": 0,
      "maximum": 45
    },
    "temperature_max": {
      "description": "Maximum temperature filter in Celsius.",
      "type": "number",
      "minimum": 0,
      "maximum": 45
    },
    "temperament": {
      "description": "Temperament filter, for example peaceful or aggressive.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "care_level": {
      "description": "Care-level filter, for example easy, moderate or expert.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fish_profile

Get a structured fish or aquatic animal profile using the exact slug returned by search_fish.

Parameters2

slug	string	required	Exact single-segment slug returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$",
      "description": "Exact single-segment slug returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_plants

Search aquatic plants in the Atlarium database.

Parameters9

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
difficulty	string	optional	Plant difficulty filter.
light_requirement	string	optional	Lighting requirement filter.
co2_requirement	string	optional	CO2 requirement filter.
growth_rate	string	optional	Growth-rate filter.
placement	string	optional	Aquascape placement filter such as foreground or background.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "difficulty": {
      "description": "Plant difficulty filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "light_requirement": {
      "description": "Lighting requirement filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "co2_requirement": {
      "description": "CO2 requirement filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "growth_rate": {
      "description": "Growth-rate filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "placement": {
      "description": "Aquascape placement filter such as foreground or background.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_plant_profile

Get a structured aquatic plant profile using the exact slug returned by search_plants.

Parameters2

slug	string	required	Exact single-segment slug returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$",
      "description": "Exact single-segment slug returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_products

Search public habitat products in the Atlarium database.

Parameters7

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
category	string	optional	Product category filter.
brand	string	optional	Product brand filter.
use_case	string	optional	Use-case filter such as filtration, lighting or fertilization.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "category": {
      "description": "Product category filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "brand": {
      "description": "Product brand filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "use_case": {
      "description": "Use-case filter such as filtration, lighting or fertilization.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_product_profile

Get a structured public habitat product profile using the exact slug returned by search_products.

Parameters2

slug	string	required	Exact safe slug path returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*(?:\\/[a-z0-9]+(?:[._-][a-z0-9]+)*)*$",
      "description": "Exact safe slug path returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_species_compatibility

Check basic compatibility information between habitat species using Atlarium data.

Parameters7

species	array	required	List of species names or slugs to compare, from 1 to 20 entries.
language	string	optional	Optional preferred response language: it, en or es.
tank_liters	number	optional	Tank or habitat volume in liters.
ph	number	optional	Water pH value on the 0 to 14 scale.
gh	number	optional	Water hardness, conductivity or TDS-style value for advisory matching.
kh	number	optional	Water hardness, conductivity or TDS-style value for advisory matching.
temperature	number	optional	Water or ambient temperature in degrees Celsius.

Raw schema

{
  "type": "object",
  "properties": {
    "species": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120,
        "description": "Species common name, scientific name or slug to evaluate."
      },
      "description": "List of species names or slugs to compare, from 1 to 20 entries."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "tank_liters": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000,
      "description": "Tank or habitat volume in liters."
    },
    "ph": {
      "type": "number",
      "minimum": 0,
      "maximum": 14,
      "description": "Water pH value on the 0 to 14 scale."
    },
    "gh": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Water hardness, conductivity or TDS-style value for advisory matching."
    },
    "kh": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Water hardness, conductivity or TDS-style value for advisory matching."
    },
    "temperature": {
      "type": "number",
      "minimum": 0,
      "maximum": 45,
      "description": "Water or ambient temperature in degrees Celsius."
    }
  },
  "required": [
    "species"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_water_parameters

Get recommended water parameters using the exact slug returned by search_fish or search_plants.

Parameters3

slug	string	required	Exact single-segment slug returned by the related Atlarium search tool.
type	string	required	Profile type to read water parameters for.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$",
      "description": "Exact single-segment slug returned by the related Atlarium search tool."
    },
    "type": {
      "type": "string",
      "enum": [
        "fish",
        "plant"
      ],
      "description": "Profile type to read water parameters for."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug",
    "type"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

suggest_species_for_tank

Suggest compatible aquatic species based on tank size and water parameters.

Parameters9

tank_liters	number	required	Tank or habitat volume in liters.
language	string	optional	Optional preferred response language: it, en or es.
ph	number	optional	Water pH value on the 0 to 14 scale.
gh	number	optional	Water hardness, conductivity or TDS-style value for advisory matching.
kh	number	optional	Water hardness, conductivity or TDS-style value for advisory matching.
temperature	number	optional	Water or ambient temperature in degrees Celsius.
beginner_friendly	boolean	optional	When true, prefer species that are suitable for beginners.
planted_tank	boolean	optional	When true, prefer suggestions compatible with planted aquariums.
limit	integer	optional	Maximum number of suggestions to return, up to 30.

Raw schema

{
  "type": "object",
  "properties": {
    "tank_liters": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000,
      "description": "Tank or habitat volume in liters."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "ph": {
      "type": "number",
      "minimum": 0,
      "maximum": 14,
      "description": "Water pH value on the 0 to 14 scale."
    },
    "gh": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Water hardness, conductivity or TDS-style value for advisory matching."
    },
    "kh": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Water hardness, conductivity or TDS-style value for advisory matching."
    },
    "temperature": {
      "type": "number",
      "minimum": 0,
      "maximum": 45,
      "description": "Water or ambient temperature in degrees Celsius."
    },
    "beginner_friendly": {
      "description": "When true, prefer species that are suitable for beginners.",
      "type": "boolean"
    },
    "planted_tank": {
      "description": "When true, prefer suggestions compatible with planted aquariums.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum number of suggestions to return, up to 30.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 30
    }
  },
  "required": [
    "tank_liters"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_guides

Search Atlarium habitat guides and educational content.

Parameters5

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
topic	string	optional	Guide topic filter.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "topic": {
      "description": "Guide topic filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_guide

Get a structured public Atlarium guide using the exact slug returned by search_guides.

Parameters2

slug	string	required	Exact safe slug path returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*(?:\\/[a-z0-9]+(?:[._-][a-z0-9]+)*)*$",
      "description": "Exact safe slug path returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_algae

Search public algae diagnostic profiles with symptoms, causes and treatment guidance.

Parameters7

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
difficulty	integer	optional	Diagnostic difficulty filter from 1 to 5.
type	string	optional	Diagnostic profile type filter.
water_type	string	optional	Water or habitat type filter.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "difficulty": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Diagnostic difficulty filter from 1 to 5."
    },
    "type": {
      "description": "Diagnostic profile type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "water_type": {
      "description": "Water or habitat type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_algae_profile

Get a structured public algae diagnostic profile using the exact slug returned by search_algae.

Parameters2

slug	string	required	Exact single-segment slug returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$",
      "description": "Exact single-segment slug returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_diseases

Search public aquatic disease diagnostic profiles and advisory treatment information.

Parameters7

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
difficulty	integer	optional	Diagnostic difficulty filter from 1 to 5.
type	string	optional	Diagnostic profile type filter.
water_type	string	optional	Water or habitat type filter.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "difficulty": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Diagnostic difficulty filter from 1 to 5."
    },
    "type": {
      "description": "Diagnostic profile type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "water_type": {
      "description": "Water or habitat type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_disease_profile

Get a structured public aquatic disease profile using the exact slug returned by search_diseases.

Parameters2

slug	string	required	Exact single-segment slug returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$",
      "description": "Exact single-segment slug returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_plant_problems

Search public aquatic plant deficiency, pest and environmental problem profiles.

Parameters7

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
difficulty	integer	optional	Diagnostic difficulty filter from 1 to 5.
type	string	optional	Diagnostic profile type filter.
water_type	string	optional	Water or habitat type filter.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "difficulty": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Diagnostic difficulty filter from 1 to 5."
    },
    "type": {
      "description": "Diagnostic profile type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "water_type": {
      "description": "Water or habitat type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_plant_problem_profile

Get a structured public aquatic plant problem or deficiency profile using the exact slug returned by search_plant_problems.

Parameters2

slug	string	required	Exact single-segment slug returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$",
      "description": "Exact single-segment slug returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_medicines

Search public aquarium medicine and treatment product profiles.

Parameters7

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
difficulty	integer	optional	Diagnostic difficulty filter from 1 to 5.
type	string	optional	Diagnostic profile type filter.
water_type	string	optional	Water or habitat type filter.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "difficulty": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Diagnostic difficulty filter from 1 to 5."
    },
    "type": {
      "description": "Diagnostic profile type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "water_type": {
      "description": "Water or habitat type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_medicine_profile

Get a structured public aquarium medicine profile using the exact slug returned by search_medicines.

Parameters2

slug	string	required	Exact single-segment slug returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$",
      "description": "Exact single-segment slug returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

match_diagnostic_profiles

Find likely public algae, disease, plant problem and medicine profiles from a symptom query.

Parameters7

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
difficulty	integer	optional	Diagnostic difficulty filter from 1 to 5.
type	string	optional	Diagnostic profile type filter.
water_type	string	optional	Water or habitat type filter.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "difficulty": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Diagnostic difficulty filter from 1 to 5."
    },
    "type": {
      "description": "Diagnostic profile type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "water_type": {
      "description": "Water or habitat type filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_product_categories

List public Atlarium product categories for equipment and fertilizers.

Parameters2

language	string	optional	Optional preferred response language: it, en or es.
type	string	optional	Limit categories to equipment or fertilizer catalog entries.

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "type": {
      "description": "Limit categories to equipment or fertilizer catalog entries.",
      "type": "string",
      "enum": [
        "equipment",
        "fertilizer"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_product_brands

List public Atlarium product brands.

Parameters2

language	string	optional	Optional preferred response language: it, en or es.
query	string	optional	Search text used to match public Atlarium records.

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_equipment

Search public aquarium and habitat equipment products.

Parameters7

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
category	string	optional	Product category filter.
brand	string	optional	Product brand filter.
use_case	string	optional	Use-case filter such as filtration, lighting or fertilization.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "category": {
      "description": "Product category filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "brand": {
      "description": "Product brand filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "use_case": {
      "description": "Use-case filter such as filtration, lighting or fertilization.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_equipment_profile

Get a structured public equipment product profile using the exact slug returned by search_equipment.

Parameters2

slug	string	required	Exact safe slug path returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*(?:\\/[a-z0-9]+(?:[._-][a-z0-9]+)*)*$",
      "description": "Exact safe slug path returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_fertilizers

Search public aquarium fertilizer products and nutrient profiles.

Parameters7

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
category	string	optional	Product category filter.
brand	string	optional	Product brand filter.
use_case	string	optional	Use-case filter such as filtration, lighting or fertilization.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "category": {
      "description": "Product category filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "brand": {
      "description": "Product brand filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "use_case": {
      "description": "Use-case filter such as filtration, lighting or fertilization.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fertilizer_profile

Get a structured public fertilizer product profile using the exact slug returned by search_fertilizers.

Parameters2

slug	string	required	Exact safe slug path returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*(?:\\/[a-z0-9]+(?:[._-][a-z0-9]+)*)*$",
      "description": "Exact safe slug path returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_fertilization_regimes

Search public fertilization regimes and dosing philosophies.

Parameters5

query	string	optional	Search text used to match public Atlarium records.
language	string	optional	Optional preferred response language: it, en or es.
topic	string	optional	Fertilization regime topic filter.
limit	integer	optional	Maximum number of public records to return, up to 50.
offset	integer	optional	Zero-based pagination offset for public search results.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120,
      "description": "Search text used to match public Atlarium records."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "topic": {
      "description": "Fertilization regime topic filter.",
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "limit": {
      "description": "Maximum number of public records to return, up to 50.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    },
    "offset": {
      "description": "Zero-based pagination offset for public search results.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fertilization_regime

Get a structured public fertilization regime using the exact slug returned by search_fertilization_regimes.

Parameters2

slug	string	required	Exact single-segment slug returned by the related Atlarium search tool.
language	string	optional	Optional preferred response language: it, en or es.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$",
      "description": "Exact single-segment slug returned by the related Atlarium search tool."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_fertilizer_dose

Calculate an advisory fertilizer dose for a public catalog product and tank volume.

Parameters3

brand_name	string	optional	Optional public fertilizer brand name.
product_name	string	required	Public fertilizer product name.
volume_liters	number	required	Tank or habitat volume in liters.

Raw schema

{
  "type": "object",
  "properties": {
    "brand_name": {
      "description": "Optional public fertilizer brand name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "product_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "description": "Public fertilizer product name."
    },
    "volume_liters": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000,
      "description": "Tank or habitat volume in liters."
    }
  },
  "required": [
    "product_name",
    "volume_liters"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_nutrient_gaps

Compare nutrient targets with supplied measurements without saving user data.

Parameters6

items	array	optional	Optional supplied fertilization plan items to analyze.
language	string	optional	Optional preferred response language: it, en or es.
measurements	array	optional	Optional current measurements for nutrient-gap calculations.
regime	any	optional	Optional fertilization regime name or strategy.
targets	object	optional	Optional target nutrient concentrations.
volume_liters	number	required	Tank or habitat volume in liters.

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "description": "Optional supplied fertilization plan items to analyze.",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "brand_name": {
            "description": "Optional fertilizer brand name for this dosing item.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 120
              },
              {
                "type": "null"
              }
            ]
          },
          "product_name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160,
            "description": "Fertilizer product name for this dosing item."
          },
          "method": {
            "type": "string",
            "enum": [
              "LIQUID",
              "ROOT_TAB",
              "POWDER",
              "CAPSULE"
            ],
            "description": "Dosing method for the fertilizer item."
          },
          "dose_value": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Dose amount per scheduled application."
          },
          "dose_unit": {
            "default": "ml",
            "description": "Dose unit, defaulting to ml.",
            "type": "string",
            "minLength": 1,
            "maxLength": 20
          },
          "days_of_week": {
            "minItems": 1,
            "maxItems": 7,
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": 1,
              "maximum": 7,
              "description": "Day of week number from 1 to 7."
            },
            "description": "Scheduled dosing days as numbers from 1 to 7."
          },
          "sort_order": {
            "default": 0,
            "description": "Optional sort order for displaying plan items.",
            "type": "integer",
            "minimum": 0,
            "maximum": 1000
          },
          "notes": {
            "description": "Optional non-persistent notes for this dosing item.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 500
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "product_name",
          "method",
          "dose_value",
          "days_of_week"
        ],
        "additionalProperties": false
      }
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "measurements": {
      "description": "Optional current measurements for nutrient-gap calculations.",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "minLength": 1,
            "maxLength": 30,
            "description": "Measured nutrient or water parameter name."
          },
          "value": {
            "description": "Measured numeric value; omit or use null when unknown.",
            "anyOf": [
              {
                "type": "number",
                "description": "Finite numeric value for advisory calculations."
              },
              {
                "type": "null"
              }
            ]
          },
          "measured_at": {
            "description": "Optional ISO datetime for when the measurement was taken.",
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "regime": {
      "description": "Optional fertilization regime name or strategy.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ]
    },
    "targets": {
      "description": "Optional target nutrient concentrations.",
      "type": "object",
      "properties": {
        "boron_mg_l": {
          "description": "Target boron concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "calcium_mg_l": {
          "description": "Target calcium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "copper_mg_l": {
          "description": "Target copper concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "iron_mg_l": {
          "description": "Target iron concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "magnesium_mg_l": {
          "description": "Target magnesium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "manganese_mg_l": {
          "description": "Target manganese concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "molybdenum_mg_l": {
          "description": "Target molybdenum concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "nitrogen_mg_l": {
          "description": "Target nitrogen concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "phosphorus_mg_l": {
          "description": "Target phosphorus concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "potassium_mg_l": {
          "description": "Target potassium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "zinc_mg_l": {
          "description": "Target zinc concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false
    },
    "volume_liters": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000,
      "description": "Tank or habitat volume in liters."
    }
  },
  "required": [
    "volume_liters"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_weekly_dose_totals

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

Parameters6

items	array	optional	Optional supplied fertilization plan items to analyze.
language	string	optional	Optional preferred response language: it, en or es.
measurements	array	optional	Optional current measurements for nutrient-gap calculations.
regime	any	optional	Optional fertilization regime name or strategy.
targets	object	optional	Optional target nutrient concentrations.
volume_liters	number	required	Tank or habitat volume in liters.

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "description": "Optional supplied fertilization plan items to analyze.",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "brand_name": {
            "description": "Optional fertilizer brand name for this dosing item.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 120
              },
              {
                "type": "null"
              }
            ]
          },
          "product_name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160,
            "description": "Fertilizer product name for this dosing item."
          },
          "method": {
            "type": "string",
            "enum": [
              "LIQUID",
              "ROOT_TAB",
              "POWDER",
              "CAPSULE"
            ],
            "description": "Dosing method for the fertilizer item."
          },
          "dose_value": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Dose amount per scheduled application."
          },
          "dose_unit": {
            "default": "ml",
            "description": "Dose unit, defaulting to ml.",
            "type": "string",
            "minLength": 1,
            "maxLength": 20
          },
          "days_of_week": {
            "minItems": 1,
            "maxItems": 7,
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": 1,
              "maximum": 7,
              "description": "Day of week number from 1 to 7."
            },
            "description": "Scheduled dosing days as numbers from 1 to 7."
          },
          "sort_order": {
            "default": 0,
            "description": "Optional sort order for displaying plan items.",
            "type": "integer",
            "minimum": 0,
            "maximum": 1000
          },
          "notes": {
            "description": "Optional non-persistent notes for this dosing item.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 500
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "product_name",
          "method",
          "dose_value",
          "days_of_week"
        ],
        "additionalProperties": false
      }
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "measurements": {
      "description": "Optional current measurements for nutrient-gap calculations.",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "minLength": 1,
            "maxLength": 30,
            "description": "Measured nutrient or water parameter name."
          },
          "value": {
            "description": "Measured numeric value; omit or use null when unknown.",
            "anyOf": [
              {
                "type": "number",
                "description": "Finite numeric value for advisory calculations."
              },
              {
                "type": "null"
              }
            ]
          },
          "measured_at": {
            "description": "Optional ISO datetime for when the measurement was taken.",
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "regime": {
      "description": "Optional fertilization regime name or strategy.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ]
    },
    "targets": {
      "description": "Optional target nutrient concentrations.",
      "type": "object",
      "properties": {
        "boron_mg_l": {
          "description": "Target boron concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "calcium_mg_l": {
          "description": "Target calcium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "copper_mg_l": {
          "description": "Target copper concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "iron_mg_l": {
          "description": "Target iron concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "magnesium_mg_l": {
          "description": "Target magnesium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "manganese_mg_l": {
          "description": "Target manganese concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "molybdenum_mg_l": {
          "description": "Target molybdenum concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "nitrogen_mg_l": {
          "description": "Target nitrogen concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "phosphorus_mg_l": {
          "description": "Target phosphorus concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "potassium_mg_l": {
          "description": "Target potassium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "zinc_mg_l": {
          "description": "Target zinc concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false
    },
    "volume_liters": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000,
      "description": "Tank or habitat volume in liters."
    }
  },
  "required": [
    "volume_liters"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

generate_fertilization_plan

Generate an advisory non-persistent fertilization plan from public Atlarium catalog data.

Parameters6

items	array	optional	Optional supplied fertilization plan items to analyze.
language	string	optional	Optional preferred response language: it, en or es.
measurements	array	optional	Optional current measurements for nutrient-gap calculations.
regime	any	optional	Optional fertilization regime name or strategy.
targets	object	optional	Optional target nutrient concentrations.
volume_liters	number	required	Tank or habitat volume in liters.

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "description": "Optional supplied fertilization plan items to analyze.",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "brand_name": {
            "description": "Optional fertilizer brand name for this dosing item.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 120
              },
              {
                "type": "null"
              }
            ]
          },
          "product_name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160,
            "description": "Fertilizer product name for this dosing item."
          },
          "method": {
            "type": "string",
            "enum": [
              "LIQUID",
              "ROOT_TAB",
              "POWDER",
              "CAPSULE"
            ],
            "description": "Dosing method for the fertilizer item."
          },
          "dose_value": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Dose amount per scheduled application."
          },
          "dose_unit": {
            "default": "ml",
            "description": "Dose unit, defaulting to ml.",
            "type": "string",
            "minLength": 1,
            "maxLength": 20
          },
          "days_of_week": {
            "minItems": 1,
            "maxItems": 7,
            "type": "array",
            "items": {
              "type": "integer",
              "minimum": 1,
              "maximum": 7,
              "description": "Day of week number from 1 to 7."
            },
            "description": "Scheduled dosing days as numbers from 1 to 7."
          },
          "sort_order": {
            "default": 0,
            "description": "Optional sort order for displaying plan items.",
            "type": "integer",
            "minimum": 0,
            "maximum": 1000
          },
          "notes": {
            "description": "Optional non-persistent notes for this dosing item.",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 500
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "product_name",
          "method",
          "dose_value",
          "days_of_week"
        ],
        "additionalProperties": false
      }
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "measurements": {
      "description": "Optional current measurements for nutrient-gap calculations.",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "minLength": 1,
            "maxLength": 30,
            "description": "Measured nutrient or water parameter name."
          },
          "value": {
            "description": "Measured numeric value; omit or use null when unknown.",
            "anyOf": [
              {
                "type": "number",
                "description": "Finite numeric value for advisory calculations."
              },
              {
                "type": "null"
              }
            ]
          },
          "measured_at": {
            "description": "Optional ISO datetime for when the measurement was taken.",
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "regime": {
      "description": "Optional fertilization regime name or strategy.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ]
    },
    "targets": {
      "description": "Optional target nutrient concentrations.",
      "type": "object",
      "properties": {
        "boron_mg_l": {
          "description": "Target boron concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "calcium_mg_l": {
          "description": "Target calcium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "copper_mg_l": {
          "description": "Target copper concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "iron_mg_l": {
          "description": "Target iron concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "magnesium_mg_l": {
          "description": "Target magnesium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "manganese_mg_l": {
          "description": "Target manganese concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "molybdenum_mg_l": {
          "description": "Target molybdenum concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "nitrogen_mg_l": {
          "description": "Target nitrogen concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "phosphorus_mg_l": {
          "description": "Target phosphorus concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "potassium_mg_l": {
          "description": "Target potassium concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        },
        "zinc_mg_l": {
          "description": "Target zinc concentration in mg/L.",
          "anyOf": [
            {
              "type": "number",
              "description": "Finite numeric value for advisory calculations."
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false
    },
    "volume_liters": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000,
      "description": "Tank or habitat volume in liters."
    }
  },
  "required": [
    "volume_liters"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_tank_volume

Calculate gross and net aquarium volume estimates from dimensions.

Parameters11

bow_depth_cm	number	optional	Curved front depth in centimeters for bow-front tanks.
diameter_cm	number	optional	Cylinder diameter in centimeters.
glass_thickness_mm	number	optional	Glass thickness in millimeters for net volume estimates.
hardscape_displacement_liters	number	optional	Estimated hardscape displacement in liters.
height_cm	number	optional	Tank height in centimeters.
length_cm	number	optional	Tank length in centimeters.
shape	string	required	Tank shape: rectangular, cylindrical or bow-front.
substrate_depth_cm	number	optional	Substrate depth in centimeters.
water_density_kg_per_liter	number	optional	Water density in kilograms per liter.
water_height_cm	number	optional	Actual filled water height in centimeters.
width_cm	number	optional	Tank width in centimeters.

Raw schema

{
  "type": "object",
  "properties": {
    "bow_depth_cm": {
      "description": "Curved front depth in centimeters for bow-front tanks.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000
    },
    "diameter_cm": {
      "description": "Cylinder diameter in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "glass_thickness_mm": {
      "description": "Glass thickness in millimeters for net volume estimates.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "hardscape_displacement_liters": {
      "description": "Estimated hardscape displacement in liters.",
      "type": "number",
      "minimum": 0,
      "maximum": 100000
    },
    "height_cm": {
      "description": "Tank height in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "length_cm": {
      "description": "Tank length in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "shape": {
      "type": "string",
      "enum": [
        "rect",
        "cyl",
        "bow"
      ],
      "description": "Tank shape: rectangular, cylindrical or bow-front."
    },
    "substrate_depth_cm": {
      "description": "Substrate depth in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000
    },
    "water_density_kg_per_liter": {
      "description": "Water density in kilograms per liter.",
      "type": "number",
      "minimum": 0.5,
      "maximum": 2
    },
    "water_height_cm": {
      "description": "Actual filled water height in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "width_cm": {
      "description": "Tank width in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    }
  },
  "required": [
    "shape"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_tank_weight

Calculate advisory aquarium weight estimates from dimensions and material inputs.

Parameters16

bow_depth_cm	number	optional	Curved front depth in centimeters for bow-front tanks.
diameter_cm	number	optional	Cylinder diameter in centimeters.
glass_thickness_mm	number	optional	Glass thickness in millimeters for net volume estimates.
hardscape_displacement_liters	number	optional	Estimated hardscape displacement in liters.
height_cm	number	optional	Tank height in centimeters.
length_cm	number	optional	Tank length in centimeters.
shape	string	required	Tank shape: rectangular, cylindrical or bow-front.
substrate_depth_cm	number	optional	Substrate depth in centimeters.
water_density_kg_per_liter	number	optional	Water density in kilograms per liter.
water_height_cm	number	optional	Actual filled water height in centimeters.
width_cm	number	optional	Tank width in centimeters.
equipment_weight_kg	number	optional	Additional equipment weight in kilograms.
glass_weight_override_kg	number	optional	Known glass weight override in kilograms.
hardscape_weight_kg	number	optional	Hardscape weight in kilograms.
substrate_density_kg_per_liter	number	optional	Substrate density in kilograms per liter.
substrate_weight_override_kg	number	optional	Known substrate weight override in kilograms.

Raw schema

{
  "type": "object",
  "properties": {
    "bow_depth_cm": {
      "description": "Curved front depth in centimeters for bow-front tanks.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000
    },
    "diameter_cm": {
      "description": "Cylinder diameter in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "glass_thickness_mm": {
      "description": "Glass thickness in millimeters for net volume estimates.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "hardscape_displacement_liters": {
      "description": "Estimated hardscape displacement in liters.",
      "type": "number",
      "minimum": 0,
      "maximum": 100000
    },
    "height_cm": {
      "description": "Tank height in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "length_cm": {
      "description": "Tank length in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "shape": {
      "type": "string",
      "enum": [
        "rect",
        "cyl",
        "bow"
      ],
      "description": "Tank shape: rectangular, cylindrical or bow-front."
    },
    "substrate_depth_cm": {
      "description": "Substrate depth in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000
    },
    "water_density_kg_per_liter": {
      "description": "Water density in kilograms per liter.",
      "type": "number",
      "minimum": 0.5,
      "maximum": 2
    },
    "water_height_cm": {
      "description": "Actual filled water height in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "width_cm": {
      "description": "Tank width in centimeters.",
      "type": "number",
      "minimum": 0,
      "maximum": 5000
    },
    "equipment_weight_kg": {
      "description": "Additional equipment weight in kilograms.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    },
    "glass_weight_override_kg": {
      "description": "Known glass weight override in kilograms.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    },
    "hardscape_weight_kg": {
      "description": "Hardscape weight in kilograms.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    },
    "substrate_density_kg_per_liter": {
      "description": "Substrate density in kilograms per liter.",
      "type": "number",
      "minimum": 0.1,
      "maximum": 20
    },
    "substrate_weight_override_kg": {
      "description": "Known substrate weight override in kilograms.",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "shape"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_water_change

Calculate water change volume, weekly totals and dilution estimates.

Parameters3

change_percent	number	optional	Percent of tank volume changed per water change.
changes_per_week	integer	optional	Number of water changes per week.
volume_liters	number	optional	Tank volume or change volume in liters.

Raw schema

{
  "type": "object",
  "properties": {
    "change_percent": {
      "description": "Percent of tank volume changed per water change.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "changes_per_week": {
      "description": "Number of water changes per week.",
      "type": "integer",
      "minimum": 0,
      "maximum": 50
    },
    "volume_liters": {
      "description": "Tank volume or change volume in liters.",
      "type": "number",
      "minimum": 0,
      "maximum": 100000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_water_chemistry

Calculate public water chemistry conversions, CO2, salinity and water-mix estimates.

Parameters5

carbonate_hardness	object	optional	Carbonate hardness conversion input.
co2	object	optional	CO2 estimation input from KH and pH.
general_hardness	object	optional	General hardness conversion input.
salinity	object	optional	Salinity calculation input.
water_mix	object	optional	Water-mixing calculation input.

Raw schema

{
  "type": "object",
  "properties": {
    "carbonate_hardness": {
      "description": "Carbonate hardness conversion input.",
      "type": "object",
      "properties": {
        "unit": {
          "type": "string",
          "enum": [
            "dkh",
            "fh",
            "ppm",
            "meq"
          ],
          "description": "Carbonate hardness input unit."
        },
        "value": {
          "type": "number",
          "minimum": 0,
          "maximum": 10000,
          "description": "Carbonate hardness value."
        }
      },
      "required": [
        "unit",
        "value"
      ],
      "additionalProperties": false
    },
    "co2": {
      "description": "CO2 estimation input from KH and pH.",
      "type": "object",
      "properties": {
        "kh_dkh": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000,
          "description": "Carbonate hardness in dKH."
        },
        "ph": {
          "type": "number",
          "minimum": 0,
          "maximum": 14,
          "description": "Water pH value on the 0 to 14 scale."
        }
      },
      "required": [
        "kh_dkh",
        "ph"
      ],
      "additionalProperties": false
    },
    "general_hardness": {
      "description": "General hardness conversion input.",
      "type": "object",
      "properties": {
        "unit": {
          "type": "string",
          "enum": [
            "dgh",
            "fh",
            "ppm",
            "mmol"
          ],
          "description": "General hardness input unit."
        },
        "value": {
          "type": "number",
          "minimum": 0,
          "maximum": 10000,
          "description": "General hardness value."
        }
      },
      "required": [
        "unit",
        "value"
      ],
      "additionalProperties": false
    },
    "salinity": {
      "description": "Salinity calculation input.",
      "type": "object",
      "properties": {
        "current_ppt": {
          "description": "Current salinity in parts per thousand.",
          "type": "number",
          "minimum": 0,
          "maximum": 500
        },
        "salinity_ppt": {
          "description": "Measured or source salinity in parts per thousand.",
          "type": "number",
          "minimum": 0,
          "maximum": 500
        },
        "target_ppt": {
          "description": "Target salinity in parts per thousand.",
          "type": "number",
          "minimum": 0,
          "maximum": 500
        },
        "temperature_c": {
          "description": "Water temperature in Celsius for salinity adjustment.",
          "type": "number",
          "minimum": -10,
          "maximum": 60
        },
        "volume_liters": {
          "description": "Water volume in liters for salinity calculations.",
          "type": "number",
          "minimum": 0,
          "maximum": 100000
        }
      },
      "additionalProperties": false
    },
    "water_mix": {
      "description": "Water-mixing calculation input.",
      "type": "object",
      "properties": {
        "source1_gh": {
          "description": "General hardness of source water 1.",
          "type": "number",
          "minimum": 0,
          "maximum": 10000
        },
        "source2_gh": {
          "description": "General hardness of source water 2.",
          "type": "number",
          "minimum": 0,
          "maximum": 10000
        },
        "target_gh": {
          "description": "Target general hardness for the mix.",
          "type": "number",
          "minimum": 0,
          "maximum": 10000
        },
        "total_liters": {
          "description": "Total mixed water volume in liters.",
          "type": "number",
          "minimum": 0,
          "maximum": 100000
        }
      },
      "additionalProperties": false
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

convert_units

Convert aquarium-relevant temperature, length, weight and volume units.

Parameters5

length	object	optional	Length conversion input.
temperature	object	optional	Temperature conversion input.
temperature_delta	object	optional	Temperature difference input.
volume	object	optional	Volume conversion input.
weight	object	optional	Weight conversion input.

Raw schema

{
  "type": "object",
  "properties": {
    "length": {
      "description": "Length conversion input.",
      "type": "object",
      "properties": {
        "unit": {
          "type": "string",
          "enum": [
            "cm",
            "mm",
            "in",
            "ft"
          ],
          "description": "Length input unit."
        },
        "value": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000,
          "description": "Length value to convert."
        }
      },
      "required": [
        "unit",
        "value"
      ],
      "additionalProperties": false
    },
    "temperature": {
      "description": "Temperature conversion input.",
      "type": "object",
      "properties": {
        "unit": {
          "type": "string",
          "enum": [
            "c",
            "f",
            "k"
          ],
          "description": "Temperature input unit."
        },
        "value": {
          "type": "number",
          "minimum": -500,
          "maximum": 10000,
          "description": "Temperature value to convert."
        }
      },
      "required": [
        "unit",
        "value"
      ],
      "additionalProperties": false
    },
    "temperature_delta": {
      "description": "Temperature difference input.",
      "type": "object",
      "properties": {
        "from_c": {
          "type": "number",
          "minimum": -500,
          "maximum": 10000,
          "description": "Starting temperature in Celsius."
        },
        "to_c": {
          "type": "number",
          "minimum": -500,
          "maximum": 10000,
          "description": "Target temperature in Celsius."
        }
      },
      "required": [
        "from_c",
        "to_c"
      ],
      "additionalProperties": false
    },
    "volume": {
      "description": "Volume conversion input.",
      "type": "object",
      "properties": {
        "unit": {
          "type": "string",
          "enum": [
            "l",
            "ml",
            "galUs",
            "galUk",
            "flOz"
          ],
          "description": "Volume input unit."
        },
        "value": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000,
          "description": "Volume value to convert."
        }
      },
      "required": [
        "unit",
        "value"
      ],
      "additionalProperties": false
    },
    "weight": {
      "description": "Weight conversion input.",
      "type": "object",
      "properties": {
        "unit": {
          "type": "string",
          "enum": [
            "g",
            "kg",
            "oz",
            "lb"
          ],
          "description": "Weight input unit."
        },
        "value": {
          "type": "number",
          "minimum": 0,
          "maximum": 1000000000,
          "description": "Weight value to convert."
        }
      },
      "required": [
        "unit",
        "value"
      ],
      "additionalProperties": false
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

calculate_equipment_requirements

Calculate advisory heater, lighting and electricity requirements.

Parameters3

electricity	object	optional	Electricity cost and usage calculation input.
heater	object	optional	Heater sizing input.
lighting	object	optional	Lighting estimate input.

Raw schema

{
  "type": "object",
  "properties": {
    "electricity": {
      "description": "Electricity cost and usage calculation input.",
      "type": "object",
      "properties": {
        "cost_per_kwh": {
          "description": "Electricity cost per kWh.",
          "type": "number",
          "minimum": 0,
          "maximum": 1000
        },
        "duty_cycle_percent": {
          "description": "Estimated duty cycle percentage.",
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "hours_per_day": {
          "description": "Daily runtime in hours.",
          "type": "number",
          "minimum": 0,
          "maximum": 24
        },
        "wattage": {
          "description": "Equipment wattage.",
          "type": "number",
          "minimum": 0,
          "maximum": 1000000
        }
      },
      "additionalProperties": false
    },
    "heater": {
      "description": "Heater sizing input.",
      "type": "object",
      "properties": {
        "ambient_c": {
          "description": "Ambient room temperature in Celsius.",
          "type": "number",
          "minimum": -50,
          "maximum": 80
        },
        "insulation": {
          "type": "string",
          "enum": [
            "good",
            "normal",
            "poor"
          ],
          "description": "Tank insulation quality."
        },
        "target_c": {
          "description": "Target water temperature in Celsius.",
          "type": "number",
          "minimum": -50,
          "maximum": 80
        },
        "volume_liters": {
          "description": "Tank volume in liters for heater sizing.",
          "type": "number",
          "minimum": 0,
          "maximum": 100000
        }
      },
      "required": [
        "insulation"
      ],
      "additionalProperties": false
    },
    "lighting": {
      "description": "Lighting estimate input.",
      "type": "object",
      "properties": {
        "lumens": {
          "description": "Lighting output in lumens.",
          "type": "number",
          "minimum": 0,
          "maximum": 10000000
        },
        "volume_liters": {
          "description": "Tank volume in liters for lighting estimates.",
          "type": "number",
          "minimum": 0,
          "maximum": 100000
        },
        "watts": {
          "description": "Lighting wattage.",
          "type": "number",
          "minimum": 0,
          "maximum": 1000000
        }
      },
      "additionalProperties": false
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

suggest_habitat_for_tank

Suggest a complete public habitat plan with species, plants, products, warnings, motivations and related guides.

Parameters15

tank_liters	number	required	Tank or habitat volume in liters.
language	string	optional	Optional preferred response language: it, en or es.
ph	number	optional	Water pH value on the 0 to 14 scale.
gh	number	optional	Water hardness, conductivity or TDS-style value for advisory matching.
kh	number	optional	Water hardness, conductivity or TDS-style value for advisory matching.
temperature	number	optional	Water or ambient temperature in degrees Celsius.
beginner_friendly	boolean	optional	When true, prefer beginner-friendly habitat plans.
planted_tank	boolean	optional	When true, prefer plans designed for planted aquariums.
limit	integer	optional	Maximum number of suggestions to return, up to 30.
co2	string	optional	CO2 setup level for the suggested habitat.
light_level	string	optional	Lighting intensity preference for the suggested habitat.
setup_intent	string	optional	Primary setup intent for the habitat plan.
target_difficulty	string	optional	Desired care difficulty for the habitat plan.
tds	number	optional	Total dissolved solids value for habitat matching.
water_type	string	optional	Target habitat water or environment type.

Raw schema

{
  "type": "object",
  "properties": {
    "tank_liters": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000,
      "description": "Tank or habitat volume in liters."
    },
    "language": {
      "description": "Optional preferred response language: it, en or es.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es"
      ]
    },
    "ph": {
      "type": "number",
      "minimum": 0,
      "maximum": 14,
      "description": "Water pH value on the 0 to 14 scale."
    },
    "gh": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Water hardness, conductivity or TDS-style value for advisory matching."
    },
    "kh": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Water hardness, conductivity or TDS-style value for advisory matching."
    },
    "temperature": {
      "type": "number",
      "minimum": 0,
      "maximum": 45,
      "description": "Water or ambient temperature in degrees Celsius."
    },
    "beginner_friendly": {
      "description": "When true, prefer beginner-friendly habitat plans.",
      "type": "boolean"
    },
    "planted_tank": {
      "description": "When true, prefer plans designed for planted aquariums.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum number of suggestions to return, up to 30.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 30
    },
    "co2": {
      "description": "CO2 setup level for the suggested habitat.",
      "type": "string",
      "enum": [
        "none",
        "low",
        "injected"
      ]
    },
    "light_level": {
      "description": "Lighting intensity preference for the suggested habitat.",
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "setup_intent": {
      "description": "Primary setup intent for the habitat plan.",
      "type": "string",
      "enum": [
        "community",
        "shrimp",
        "planted",
        "breeding"
      ]
    },
    "target_difficulty": {
      "description": "Desired care difficulty for the habitat plan.",
      "type": "string",
      "enum": [
        "easy",
        "balanced",
        "expert"
      ]
    },
    "tds": {
      "description": "Total dissolved solids value for habitat matching.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "water_type": {
      "description": "Target habitat water or environment type.",
      "type": "string",
      "enum": [
        "FRESHWATER",
        "MARINE",
        "BRACKISH",
        "TERRESTRIAL",
        "SEMI_AQUATIC"
      ]
    }
  },
  "required": [
    "tank_liters"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md26 KBView on GitHub

Atlarium Habitat Database MCP social preview

Atlarium Habitat Database MCP

Public read-only MCP server for Atlarium habitat data, diagnostics, products, calculators and advisory planning.

Version 2.0.3 Transport: Streamable HTTP Read-only MCP tools Prompts enabled Auth none

MCP endpoint · Human docs · Server card · Technical docs · Client examples

Atlarium Habitat Database MCP gives AI agents structured access to public Atlarium data and advisory functions for aquariums, marine tanks, coldwater systems, terrariums, paludariums and vivariums. It exposes 39 public read-only tools for species, plants, products, guides, algae, diseases, plant problems, medicines, compatibility, fertilization, calculators and complete habitat planning without exposing Atlarium accounts, private workspaces, admin APIs or write operations.

At A Glance

Surface	Value
MCP endpoint	`https://mcp.atlarium.bio/mcp`
MCP version	`2.0.3`
Transport	Streamable HTTP
Authentication	none
Tool surface	39 public read-only tools
Prompts	9 guided public prompts
Apps widget	`ui://widget/habitat-explorer.v4.html`
Server card	`https://mcp.atlarium.bio/.well-known/mcp/server-card.json`
Human docs	`https://atlarium.bio/mcp`
Official MCP Registry	`bio.atlarium/habitat-database`

https://atlarium.bio/mcp is documentation. The canonical Streamable HTTP MCP endpoint is https://mcp.atlarium.bio/mcp.

What You Can Build

Use case	Public tools
Species research	Search fish, aquatic animals and plants, then retrieve localized structured profiles.
Tank compatibility	Compare species against tank size, pH, hardness and temperature constraints.
Diagnostic triage	Search algae, aquatic diseases, plant problems and treatment references from public profiles.
Product selection	Explore product categories, brands, equipment and fertilizers.
Fertilization support	Search dosing regimes, calculate product doses, nutrient gaps and weekly totals.
Aquarium calculators	Estimate tank volume, weight, water changes, water chemistry, unit conversions and equipment needs.
Habitat planning	Generate a complete advisory tank plan with species, plants, products, warnings, motivations and related guides.
Guide retrieval	Search and retrieve public Atlarium educational content.

All outputs are advisory. Compatibility checks, diagnostics, fertilization plans, equipment estimates, aquarium calculators and tank suggestions should be verified against real livestock, equipment, water chemistry, local regulations and husbandry constraints.

Quickstart

Use any MCP client that supports remote Streamable HTTP servers:

json

{
  "mcpServers": {
    "atlarium": {
      "type": "streamable-http",
      "url": "https://mcp.atlarium.bio/mcp"
    }
  }
}

Claude Code remote HTTP example:

bash

claude mcp add --transport http atlarium https://mcp.atlarium.bio/mcp

Smoke check the live endpoint:

bash

curl --fail --silent --show-error https://mcp.atlarium.bio/health
curl --fail --silent --show-error https://mcp.atlarium.bio/.well-known/mcp/server-card.json
pnpm mcp:monitor:public

Client Setup

Client or host	Setup
OpenAI Agents SDK	See `examples/openai-agents-python` for a Python agent that connects to the remote Streamable HTTP endpoint.
Claude Code	Run `claude mcp add --transport http atlarium https://mcp.atlarium.bio/mcp`, then ask Claude to use Atlarium.
Cursor	Use the Add to Cursor deep link or the root `mcp.json`.
Cline	Add the hosted endpoint as a Streamable HTTP remote server; `llms-install.md` contains deterministic agent setup instructions.
Windsurf	Copy `examples/windsurf/mcp_config.json` into Windsurf MCP settings and refresh Cascade MCP servers.
VS Code	Copy `examples/vscode/mcp.json`; VS Code uses `type: "http"` for remote MCP servers.
Antigravity	Use `examples/antigravity/mcp.json` only in builds that support remote MCP servers.
Generic Streamable HTTP	Use the JSON-RPC examples in `examples/generic-streamable-http`.
ChatGPT Apps	The existing app version `1.0.0` is approved in the OpenAI dashboard. The corrected `2.0.3` package was resubmitted on 2026-08-29 with taxonomy-stable tests and OpenAI Platform now shows `Review`. Use `examples/chatgpt-apps` and `docs/chatgpt-review-remediation.md` for review notes and smoke prompts.

These are compatibility notes, not vendor endorsements. Do not make vendor or directory support claims for ChatGPT, Claude, Cursor, Windsurf, VS Code, Antigravity or any directory unless that vendor has accepted the listing.

The server advertises a read-only MCP Apps / ChatGPT Apps widget resource for Apps-compatible hosts:

Field	Value
Resource URI	`ui://widget/habitat-explorer.v4.html`
MIME type	`text/html;profile=mcp-app`
Widget	`Atlarium Habitat Explorer`
Widget domain	`https://mcp.atlarium.bio`
Output mode	Plain JSON text plus `structuredContent`

The widget renders public habitat results, profiles, diagnostic summaries, product results, calculator output, compatibility summaries, fertilization plans and habitat suggestions. It does not add write access and does not expose workspace, auth, admin, journal, schedule or measurement data.

Widget-only development screenshots and a short demo recording are checked in under docs/assets/chatgpt-screenshots/ and docs/assets/chatgpt-app-demo.mp4. Real host-level web and responsive 390x844 captures are stored under docs/assets/chatgpt-screenshots/real-host/; native iOS/Android recording is still required for the final review package. The v4 / 2.0.3 candidate is live at the MCP endpoint but is not yet approved as the new ChatGPT App version; do not describe that app submission as approved until OpenAI accepts it. The existing dashboard app version 1.0.0 is approved.

Tool Surface

Area	Tools
Fish and aquatic animals	`search_fish`, `get_fish_profile`
Aquatic plants	`search_plants`, `get_plant_profile`
Products and guides	`search_products`, `get_product_profile`, `search_guides`, `get_guide`
Diagnostics	`search_algae`, `get_algae_profile`, `search_diseases`, `get_disease_profile`, `search_plant_problems`, `get_plant_problem_profile`, `search_medicines`, `get_medicine_profile`, `match_diagnostic_profiles`
Product catalog	`list_product_categories`, `list_product_brands`, `search_equipment`, `get_equipment_profile`, `search_fertilizers`, `get_fertilizer_profile`
Compatibility and water	`check_species_compatibility`, `get_water_parameters`, `suggest_species_for_tank`
Fertilization	`search_fertilization_regimes`, `get_fertilization_regime`, `calculate_fertilizer_dose`, `calculate_nutrient_gaps`, `calculate_weekly_dose_totals`, `generate_fertilization_plan`
Calculators	`calculate_tank_volume`, `calculate_tank_weight`, `calculate_water_change`, `calculate_water_chemistry`, `convert_units`, `calculate_equipment_requirements`
Habitat planner	`suggest_habitat_for_tank`

Every tool is registered with read-only annotations: readOnlyHint: true, openWorldHint: false, destructiveHint: false, idempotentHint: true.

Guided Prompts

The server advertises guided prompts for species search, compatibility, habitat planning, algae, diseases, plant problems, product selection, fertilization and tank calculations. Prompts guide clients toward the same public read-only tool surface; they do not add new capabilities or write access.

Tool Call Examples

Each example shows the MCP tool name and a minimal valid JSON input. Generic MCP clients receive plain JSON text; Apps-compatible hosts can also use structuredContent.

Catalog, plants and guides

`search_fish`

Purpose: search fish and aquatic animal profiles.

Prompt: "Find beginner-friendly small fish for a 90 L planted tank."

json

{
  "query": "tetra",
  "language": "en",
  "min_tank_liters": 40,
  "max_tank_liters": 120,
  "limit": 5
}

Output: matching public animal profiles with slugs, localized names, summary fields and public URLs when available.

`get_fish_profile`

Purpose: retrieve one structured fish or aquatic animal profile.

Prompt: "Show me the Atlarium profile for Neon Tetra."

json

{
  "slug": "paracheirodon-innesi",
  "language": "en"
}

Output: public profile data, care parameters, taxonomy, relationships and localized content where available.

`search_plants`

Purpose: search aquatic plant profiles.

Prompt: "Find easy foreground or midground plants for low-tech tanks."

json

{
  "query": "anubias",
  "language": "en",
  "difficulty": "easy",
  "limit": 5
}

Output: matching public plant profiles with placement, difficulty and public URLs when available.

`get_plant_profile`

Purpose: retrieve one structured aquatic plant profile.

Prompt: "Open the plant profile for Anubias barteri."

json

{
  "slug": "anubias-barteri",
  "language": "en"
}

Output: plant requirements, growth information, structured attributes and localized content where available.

`search_products`

Purpose: search public habitat products.

Prompt: "Find filter products for freshwater tanks."

json

{
  "query": "filter",
  "language": "en",
  "category": "filter",
  "limit": 5
}

Output: product results with brand/category information and public product URLs when available.

`get_product_profile`

Purpose: retrieve a public product profile.

Prompt: "Show the product profile for this catalog slug."

json

{
  "slug": "seachem/prime",
  "language": "en"
}

Output: structured public product data, use cases, brand details and links when available.

`search_guides`

Purpose: search Atlarium guides and educational content.

Prompt: "Find public guides about cycling an aquarium."

json

{
  "query": "cycling",
  "language": "en",
  "topic": "aquarium",
  "limit": 5
}

Output: guide matches with title, summary, topic and public URLs when available.

`get_guide`

Purpose: retrieve one public Atlarium guide.

Prompt: "Open the nitrogen cycle guide."

json

{
  "slug": "aquarium/nitrogen-cycle",
  "language": "en"
}

Output: structured public guide content and related metadata.

Diagnostics and treatment references

`search_algae`

Purpose: search algae diagnostic profiles.

Prompt: "Find algae profiles for green dust on aquarium glass."

json

{
  "query": "green dust",
  "language": "en",
  "difficulty": 2,
  "limit": 5
}

Output: algae matches with symptoms, likely causes and advisory guidance.

`get_algae_profile`

Purpose: retrieve one algae profile.

Prompt: "Show the profile for green spot algae."

json

{
  "slug": "green-spot-algae",
  "language": "en"
}

Output: structured public algae profile with symptoms, causes, prevention and advisory response.

`search_diseases`

Purpose: search aquatic disease profiles.

Prompt: "Find disease profiles for white spots on fish."

json

{
  "query": "white spots",
  "language": "en",
  "water_type": "freshwater",
  "limit": 5
}

Output: possible disease profiles and advisory treatment references.

`get_disease_profile`

Purpose: retrieve one disease profile.

Prompt: "Open the ich disease profile."

json

{
  "slug": "ich",
  "language": "en"
}

Output: symptoms, possible causes, treatment references and disclaimers.

`search_plant_problems`

Purpose: search aquatic plant deficiency, pest and environment profiles.

Prompt: "Find causes for yellowing leaves in aquarium plants."

json

{
  "query": "yellow leaves",
  "language": "en",
  "type": "deficiency",
  "limit": 5
}

Output: plant problem matches with symptoms, causes and advisory corrections.

`get_plant_problem_profile`

Purpose: retrieve one plant problem profile.

Prompt: "Open the nitrogen deficiency profile."

json

{
  "slug": "nitrogen-deficiency",
  "language": "en"
}

Output: structured deficiency/problem data and advisory guidance.

`search_medicines`

Purpose: search aquarium medicine and treatment product profiles.

Prompt: "Find public medicine references for ich treatment."

json

{
  "query": "ich",
  "language": "en",
  "limit": 5
}

Output: medicine/treatment references with public profile data where available.

`get_medicine_profile`

Purpose: retrieve one medicine profile.

Prompt: "Open the profile for a medicine slug."

json

{
  "slug": "malachite-green",
  "language": "en"
}

Output: structured public medicine reference, use notes and disclaimers.

`match_diagnostic_profiles`

Purpose: match symptom text across algae, disease, plant problem and medicine profiles.

Prompt: "Match fuzzy white growth on driftwood and stressed fish symptoms."

json

{
  "query": "white fuzzy growth and fish flashing",
  "language": "en",
  "limit": 8
}

Output: likely public diagnostic profiles grouped by relevance.

Products, equipment and fertilizers

`list_product_categories`

Purpose: list product categories for equipment and fertilizers.

Prompt: "Which public equipment categories are available?"

json

{
  "language": "en",
  "type": "equipment"
}

Output: localized public category names and identifiers.

`list_product_brands`

Purpose: list public product brands.

Prompt: "List brands matching Seachem."

json

{
  "language": "en",
  "query": "Seachem"
}

Output: matching public brand names and metadata.

`search_equipment`

Purpose: search aquarium and habitat equipment products.

Prompt: "Find heaters for a freshwater setup."

json

{
  "query": "heater",
  "language": "en",
  "use_case": "freshwater",
  "limit": 5
}

Output: equipment product matches with structured public catalog fields.

`get_equipment_profile`

Purpose: retrieve one equipment product profile.

Prompt: "Open this equipment profile."

json

{
  "slug": "eheim/thermocontrol",
  "language": "en"
}

Output: public equipment details, category, brand and usage fields when available.

`search_fertilizers`

Purpose: search fertilizer products and nutrient profiles.

Prompt: "Find liquid fertilizers for planted aquariums."

json

{
  "query": "flourish",
  "language": "en",
  "category": "fertilizer",
  "limit": 5
}

Output: fertilizer product matches and nutrient metadata when available.

`get_fertilizer_profile`

Purpose: retrieve one fertilizer profile.

Prompt: "Open this fertilizer profile."

json

{
  "slug": "seachem/flourish",
  "language": "en"
}

Output: structured fertilizer data, dosing metadata and public catalog details when available.

Compatibility, water and habitat suggestions

`check_species_compatibility`

Purpose: check basic compatibility among habitat species.

Prompt: "Can Neon Tetra and Corydoras paleatus work in a 90 L planted tank?"

json

{
  "species": ["Paracheirodon innesi", "Corydoras paleatus"],
  "language": "en",
  "tank_liters": 90,
  "ph": 6.8,
  "temperature": 24
}

Output: advisory compatibility signals, warnings, rationale and constraints.

`get_water_parameters`

Purpose: retrieve recommended water parameters for a fish or plant.

Prompt: "What water parameters does Neon Tetra prefer?"

json

{
  "slug": "paracheirodon-innesi",
  "type": "fish",
  "language": "en"
}

Output: public temperature, pH, GH/KH and related parameter guidance where available.

`suggest_species_for_tank`

Purpose: suggest aquatic species based on tank and water parameters.

Prompt: "Suggest beginner-friendly species for a 120 L planted tank."

json

{
  "tank_liters": 120,
  "language": "en",
  "ph": 6.8,
  "temperature": 24,
  "beginner_friendly": true,
  "planted_tank": true,
  "limit": 8
}

Output: public species suggestions with warnings and basic rationale.

`suggest_habitat_for_tank`

Purpose: suggest a complete public habitat plan.

Prompt: "Plan a balanced planted community habitat for 120 L."

json

{
  "tank_liters": 120,
  "language": "en",
  "ph": 6.8,
  "temperature": 24,
  "beginner_friendly": true,
  "planted_tank": true,
  "co2": "low",
  "light_level": "medium",
  "setup_intent": "community",
  "target_difficulty": "balanced",
  "water_type": "FRESHWATER",
  "limit": 8
}

Output: fish, invertebrates, plants, products, warnings, motivations, related guides and advisory disclaimer.

Fertilization

`search_fertilization_regimes`

Purpose: search fertilization regimes and dosing philosophies.

Prompt: "Find regimes for low-tech planted tanks."

json

{
  "query": "low tech",
  "language": "en",
  "topic": "planted",
  "limit": 5
}

Output: public regime matches with summary, topics and public URLs when available.

`get_fertilization_regime`

Purpose: retrieve one fertilization regime.

Prompt: "Open the Estimative Index regime profile."

json

{
  "slug": "estimative-index",
  "language": "en"
}

Output: structured public dosing philosophy/regime details.

`calculate_fertilizer_dose`

Purpose: calculate an advisory fertilizer dose for a catalog product and tank volume.

Prompt: "Calculate the dose of Seachem Flourish for 120 L."

json

{
  "brand_name": "Seachem",
  "product_name": "Flourish",
  "volume_liters": 120
}

Output: advisory dose estimate and product-related dosing context.

`calculate_nutrient_gaps`

Purpose: compare nutrient measurements against targets.

Prompt: "Compare my nitrate and potassium readings with planted tank targets."

json

{
  "language": "en",
  "volume_liters": 120,
  "measurements": [
    {
      "kind": "nitrogen_mg_l",
      "value": 5
    },
    {
      "kind": "potassium_mg_l",
      "value": 8
    }
  ],
  "targets": {
    "nitrogen_mg_l": 10,
    "potassium_mg_l": 15
  }
}

Output: nutrient gap estimates without saving measurements.

`calculate_weekly_dose_totals`

Purpose: calculate weekly totals for a non-persistent dosing plan.

Prompt: "Add up my weekly liquid fertilizer plan."

json

{
  "language": "en",
  "volume_liters": 120,
  "items": [
    {
      "brand_name": "Seachem",
      "product_name": "Flourish",
      "method": "LIQUID",
      "dose_value": 5,
      "dose_unit": "ml",
      "days_of_week": [1, 3, 5]
    }
  ]
}

Output: weekly product totals and schedule summary.

`generate_fertilization_plan`

Purpose: generate an advisory non-persistent fertilization plan.

Prompt: "Generate a balanced planted tank fertilization plan for 120 L."

json

{
  "language": "en",
  "volume_liters": 120,
  "regime": "balanced",
  "targets": {
    "nitrogen_mg_l": 10,
    "phosphorus_mg_l": 1,
    "potassium_mg_l": 15,
    "iron_mg_l": 0.1
  }
}

Output: advisory plan, nutrient targets, product suggestions and disclaimer.

Calculators

`calculate_tank_volume`

Purpose: calculate gross and net aquarium volume estimates.

Prompt: "Calculate net volume for a 60 x 30 x 36 cm tank."

json

{
  "shape": "rect",
  "length_cm": 60,
  "width_cm": 30,
  "height_cm": 36,
  "substrate_depth_cm": 5,
  "hardscape_displacement_liters": 4
}

Output: gross and net volume estimates.

`calculate_tank_weight`

Purpose: estimate aquarium weight from dimensions and material inputs.

Prompt: "Estimate the filled weight of a 120 L aquarium."

json

{
  "shape": "rect",
  "length_cm": 80,
  "width_cm": 35,
  "height_cm": 45,
  "glass_thickness_mm": 8,
  "substrate_depth_cm": 6,
  "hardscape_weight_kg": 12,
  "equipment_weight_kg": 5
}

Output: advisory total weight estimate and component breakdown.

`calculate_water_change`

Purpose: calculate water change volume, weekly totals and dilution estimates.

Prompt: "How much water is a 30 percent change on 120 L twice per week?"

json

{
  "volume_liters": 120,
  "change_percent": 30,
  "changes_per_week": 2
}

Output: per-change volume and weekly total estimates.

`calculate_water_chemistry`

Purpose: calculate hardness conversions, CO2, salinity and water mixing.

Prompt: "Estimate CO2 from pH 6.8 and KH 4."

json

{
  "co2": {
    "ph": 6.8,
    "kh_dkh": 4
  },
  "general_hardness": {
    "unit": "dgh",
    "value": 8
  }
}

Output: public chemistry conversions and advisory estimates.

`convert_units`

Purpose: convert aquarium-relevant units.

Prompt: "Convert 120 liters and 24 C."

json

{
  "volume": {
    "unit": "l",
    "value": 120
  },
  "temperature": {
    "unit": "c",
    "value": 24
  }
}

Output: converted values for supported units.

`calculate_equipment_requirements`

Purpose: calculate advisory heater, lighting and electricity requirements.

Prompt: "Estimate heater and lighting needs for a 120 L aquarium."

json

{
  "heater": {
    "volume_liters": 120,
    "ambient_c": 20,
    "target_c": 25,
    "insulation": "normal"
  },
  "lighting": {
    "volume_liters": 120,
    "lumens": 3600
  },
  "electricity": {
    "wattage": 100,
    "hours_per_day": 8,
    "cost_per_kwh": 0.25
  }
}

Output: advisory equipment estimates and electricity usage/cost summary.

Discovery And Directory Status

Directory	Status
Official MCP Registry	Published as `bio.atlarium/habitat-database`; release `2.0.3` is active and latest.
GitHub	Canonical public source repository.
Glama	Ownership verified; listing healthy with 39 tools and canonical V2 description.
Smithery	Published listing; production exposes version `2.0.3`, 39 tools and 9 prompts, while the directory refresh remains pending.
MCP.so	Listed publicly; the `2.0.2` refresh is awaiting directory processing.
PulseMCP	Listed publicly; verify badge policy before adding a badge.
mcpservers.org	Listed publicly at `techgardeners/atlarium-mcp`; no badge added yet.
MCPRepository	Published listing, verified by its public page.
MCP Market	Listed publicly with canonical repository and read-only tool metadata.
MCP Scoreboard	Public listing exists and remains unscored; no score badge is claimed.
MCP Queen	Verified public evidence page with live protocol probing.

Publication tracking and reusable submission copy live in config/distribution-registry.json, docs/publication-checklist.md, docs/directory-submission-payloads.md and docs/mcp-submission-cockpit.md. Pending, blocked and rejected targets remain in the operational registry and are not presented as accepted public listings.

Local Development

bash

pnpm install
cp .env.example .env
pnpm dev

By default the server listens on http://localhost:43118.

Local development against the Atlarium app:

bash

ATLARIUM_API_BASE_URL=http://localhost:43117/api/public/mcp/v1 pnpm dev

Configuration

MCP_PUBLIC_BASE_URL: public base URL, production default https://mcp.atlarium.bio.
ATLARIUM_API_BASE_URL: public read-only Atlarium API base URL.
MCP_ALLOWED_HOSTS: comma-separated host allowlist used for DNS rebinding protection.
MCP_TRUST_PROXY: Express proxy trust setting; default 1 assumes one trusted reverse proxy in production.
ATLARIUM_API_TIMEOUT_MS: upstream public API timeout in milliseconds (default 15000).
MCP_PUBLIC_PROBE_ATTEMPTS: attempts for read-only public monitors (default 3).
MCP_PUBLIC_PROBE_RETRY_DELAY_MS: initial retry delay for public monitors, doubled after each failure (default 1000).
ATLARIUM_API_RESPONSE_MAX_BYTES: maximum upstream JSON response size.
OPENAI_APPS_CHALLENGE_TOKEN: public OpenAI Apps domain verification token served from /.well-known/openai-apps-challenge.

Production deployments must run behind a TLS-terminating reverse proxy or Ingress that overwrites X-Forwarded-For, X-Forwarded-Host and X-Forwarded-Proto before traffic reaches this server.

Quality Gate

bash

pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm audit:prod
docker build -t atlarium-mcp:local .

With a local server running:

bash

pnpm mcp:conformance

With production DNS and TLS live:

bash

pnpm mcp:monitor:public
pnpm directories:submit -- --check
pnpm mcp:validate:public
pnpm mcp:conformance:public

Contributing

See CONTRIBUTING.md. Public tool changes must update the server implementation, tests, server-card metadata, server.json, README.md, docs/mcp.md, docs, examples and directory publication notes in the same release.

Security

See SECURITY.md. Do not report sensitive security issues in public GitHub issues.

License

MIT. See LICENSE.

Install

Tools (39)

search_fishget_fish_profilesearch_plantsget_plant_profilesearch_productsget_product_profilecheck_species_compatibilityget_water_parameters

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.atlarium.bio/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "habitat-database": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.atlarium.bio/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

bio.atlarium/habitat-database MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_fish

get_fish_profile

search_plants

get_plant_profile

search_products

get_product_profile

check_species_compatibility

get_water_parameters

suggest_species_for_tank

search_guides

get_guide

search_algae

get_algae_profile

search_diseases

get_disease_profile

search_plant_problems

get_plant_problem_profile

search_medicines

get_medicine_profile

match_diagnostic_profiles

list_product_categories

list_product_brands

search_equipment

get_equipment_profile

search_fertilizers

get_fertilizer_profile

search_fertilization_regimes

get_fertilization_regime

calculate_fertilizer_dose

calculate_nutrient_gaps

calculate_weekly_dose_totals

generate_fertilization_plan

calculate_tank_volume

calculate_tank_weight

calculate_water_change

calculate_water_chemistry

convert_units

calculate_equipment_requirements

suggest_habitat_for_tank

Atlarium Habitat Database MCP

At A Glance

What You Can Build

Quickstart

Client Setup

ChatGPT App And Widget

Tool Surface

Guided Prompts

Tool Call Examples

search_fish

get_fish_profile

search_plants

get_plant_profile

search_products

get_product_profile

search_guides

get_guide

search_algae

get_algae_profile

search_diseases

get_disease_profile

search_plant_problems

get_plant_problem_profile

search_medicines

get_medicine_profile

match_diagnostic_profiles

list_product_categories

list_product_brands

search_equipment

get_equipment_profile

search_fertilizers

get_fertilizer_profile

check_species_compatibility

get_water_parameters

suggest_species_for_tank

`search_fish`

`get_fish_profile`

`search_plants`

`get_plant_profile`

`search_products`

`get_product_profile`

`search_guides`

`get_guide`

`search_algae`

`get_algae_profile`

`search_diseases`

`get_disease_profile`

`search_plant_problems`

`get_plant_problem_profile`

`search_medicines`

`get_medicine_profile`

`match_diagnostic_profiles`

`list_product_categories`

`list_product_brands`

`search_equipment`

`get_equipment_profile`

`search_fertilizers`

`get_fertilizer_profile`

`check_species_compatibility`

`get_water_parameters`

`suggest_species_for_tank`

`suggest_habitat_for_tank`

`search_fertilization_regimes`

`get_fertilization_regime`

`calculate_fertilizer_dose`

`calculate_nutrient_gaps`

`calculate_weekly_dose_totals`

`generate_fertilization_plan`

`calculate_tank_volume`

`calculate_tank_weight`

`calculate_water_change`

`calculate_water_chemistry`

`convert_units`

`calculate_equipment_requirements`