Copernicus Cds

liveJobsSpaceClimate

The Copernicus Climate Data Store (C3S/ECMWF) catalogue — browse or search the ~140 published climate datasets behind ERA5 reanalysis, CMIP6 and CORDEX projections, satellite essential climate variables and seasonal forecasts, read exactly what each retrieval accepts, and submit a retrieval job.

5tools
0msauth
free tier50 calls/day

Tools

cds_collections

List or keyword-search the Copernicus Climate Data Store catalogue — the ~140 published climate datasets (ERA5 reanalysis, CMIP6/CORDEX projections, satellite ECVs, seasonal forecasts, in-situ network

No parameters required.

▶Try it
cds_collection

Full detail for ONE Copernicus Climate Data Store collection by id (e.g. "reanalysis-era5-single-levels"). Returns the STAC record — title, abstract, keywords, licence, temporal and bounding-box exten

No parameters required.

▶Try it
cds_submit_request

Submit a data-retrieval job to the Copernicus Climate Data Store and return the job id and status. Requires your own free CDS Personal Access Token, passed as _apiKey. Use cds_collection first to lear

No parameters required.

▶Try it
cds_job_status

Check a Copernicus Climate Data Store retrieval job submitted with cds_submit_request. Returns its status (accepted, running, successful, failed or dismissed), timestamps and ready (true only when the

No parameters required.

▶Try it
cds_job_result

Collect the output of a Copernicus Climate Data Store retrieval job: when the job is successful returns the download URL (href) with file type, size in bytes and expiry where the service states them.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/copernicus-cds/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/copernicus-cds/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"cds_collections","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("cds_collections", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("the copernicus climate data store (c3s/ecmwf) catalogue — browse or search the ~140 published climate datasets behind era5 reanalysis, cmip6 and cordex projections, satellite essential climate variables and seasonal forecasts, read exactly what each retrieval accepts, and submit a retrieval job");