Atlarium Habitat Database MCP

Atlarium Habitat Database MCP

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

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

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

What You Can Build

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

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:

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

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."

{

"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."

{

"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."

{

"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."

{

"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."

{

"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."

{

"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."

{

"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: