Data catalogue

33 results

Coverage unknown. Describe a dataset, get a multi-tab Excel workbook — retrieved from the data warehouse, official releases and filings, with the source of every cell.

• build dataset

  Dataset Builder

  End to end in one call: spec → entities → plan → retrieve → reconcile → fill gaps → validate → workbook. Takes minutes; clients with short HTTP timeouts should use start_dataset_job + get_dataset_job. To review the spec first, call define_dataset_spec, edit, then start_dataset_job(dataset_id=...).

  capability

• build workbook

  Dataset Builder

  Write the .xlsx: README, the spec's data tabs (derived rows as live formulas, sources in cell comments), Sources, Provenance, Conflicts, Gaps, Validation.

  capability

• cancel dataset job

  Dataset Builder

  Cancel a local background build; keep recorded evidence for restart with start_dataset_job(dataset_id=...). Completed tasks are not retrieved again.

  capability

• check dataset values

  Dataset Builder

  Dry-run the value gate. Return each rejection reason and normalized value without writing candidates or marking a task complete.

  capability

• coverage matrix

  Dataset Builder

  Entity × period grid of cell status (R reported, D derived, O override, · missing) per metric.

  capability

• define dataset spec

  Dataset Builder

  Create a dataset and its Spec: entities (rows), metrics (definition, unit, basis, domain, derive formula), periods (frequency, range) and tab layout. Pass `spec` to supply one directly (same shape as returned) instead of having it drafted from `query`. Review the result — and edit with update_dataset_spec — before retrieval: every later cost is driven by this grid.

  capability

• discover sources

  Dataset Builder

  Connect to registered sources, list their tools, infer capabilities; optionally list candidates from the MCP registry (INSIGHT_MCP_REGISTRY_URL).

  capability

• download workbook

  Dataset Builder

  The latest workbook: a signed 24-hour download link that opens in a browser, and, with include_base64=True, the file itself (≤ 15 MB).

  capability

• estimate cost

  Dataset Builder

  Cells, tasks, expected tool calls and minutes for the current Spec.

  capability

• fill gaps

  Dataset Builder

  Plan one narrower follow-up round for missing cells (must-have metrics by default) and, with run=True, execute it and re-reconcile. Cells still missing afterwards stay blank and are listed on the Gaps tab.

  capability

• get dataset

  Dataset Builder

  Dataset state: stages run, counts, outputs, and the Spec.

  capability

• get dataset evidence

  Dataset Builder

  Read the exact stored structured result behind a candidate's source_ref. Host-imported evidence is labelled host_supplied_result.

  capability

• get dataset job

  Dataset Builder

  Status of a background build: status (running | done | failed), stage, progress 0-1; when done, the workbook summary, download link and validation. Long-polls up to wait_seconds (max 30) for a change; pass 0 for an immediate snapshot. A job left by a previous process is marked interrupted and can be restarted.

  capability

• get retrieval tasks

  Dataset Builder

  Host mode: tasks with a ready agent prompt and the value schema, for your own agents and MCPs. Return their values with submit_values.

  capability

• import dataset rows

  Dataset Builder

  Import a structured host result by column mapping, without retyping numbers. result: {columns: [...], rows: [[...]]} or {rows: [{...}]}. mapping: {entity_column|entity_constant, period_column, metrics: [{metric, column, unit}], basis, source_type, source_url, source_title, rows_path?}. Evidence is retained, every value is gated, identical retries are idempotent. Task remains open for more batches;

  capability

• inspect dataset cell

  Dataset Builder

  Explain one cell: chosen source, all candidates/conflicts, override, formula dependencies, and persisted evidence ids. IDs and period must match the spec.

  capability

• list sources

  Dataset Builder

  Registered sources (SQL, web search, fact stores, browsers, …) with capabilities and cost rung, plus the capability vocabulary tasks are routed by.

  capability

• list values

  Dataset Builder

  The value ledger — every candidate an agent recorded (status: accepted | parked | all), filterable by entity id, metric id and period key.

  capability

• plan retrieval

  Dataset Builder

  Batch the cell grid into retrieval tasks (entity × metric domain × period run) and route each to the registered sources whose capabilities fit (SQL and structured sources first). `sources` restricts this dataset to those source names.

  capability

• preflight dataset

  Dataset Builder

  Check LLM readiness and source routing without spending retrieval calls. Reports host-mode alternatives. Use discover_sources to probe connectivity.

  capability

Inventory snapshot 15 Nov 2026. Publisher dates and individual source checks can differ.