Atlarium Habitat Database MCP

by techgardeners

328 downloads

Not rated

GitHub

About

Public read-only MCP server for structured aquarium, marine, terrarium and paludarium habitat data. Exposes 39 read-only tools, 9 guided prompts and an Apps-compatible Habitat Explorer widget over a Streamable HTTP endpoint with auth none.

Details

Author: techgardeners
Downloads: 328
Categories: Other, Database, Knowledge Base, AI

- 39 public read‑only tools across species, plants, products, diagnostics, calculators, and habitat planning
- 9 guided prompts that steer clients toward the same tool surface
- Streamable HTTP transport with no authentication required
- Compatibility checks, fertilization calculators, and tank volume/weight/chemistry calculators
- Diagnostic triage for algae, diseases, plant problems, and medicines
- Habitat planner that generates a complete advisory tank plan

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Atlarium Habitat Database MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Configure any MCP client that supports remote Streamable HTTP servers with the endpoint https://mcp.atlarium.bio/mcp. For example, add the server to your client’s MCP configuration as a streamable-http type with that URL, or use the command claude mcp add --transport http atlarium https://mcp.atlarium.bio/mcp for Claude Code.

`search_fish`

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

`get_fish_profile`

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

`search_plants`

Search aquatic plants in the Atlarium database.

`get_plant_profile`

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

`search_products`

Search public habitat products in the Atlarium database.

`get_product_profile`

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

`check_species_compatibility`

Check basic compatibility information between habitat species using Atlarium data.

`get_water_parameters`

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

`suggest_species_for_tank`

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

`search_guides`

Search Atlarium habitat guides and educational content.

`get_guide`

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

`search_algae`

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

`get_algae_profile`

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

`search_diseases`

Search public aquatic disease diagnostic profiles and advisory treatment information.

`get_disease_profile`

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

`search_plant_problems`

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

`get_plant_problem_profile`

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

`search_medicines`

Search public aquarium medicine and treatment product profiles.

`get_medicine_profile`

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

`match_diagnostic_profiles`

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

`list_product_categories`

List public Atlarium product categories for equipment and fertilizers.

`list_product_brands`

List public Atlarium product brands.

`search_equipment`

Search public aquarium and habitat equipment products.

`get_equipment_profile`

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

`search_fertilizers`

Search public aquarium fertilizer products and nutrient profiles.

`get_fertilizer_profile`

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

`search_fertilization_regimes`

Search public fertilization regimes and dosing philosophies.

`get_fertilization_regime`

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

`calculate_fertilizer_dose`

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

`calculate_nutrient_gaps`

Compare nutrient targets with supplied measurements without saving user data.

`calculate_weekly_dose_totals`

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

`generate_fertilization_plan`

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

`calculate_tank_volume`

Calculate gross and net aquarium volume estimates from dimensions.

`calculate_tank_weight`

Calculate advisory aquarium weight estimates from dimensions and material inputs.

`calculate_water_change`

Calculate water change volume, weekly totals and dilution estimates.

`calculate_water_chemistry`

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

`convert_units`

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

`calculate_equipment_requirements`

Calculate advisory heater, lighting and electricity requirements.

`suggest_habitat_for_tank`

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

{
    "atlarium-habitat-database": {
        "url": "https://mcp.atlarium.bio/mcp",
        "transport": "streamable-http"
    }
}

<h1 align="center">Atlarium Habitat Database MCP</h1>

<p align="center">
Public read-only MCP server for Atlarium habitat data, diagnostics, products, calculators and advisory planning.
</p>

<p align="center">
<a href="https://github.com/techgardeners/atlarium-mcp/actions/workflows/public-mcp-monitor.yml"></a>
<a href="https://github.com/techgardeners/atlarium-mcp/actions/workflows/mcp-directory-audit.yml"></a>
<a href="LICENSE"> MIT License </a>
<a href="https://registry.modelcontextprotocol.io/v0.1/servers?search=bio.atlarium%2Fhabitat-database"></a>

</p>

<p align="center">
<a href="https://mcp.atlarium.bio/mcp">MCP endpoint</a>
·
<a href="https://atlarium.bio/mcp">Human docs</a>
·
<a href="https://mcp.atlarium.bio/.well-known/mcp/server-card.json">Server card</a>
·
<a href="docs/mcp.md">Technical docs</a>
·
<a href="examples">Client examples</a>
</p>

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.0 |
| Transport | Streamable HTTP |
| Authentication | none |
| Tool surface | 39 public read-only tools |
| Prompts | 9 guided public prompts |
| Apps widget | ui://widget/habitat-explorer.v3.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:

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

Claude Code remote HTTP example:

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

Smoke check the live endpoint:

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 | Copy examples/cursor/mcp.json into your Cursor MCP config and reload Cursor. |
| 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 | Submitted for review with the Habitat Explorer widget; use examples/chatgpt-apps for review notes, smoke prompts and screenshot checklist. Public approval is not claimed. |

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.

ChatGPT App And Widget

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

| Field | Value |
| --- | --- |
| Resource URI | ui://widget/habitat-explorer.v3.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.

ChatGPT Developer Mode screenshots and a short demo recording are checked in
under docs/assets/chatgpt-screenshots/ and docs/assets/chatgpt-app-demo.mp4.
The ChatGPT App is submitted / in review; do not describe it as approved or
publicly available until OpenAI accepts it.

Tool Surface

…

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

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

Claude Desktop / Cursor

McpServers

At A Glance

What You Can Build

Quickstart

Client Setup

ChatGPT App And Widget

Tool Surface

Install

More like this

Sequential Thinking

Aws Kb Retrieval Server

Redis

Memory

Filesystem

EverArt

`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`