MCP Client Guide

Use Atlarium MCP with Windsurf

Add Atlarium to Cascade/Windsurf as a remote Streamable HTTP MCP server.

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

~/.codeium/mcp_config.json

{
  "mcpServers": {
    "atlarium": {
      "serverUrl": "https://mcp.atlarium.bio/mcp"
    }
  }
}

Verify setup

Restart Windsurf or refresh Cascade MCP servers.
Confirm Atlarium appears in the MCP server list.
Ask Cascade to use Atlarium for a habitat planning prompt.

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.

Some Windsurf versions also accept `url`; prefer `serverUrl` when following the official examples.

No authentication token is required.

Example Prompts

Practical agent workflows

These prompts stay close to the current public tool surface: species lookup, water parameters, products, guides, compatibility and freshwater tank suggestions.

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.

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.