OpenLandMap MCP Server

Instructions

Implementation Reference

• src/openlandmap_mcp/tools/catalog.py:26-49 (handler)

  The catalog_info tool handler implementation. It uses the STAC client to fetch catalog metadata and return it formatted as a CatalogInfo model.

  @mcp.tool()
  async def catalog_info() -> dict:
      """Return metadata about the OpenLandMap STAC root catalog.
  
      Returns the catalog identifier, description, STAC version, total number
      of collections, and conformance classes.
  
      Example return:
          {"id": "openlandmap", "stac_version": "1.0.0", "total_collections": 104, ...}
      """
      try:
          catalog = await client.get_catalog()
          index = await client.get_catalog_index()
      except STACClientError as exc:
          return {"error": f"Failed to fetch catalog: {exc}"}
  
      info = CatalogInfo(
          id=catalog.get("id", ""),
          description=catalog.get("description", ""),
          stac_version=catalog.get("stac_version", ""),
          total_collections=len(index),
          conformsTo=catalog.get("conformsTo", []),
      )
      return info.model_dump()

• src/openlandmap_mcp/models.py:14-21 (schema)

  The Pydantic model defining the schema for the catalog_info tool's output.

  class CatalogInfo(BaseModel):
      """Root catalog metadata."""
  
      model_config = ConfigDict(frozen=True)
  
      id: str
      description: str
      stac_version: str