# ICOS carbon and greenhouse-gas observations

> ICOS carbon and greenhouse-gas observations is a free MCP server for health and science. ICOS greenhouse-gas observations from air, land and ocean with citations and DOIs. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://mcp.icos-cp.eu
- **Repository:** https://github.com/icos-carbon-portal/icos-mcp
- **MCP Registry name:** eu.icos-cp/icos
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-14

## About

Every data answer includes the citation, licence and DOI from an RO-Crate data passport, and near-real-time data cite the exact data object. The server is a thin layer over the ICOS zarr service, so every number comes from there, and heavy computation stays on the server next to the data.

Datasets cover atmospheric greenhouse-gas mole fractions, ecosystem eddy-covariance fluxes such as NEE, GPP and RECO, and surface-ocean fCO2 from SOCAT. The workflow runs in four steps: discover variables and stations, estimate the size of a selection, compute, then fetch with a citation. A fetch returns at most 2,000 rows plus a CSV link for the whole selection.

It offers only stores a rule names, by default-deny policy. Data are CC BY 4.0. Connect as a custom connector in Claude, or with claude mcp add.

## Features

- **Citations in every answer:** Licence, citation and DOI come with the data.
- **Variable and station search:** Find variables by name and stations near a point.
- **Size estimates:** Check selection size before fetching.
- **Server-side computation:** Statistics run next to the data.
- **Three domains:** Atmosphere, ecosystem and ocean datasets.
- **Default-deny stores:** Only named stores are exposed.

## Good for

- Find stations measuring methane in a region
- Fetch NEE fluxes with proper citation
- Compare surface-ocean fCO2 series
- Estimate a download before fetching

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http icos https://mcp.icos-cp.eu/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.icos-cp.eu/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "icos": {
      "url": "https://mcp.icos-cp.eu/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "icos": {
      "type": "http",
      "url": "https://mcp.icos-cp.eu/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "icos": {
      "serverUrl": "https://mcp.icos-cp.eu/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.icos-cp.eu/mcp
```

Enter a Name (for example "ICOS carbon and greenhouse-gas observations"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "icos": {
      "type": "http",
      "url": "https://mcp.icos-cp.eu/mcp"
    }
  }
}
```

## Tools

- `list_datasets`: List stores with domain, coverage, licence and DOI
- `search_variables`: Find variable ids by name or unit
- `describe_variable`: Describe one variable
- `find_stations`: Find stations carrying a variable
- `estimate`: Size a selection before fetching it
- `get_data`: Fetch rows with a CSV link and citation
- `get_citation`: Citation, licence and DOI
- `tokens_file`: Token file for downloads

## FAQ

### What licence applies?

ICOS data are CC BY 4.0.

### Is sign-in needed?

The public landing describes anonymous access to public datasets.

### How many rows per fetch?

At most 2,000, plus a CSV URL for the full selection.

### Does it compute on the server?

Yes, statistics are computed server-side.

### Is ICOS carbon and greenhouse-gas observations free?

Yes. ICOS carbon and greenhouse-gas observations is free to use.

### How do I add ICOS carbon and greenhouse-gas observations to Claude Code?

Run this command in your terminal: claude mcp add --transport http icos https://mcp.icos-cp.eu/mcp

### What are the best alternatives to ICOS carbon and greenhouse-gas observations?

The closest alternatives to ICOS carbon and greenhouse-gas observations are Climate Insights Directory, open-signals, AOI — Environmental Intelligence for AI Agents, OCEI v2.2 Orbital Compute & Arbitrage Oracle and CLIO Hdf5.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Climate Insights Directory](https://ai-powered.com/mcp/climate-insights-directory): Climate Insights Directory is an MCP server for health and science.
- [open-signals](https://ai-powered.com/mcp/open-signals): open-signals is a free MCP server for analytics and data.
- [AOI — Environmental Intelligence for AI Agents](https://ai-powered.com/mcp/aoi-environmental-intelligence-for-ai-agents): AOI — Environmental Intelligence for AI Agents is a paid MCP server for analytics and data.
- [OCEI v2.2 Orbital Compute & Arbitrage Oracle](https://ai-powered.com/mcp/ocei-v2-2-orbital-compute-and-arbitrage-oracle): OCEI v2.2 Orbital Compute & Arbitrage Oracle is an MCP server for cloud and infrastructure.
- [CLIO Hdf5](https://ai-powered.com/mcp/clio-hdf5): CLIO Hdf5 is an open-source MCP server for analytics and data.
- [DailyMeteo](https://ai-powered.com/mcp/dailymeteo): DailyMeteo is a freemium MCP server for maps and travel.
- [InfraMap](https://ai-powered.com/mcp/inframap): InfraMap is a free MCP server for analytics and data.
- [Open Index](https://ai-powered.com/mcp/open-index): Open Index is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/icos-carbon-and-greenhouse-gas-observations
