wdpa-mcp

A dedicated conservation zoning and protected areas Model Context Protocol (MCP) server for the World Database on Protected Areas (WDPA) and Protected Planet API v3.

Provides critical spatial conservation context to biodiversity observations (iNaturalist, eBird, GBIF), checking if wildlife sightings fall inside or adjacent to national parks, wilderness reserves, UNESCO biosphere reserves, or marine protected areas.

Key Features

• International Designation Filtering: Query reserves classified under global conventions, including Ramsar Wetlands of International Importance, UNESCO World Heritage Sites, and Biosphere Reserves.

• Reserve Proximity Evaluation: Query coordinates (lat, lon, radius_km) to determine if a species observation is inside or near a protected conservation reserve.

• IUCN Management Categories: Identify strict nature reserves (Ia), wilderness areas (Ib), national parks (II), natural monuments (III), habitat management areas (IV), protected landscapes (V), and sustainable resource management reserves (VI).

• National Coverage & 30x30 Metrics: Retrieve terrestrial and marine protected surface area percentages by ISO-3 country to track progress toward Kunming-Montreal Global Biodiversity Framework targets.

• Resilient Fallback Engine: Built-in curated conservation registry ensures proximity queries and searches work reliably even without an external API token or during upstream downtime.

Related MCP server: earth-search

Available Tools

Installation & Usage

Running with uvx (Recommended)

uvx --from git+https://github.com/thesven/wdpa-mcp.git wdpa-mcp

Configuration (Optional)

If you have a Protected Planet API v3 token, you can provide it via environment variable:

PROTECTED_PLANET_API_KEY=your_token_here
# or
WDPA_API_KEY=your_token_here

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "wdpa": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/thesven/wdpa-mcp.git", "wdpa-mcp"],
      "env": {
        "PROTECTED_PLANET_API_KEY": "optional_token_here"
      }
    }
  }
}

Development & Quality Gate

# Run code formatting check
uv run ruff format --check src tests scripts

# Run linting
uv run ruff check src tests scripts

# Run test suite with strict coverage floor (>90%)
uv run pytest --cov=wdpa_mcp --cov-branch --cov-report=term-missing

# Build wheel and sdist
uv build

# Run package distribution check & smoke test
uv run python scripts/check_dist.py
uv run python scripts/smoke.py

License

MIT License. See LICENSE for details.