UK Official Statistics Series Finder (ONS Time Series by Title or Series ID)

ons/search-time-series

Search the Office for National Statistics' time series (UK inflation, labour market, GDP, trade, public finances, population and more; 58,720 series) by words from the series title or by its series id. Each hit gives the series id (cdid), the dataset it belongs to, the full title, the release date of its latest figures, and the uri to pass to ONS Latest Figure for a Time Series or ONS Full History of a Time Series. Matches any word, ranked by relevance, so search with the exact wording of a title (for example CPI ANNUAL RATE 00: ALL ITEMS) or with a series id. The same series id can exist in several datasets with different vintages; choose by dataset and release date. A Beta service with no service-level guarantee. Attribution: Contains public sector information licensed under the Open Government Licence v3.0. Source: Office for National Statistics.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Office for National Statistics

Contains public sector information licensed under the Open Government Licence v3.0. Source: Office for National Statistics. Served by Omnial; not an official Office for National Statistics product and not endorsed by it.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "ons/search-time-series" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "ons/search-time-series" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "ons/search-time-series", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "ons/search-time-series", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0026

Updated: Oct 19, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 0,
      "description": "How many hits to return, 0 to 50 (default 10). 0 returns only the match counts."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Words from the series title, or a series id such as D7G7 (CPI annual rate), MGSX (unemployment rate) or L55O (CPIH annual rate). Matches any word, ranked by relevance; the exact title wording ranks the right series first."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 10000,
      "minimum": 0,
      "description": "How many hits to skip, for paging (default 0). Past the last hit, items is empty."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "count",
    "items"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "description": "How many time series match the query in all. Not the length of items."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "cdid",
          "dataset_id",
          "title",
          "uri",
          "release_date"
        ],
        "properties": {
          "uri": {
            "type": "string",
            "description": "The series' page path, for example /economy/inflationandpriceindices/timeseries/d7g7/mm23. Pass it unchanged as uri to the two time-series data tools."
          },
          "cdid": {
            "type": "string",
            "description": "The series id, upper case and usually four characters, for example D7G7. Not unique across datasets."
          },
          "title": {
            "type": "string",
            "description": "The series title, plain text, including the unit and seasonal-adjustment wording ONS gives it."
          },
          "highlight": {
            "type": "object",
            "description": "The title with matched words wrapped in HTML em tags. Markup from the publisher; use title for the text.",
            "additionalProperties": true
          },
          "dataset_id": {
            "type": "string",
            "description": "The ONS dataset the series is published in, for example MM23 (consumer price inflation) or LMS (labour market). The same cdid in another dataset is a different series."
          },
          "release_date": {
            "type": "string",
            "description": "When the series was last released, an ISO 8601 UTC instant. ONS releases at UK midnight, so a summer release reads as 23:00 UTC the day before."
          }
        },
        "additionalProperties": true
      },
      "description": "The hits for this page, most relevant first. Empty when nothing matches or offset is past the last hit."
    }
  },
  "description": "The Office for National Statistics' search response: count (how many series match in all, not the length of items) and items, the page of hits in relevance order.",
  "additionalProperties": true
}