# atmospore/atmospore-mcp [Health: Active]

**Category:** 🌳 Environment & Nature  
**Repository:** https://github.com/atmospore/atmospore-mcp  
**GitHub Stars:** 1  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/atmospore-atmospore-mcp

## Description
Per-species pollen forecasts at any point on Earth, seven days ahead, via the Atmospore API. Tools: getpollen, gettopspecies, getareaaverage, listsupportedspecies. Free tier (100 calls/day, no credit card). Hosted variant at mcp.atmospore.com.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "atmospore-mcp": {
    "command": "uvx",
    "args": ["atmospore-mcp"],
    "env": {
      "ATMOSPORE_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `ATMOSPORE_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What atmospore/atmospore-mcp MCP server does

The atmospore/atmospore-mcp MCP server connects MCP-compatible assistants to the Atmospore pollen forecast API. It returns per-species pollen forecasts for coordinates anywhere on Earth, with coverage described as approximately 28 km resolution and forecasts available up to seven days ahead.

The server is suited to questions such as identifying the dominant pollen near a location, comparing broad pollen categories across an area, or checking when a particular species may peak. It does not provide a general-purpose weather forecast; its documented scope is pollen data.

Four tools are exposed:

- `get_pollen(lat, lon, forecast_days)` retrieves pollen forecasts for a location and requested forecast period.
- `get_top_species(lat, lon, limit)` identifies the highest pollen species at a location.
- `get_area_average(lat, lon, radius_km, forecast_days)` calculates an average across an area around the supplied coordinates.
- `list_supported_species()` lists the species covered by the service.

An `atmospore://help` resource supplies usage notes that can be browsed from Claude Desktop.

## How it works

Each tool call makes a request to the Atmospore API and counts against the API key's daily quota. Coordinates are supplied as latitude and longitude, while forecast length, result count, or area radius are passed to the relevant tool. The server communicates with MCP clients over stdio when launched locally.

The documented free tier allows 100 calls per day without a credit card. The README notes that typical Claude conversations use one to five tool calls, while heavier usage may require a paid Atmospore plan. If the quota is exceeded, the tool returns a structured `quota_exceeded` response for the assistant to explain.

## Setup and configuration

Install the Python package with `pip install atmospore-mcp`. A free API key can be obtained through the Atmospore account page. Set it in the `ATMOSPORE_API_KEY` environment variable before starting the process.

For Claude Desktop, add an MCP server entry whose command is `atmospore-mcp` and whose environment contains `ATMOSPORE_API_KEY`. Claude Desktop configuration files are located under the application-support directory on macOS and the application-data directory on Windows. Restart the client after changing the configuration.

For local development, clone the repository, install its test extras with `pip install -e ".[test]"`, and run `pytest`. The README also shows starting the executable with `ATMOSPORE_API_KEY` set in the shell.

## Tools and capabilities

The atmospore/atmospore-mcp MCP server supports global coordinate queries, species-level results, ranked species results, radius-based averages, and species discovery. These capabilities can support allergy-related questions such as checking birch pollen timing, comparing tree and grass pollen, or comparing locations.

The hosted variant is available at `mcp.atmospore.com`, although the provided material does not specify its connection details or client configuration. The local package is released under the MIT license.

## Limitations and notes

Forecasts use approximately 28 km spatial resolution, so results should not be interpreted as measurements from an individual address. Every tool call consumes quota from the configured API key. The free allowance is limited to 100 calls per day, and the README points heavy users to a paid plan.

An API key is required for the documented local setup. The provided material does not describe authentication methods for the hosted endpoint, additional environment variables, response schemas, or exact forecast-day and radius limits beyond the tool parameters shown.

The atmospore/atmospore-mcp MCP server is documented for Claude and other assistants that support MCP; only Claude Desktop setup instructions are provided in the README.

_Full upstream README: https://allmcps.com/mcp/atmospore-atmospore-mcp/readme_