MCP server exposing 5 tools for copernicus-cds.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/copernicus-cds/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}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 networks). Returns each collection id (pass it to cds_collection or cds_submit_request), title, and the temporal/spatial extent it covers. Keyless. AUTHORITATIVE for "which Copernicus/C3S dataset covers X" — the catalogue itself, not a description of 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 extent, documentation links — AND the request form: the variables, years, months, pressure levels, area and output formats the retrieval job will accept. Keyless. Call this before cds_submit_request to learn what the dataset actually accepts.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 learn the accepted inputs; CDS jobs are asynchronous — this returns immediately with a job id. Poll it with cds_job_status (same _apiKey) until it reads "successful", then collect the download link with cds_job_result.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 data can be collected). Unknown or other-account job id returns found:false. Poll until ready is true, then call cds_job_result. Requires the same _apiKey (your own CDS Personal Access Token) that submitted the job.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. If the job is not finished it does NOT return an empty result: it returns ready:false with the current status and tells you to poll cds_job_status. A failed job returns its failure reason. Unknown job id returns found:false. Requires the same _apiKey that submitted the job.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/copernicus-cds/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io