Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CHEMCARD_ALLOWED_HOSTSNoTunnel domain(s) to allow through the MCP SDK's DNS rebinding protection, e.g. xxxx.ngrok-free.app. Without it, requests return 421 Invalid Host header.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Whenever an answer is about a specific molecule or reaction (its structure, which part reacts, a mechanism), draw it inline like a textbook figure: draw_molecule for a molecule, draw_reaction_step for each step (check_mechanism first if multi-step). Interleave: figure, then its explanation. Mark the atoms/bonds you discuss with highlights. If the user selected atoms (mapped SMILES in their message), redraw from it and highlight them. Skip trivial species.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
draw_moleculeA

Show a clean 2D structure of ONE molecule inline in the explanation. Call it when the explanation refers to a specific molecule's structure (functional groups, protecting groups, stereochemistry, why it reacts as it does). Put each figure next to the paragraph about that molecule: when comparing two molecules, draw the first, explain it, then draw the second and explain it; do not draw both first. When the text is about part of the molecule (a group, an atom, a bond), highlight that part with highlights so the reader sees what the sentence refers to. If the user selected atoms in a card, redraw from the atom-mapped SMILES they sent and highlight those atom numbers. For a reaction or mechanism step use draw_reaction_step instead. Do not call it for trivial species (H2O, HCl) or purely conceptual answers. If the tool reports invalid SMILES, fix the SMILES and call again.

draw_reaction_stepA

Show ONE reaction or mechanism step as a scheme 'A + B → C' (conditions over the arrow). When explaining a mechanism, go step by step: call this tool for step 1, then explain step 1 directly below it in 1–4 sentences, then call it for step 2, and so on. Never draw all steps first and explain them afterwards. A step may have 1–4 species per side. Small byproducts (H2O, H+) can go in the products or in conditions. Mark the reacting centres with highlights (e.g. the attacking atom in blue, the electrophilic carbon or the bond that breaks in red). Write charged atoms with their H explicitly ([NH+], [OH2+]); a bracket atom without H becomes a radical and the step is refused. The result reports imbalance and unusual species (methyl/primary cations, strong base in acid); if one reveals a mistake, fix the step and call again.

render_structure_svgB

Card-internal: fetch a drawing when the host did not deliver it in the tool result's _meta.

describe_selectionB

Card-internal: turn atoms the user clicked into fragment and atom-mapped SMILES.

check_mechanismA

Validate a whole multi-step mechanism before drawing it (no figure is shown). Checks every species (valid SMILES, unexpected radicals from a bracket atom missing its H, unstabilised methyl/primary cations, strong bases under acidic conditions and vice versa, doubly charged species), each step's atom and charge balance, and that every step starts from an intermediate produced by the previous step. Call it once with all steps, fix every [error], consider each [warning], then draw the steps one at a time with draw_reaction_step.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
ui://chemcard/card-v5.html

TDQS

A3.9/5.0

Scored across 5 tools

Disambiguation4/5

The tools mostly have distinct purposes: draw_molecule for single structures, draw_reaction_step for reaction schemes, check_mechanism for validation, and the two card-internal tools for rendering and selection parsing. The only mild overlap is between draw_molecule and render_structure_svg, but the latter is clearly marked as card-internal fallback behavior.

Naming Consistency5/5

All names follow a consistent snake_case verb_noun pattern: draw_molecule, draw_reaction_step, render_structure_svg, describe_selection, check_mechanism. The minor format suffix in render_structure_svg does not break the overall convention.

Tool Count5/5

Five tools is well-scoped for a chemistry explanation card assistant, and each tool has a clear, non-redundant role in drawing, validating, or handling user selections. No tool feels superfluous or missing from the core workflow.

Completeness4/5

The surface covers the main lifecycle: drawing single molecules, drawing reaction steps, validating multi-step mechanisms, and handling card-internal rendering and selections. A possible minor gap is lookup/conversion from compound names to SMILES, but that may be outside the stated visualization purpose.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues