Atlarium

MCP Client Guide

Use Atlarium MCP with OpenAI Agents SDK

Connect an agent to the public Streamable HTTP endpoint and let it discover the read-only Atlarium tools.

SDK guide

Compatible with MCP clients that support remote Streamable HTTP MCP servers.

Client docsServer cardMCP overview
Transport
Streamable HTTP
Auth
None
Tools
39 read-only tools
Status
SDK guide

Install

Python example

SDK guide
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="Atlarium Habitat Database MCP",
    params={"url": "https://mcp.atlarium.bio/mcp", "timeout": 10},
    cache_tools_list=True,
) as atlarium:
    agent = Agent(
        name="Habitat planner",
        instructions="Use Atlarium for public habitat data. Treat compatibility and tank suggestions as advisory.",
        mcp_servers=[atlarium],
    )

    result = await Runner.run(
        agent,
        "Suggest peaceful freshwater species for a 90 liter planted tank at 24 C and pH 6.8.",
    )
    print(result.final_output)

Verify setup

  1. Run the script in an environment with the OpenAI Agents SDK installed.
  2. Confirm the agent can list Atlarium tools before asking habitat questions.
  3. Check that answers cite tool output as advisory habitat guidance.

Production Notes

Keep claims precise

Structured aquarium, marine, terrarium and paludarium data for AI agents. Public read-only tools only; no workspace, user, auth, admin or write APIs are exposed.

Can be used with OpenAI Agents SDK.

No Atlarium API key is required for the public MCP endpoint.

Example Prompts

Practical agent workflows

These prompts stay close to the current public tool surface: catalog lookup, diagnostics, products, guides, compatibility, fertilization, calculators and complete habitat planning.

Species research

Use Atlarium to compare neon tetra and harlequin rasbora care requirements for a planted community aquarium.

Compatibility check

Check whether Corydoras paleatus and Betta splendens are compatible, and explain the water parameter tradeoffs.

Tank planning

Suggest peaceful freshwater species for a 90 liter planted tank at 24 C with pH 6.8.

Guide lookup

Find Atlarium guide data for nitrate and summarize what an aquarist should monitor.

Algae diagnosis

Use Atlarium to identify likely causes of black beard algae and summarize public treatment options.

Plant deficiency

Search Atlarium plant problems for yellowing new growth and compare likely nutrient gaps.

Fertilization plan

Generate an advisory fertilization plan for a 90 liter planted aquarium using public Atlarium catalog data.

Tank calculators

Calculate volume, weight and water change amounts for a 60 x 30 x 36 cm aquarium.

Safety boundary

Public read-only tools only; no workspace, user, auth, admin or write APIs are exposed.

Back to Atlarium

FAQ

Does the endpoint require authentication?

No. The public endpoint exposes only read-only tools backed by public Atlarium data.

Can agents write to Atlarium workspaces?

No. Workspace data, journals, schedules, measurements, authentication and admin surfaces are outside this MCP server.

Are compatibility answers definitive?

No. Compatibility, parameters and tank suggestions are advisory and should be validated against current husbandry conditions.