add_entities
Add countries or regions to the chart's current selection, keeping what is already shown. Use this for requests like 'also show Poland' or 'add the EU average'.
entities: array
download_chart_data
Give the user a download link for this chart's data as a CSV file, covering the entities and time range currently shown. Use when the user asks to download, export, or save the data.
scope: string?
find_article
Search Our World in Data's articles and written research. Use this whenever the user asks what OWID has written about a topic, or for an article, explainer or piece of writing — chart search does not return prose, so…
query: string
find_chart
Search Our World in Data's charts and return candidates as paths. Pass the countries or regions the user asked about so charts that lack them are flagged. Many OWID topics have several charts whose titles differ in…
query: string, entities: array?
get_chart_data
Read the actual data values behind the chart on this page, as CSV, for the entities and time range currently shown. ALWAYS call this before stating any number, trend, or comparison — do not answer from memory, because…
get_chart_image_url
Get a URL for a static PNG or SVG image of the chart as it is currently configured, for embedding in a reply or sharing. This returns a link only — it does NOT navigate the page. Never navigate the tab to an image…
format: string?
get_chart_metadata
Read this chart's sources, units, and Our World in Data's own curated notes about how the data should and should not be interpreted. Call this before explaining what a chart means or why values differ between…
get_chart_state
Read the current state of the chart on this page: its title, which entities (countries/regions) are selected, the time range shown, and which view is active. Call this before making a relative change such as adding an…
list_chart_entities
List the countries and regions available on this chart. Use the optional query to filter, and always use the exact names returned here when selecting entities.
query: string?
open_article
Open an Our World in Data article. Use an `article:` path from find_article. This navigates the page; call read_page afterwards to read it.
article: string
open_chart
Open an Our World in Data chart, optionally pre-configured with specific countries, a time range and a tab. Pass the `chart:` path from find_chart verbatim — it carries the parameters that pick which view of a…
chart: string, entities: array?, startYear: number?, endYear: number?, tab: string?
open_search
Open Our World in Data's search results page for a topic, so the user can browse everything we have on it. Use this only when the user wants to browse for themselves — if they asked a question, find_chart or…
query: string, resultType: string?
read_page
Read the text of the Our World in Data page currently open — the article body, including its footnotes and references. ALWAYS call this before answering any question about what this page says, what a number on it is…
select_entities
Set which countries or regions the chart shows, replacing the current selection. Use exact names from list_chart_entities. To add to what is already shown without removing anything, use add_entities instead.
entities: array
set_chart_view
Switch which view of the data is shown — a line chart, the world map, the data table, or any other view this chart offers. Use this for 'show it as a line chart' or 'show me the map': many OWID charts open on the map…
view: string
set_time_range
Set the time range the chart displays, e.g. for 'since 1990' or 'between 2000 and 2020'. Omit either bound to leave it unchanged.
startYear: number?, endYear: number?
