neso_query_data

Pack: neso · Endpoint: https://gateway.pipeworx.io/neso/mcp

Query rows from a NESO GB energy dataset resource (CKAN DataStore) by resource_id — UK electricity demand, wind generation forecasts, carbon intensity, balancing data. Supports exact-match filters (field->value object), full-text query, limit, offset. Returns field names/types plus records. Example: neso_query_data({ resource_id: “aec5601a-7f3e-4c4c-bf56-d8e4184d3c5b”, limit: 20 })

Parameters

NameTypeRequiredDescription
resource_idstringyesResource id from neso_dataset_resources (must have datastore_active true).
filtersobjectnoOptional exact-match filters, e.g. { “DAYSAHEAD”: 1 }.
querystringnoOptional full-text search over the rows.
limitnumbernoMax rows, 1-200 (default 20).
offsetnumbernoPagination offset (default 0).
sortstringnoOptional sort, e.g. “TARGETDATE desc”.

Example call

Arguments

{
  "resource_id": "aec5601a-7f3e-4c4c-bf56-d8e4184d3c5b",
  "limit": 20
}

curl

curl -X POST https://gateway.pipeworx.io/neso/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"neso_query_data","arguments":{"resource_id":"aec5601a-7f3e-4c4c-bf56-d8e4184d3c5b","limit":20}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('neso_query_data', {
  "resource_id": "aec5601a-7f3e-4c4c-bf56-d8e4184d3c5b",
  "limit": 20
});

More examples

{
  "resource_id": "aec5601a-7f3e-4c4c-bf56-d8e4184d3c5b",
  "filters": {
    "DAYSAHEAD": 1
  },
  "limit": 50,
  "sort": "TARGETDATE desc"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

Regenerated from source · build August 29, 2026