`cds_job_result`

Pack: copernicus-cds · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/cds_job_result for the schema, then POST the same URL with its arguments for the data.

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.

Parameters

Name	Type	Required	Description
`job_id`	string	yes	The job id returned by cds_submit_request (job.jobID).
`_apiKey`	string	yes	Your own Copernicus CDS Personal Access Token (BYO), the one that submitted the job. ${KEY_HELP}

Example call

Arguments

{
  "job_id": "0b1c2d3e-4f50-6172-8394-a5b6c7d8e9f0"
}

curl

curl -X POST https://gateway.pipeworx.io/copernicus-cds/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cds_job_result","arguments":{"job_id":"0b1c2d3e-4f50-6172-8394-a5b6c7d8e9f0"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('cds_job_result', {
  "job_id": "0b1c2d3e-4f50-6172-8394-a5b6c7d8e9f0"
});

Response shape

Always returns: found, job_id

Field	Type	Description
`found`	boolean
`job_id`	string
`collection_id`	string \| null
`status`	string	accepted, running, successful, failed or dismissed
`ready`	boolean	true only when the data can be collected
`created`	string \| null
`started`	string \| null
`finished`	string \| null
`updated`	string \| null
`source`	string
`note`	string
`next`	string
`download`	object \| null	null until the job is successful
`failure`	string

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "job_id": {
      "type": "string"
    },
    "collection_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "description": "accepted, running, successful, failed or dismissed"
    },
    "ready": {
      "type": "boolean",
      "description": "true only when the data can be collected"
    },
    "created": {
      "type": [
        "string",
        "null"
      ]
    },
    "started": {
      "type": [
        "string",
        "null"
      ]
    },
    "finished": {
      "type": [
        "string",
        "null"
      ]
    },
    "updated": {
      "type": [
        "string",
        "null"
      ]
    },
    "source": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "next": {
      "type": "string"
    },
    "download": {
      "type": [
        "object",
        "null"
      ],
      "description": "null until the job is successful",
      "properties": {
        "href": {
          "type": "string"
        },
        "type": {
          "type": [
            "string",
            "null"
          ]
        },
        "size_bytes": {
          "type": [
            "number",
            "null"
          ]
        },
        "expires": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "failure": {
      "type": "string"
    }
  },
  "required": [
    "found",
    "job_id"
  ],
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the copernicus-cds pack

{
  "mcpServers": {
    "copernicus-cds": {
      "url": "https://gateway.pipeworx.io/copernicus-cds/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

cds_job_result