Client setup guides

OpenAI Agents SDK · MCP

Configure OpenAI Agents SDK to use Atlarium through its public remote MCP endpoint.

Compatibility guide

Compatible with MCP clients that support remote Streamable HTTP servers.

Client setup guides Server card Atlarium MCP

HTTP: Streamable
OAuth: —
MCP: 39 read-only tools
✓: Compatibility guide

Install

Python example

Compatibility 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

Add the public Atlarium endpoint to the client configuration.
Confirm that the client discovers the Atlarium tools.
Run a habitat or compatibility request and check the advisory output.

Production notes

Keep claims precise

Use the public read-only endpoint and treat compatibility and planning results as advisory.

Structured aquarium, marine, terrarium and paludarium data for AI agents.

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

Example prompts

Practical agent workflows

Examples based on catalog lookup, diagnostics, products, compatibility and planning.

Example prompts 1

Suggest peaceful freshwater species for a planted 90-liter aquarium.

Example prompts 2

Compare the compatibility of two species and explain the main risks.

Example prompts 3

Identify likely causes of an algae problem from the observed symptoms.

Safety boundary

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

Back to Atlarium

FAQ

Does the endpoint require authentication?

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

Can agents write to Atlarium workspaces?

No. Workspace, account and administration surfaces are outside this server.

Are compatibility answers definitive?

No. They are advisory and must be checked against current husbandry conditions.