list_supported_species

Instructions

Implementation Reference

• atmospore_mcp/server.py:223-238 (handler)

  The list_supported_species() tool handler function. It calls client.species(), transforms each species into a dict with species slug, display_name, category, multilingual names, and risk thresholds, and wraps the call with _safe_call for structured error handling.

  @mcp.tool(description=LIST_SUPPORTED_SPECIES_DESCRIPTION)
  async def list_supported_species() -> dict[str, Any]:
      async def call() -> Any:
          species = await client.species()
          return [
              {
                  "species": s.species,
                  "display_name": s.display_name,
                  "category": s.category,
                  "names": s.names,
                  "risk_thresholds": s.risk_thresholds,
              }
              for s in species
          ]
  
      return await _safe_call(call())

• atmospore_mcp/server.py:58-62 (schema)

  Description string (LIST_SUPPORTED_SPECIES_DESCRIPTION) used as the tool description for the LLM. Documents that it returns slug, display name, category, localised names, and risk thresholds.

  LIST_SUPPORTED_SPECIES_DESCRIPTION = """List all pollen species the model tracks, with metadata.
  
  Use this if the user asks "what species do you cover?" or to validate a species name before
  using it in another tool. Returns slug, display name, category (tree/grass/weed), localised
  display names (en, no, sv), and concentration thresholds for the risk levels."""

• atmospore_mcp/server.py:223-224 (registration)

  Registration of list_supported_species as an MCP tool via the @mcp.tool(description=LIST_SUPPORTED_SPECIES_DESCRIPTION) decorator inside build_server().

  @mcp.tool(description=LIST_SUPPORTED_SPECIES_DESCRIPTION)
  async def list_supported_species() -> dict[str, Any]:

• atmospore_mcp/server.py:78-78 (helper)

  Reference in the help resource listing list_supported_species() as an available tool.

  | `list_supported_species()` | What species are tracked, with multilingual names |

• tests/test_server.py:138-160 (helper)

  Test for list_supported_species that verifies the tool returns correct data shape (species slug, multilingual names, etc.) when called.

  async def test_list_supported_species(server):
      payload = {
          "data": {
              "birch": {
                  "display_name": "Birch",
                  "category": "tree",
                  "names": {"en": "Birch", "no": "Bjørk", "sv": "Björk"},
                  "risk_thresholds": [15, 90, 500, 1500],
              }
          }
      }
      tool = _get_tool(server, "list_supported_species")
  
      with aioresponses() as m:
          m.get(f"{BASE}/species", payload=payload)
          result = await tool()
  
      assert result["ok"] is True
      assert len(result["data"]) == 1
      s = result["data"][0]
      assert s["species"] == "birch"
      assert s["names"] == {"en": "Birch", "no": "Bjørk", "sv": "Björk"}