MCP Client Guide

Use Atlarium MCP with VS Code

Add Atlarium to VS Code MCP configuration for Copilot agent mode and compatible MCP clients.

Agent mode

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

Transport
Streamable HTTP
Auth
None
Tools
39 read-only tools
Status
Agent mode

Install

.vscode/mcp.json or user MCP settings

Agent mode
{
  "servers": {
    "atlarium": {
      "type": "http",
      "url": "https://mcp.atlarium.bio/mcp"
    }
  }
}

Verify setup

  1. Open the MCP servers view in VS Code.
  2. Start the Atlarium server entry and confirm tool discovery succeeds.
  3. Ask a habitat question in an MCP-enabled agent chat.

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.

VS Code uses `type: "http"` for remote MCP servers.

The endpoint is read-only and does not expose Atlarium workspace data.

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.