Server definition
- Hash
- sha256:66ff2f567a487b6c40526e414c26205a31fb9281996aea3c38741a07673470de
- What it is
- What a remote MCP server returned when asked what it offers: 70 tools
The blob, as servednamed by its sha256
{
"instructions": "Narrate (narrate.works) works on impact management: measuring, interpreting and sharing impact. This server is in alpha: it works, but its tools and answers can still change (every change: https://narrate.works/mcp/public/changes). Maktoob, the reference work behind the glossary, is in alpha too. Both may contain errors and no rights can be derived from them: say so when you rely on either. Every glossary word and published article is also a resource (narrate://glossary/{lang}/{id}, narrate://articles/{lang}/{id}): a card to attach as a source, with how to cite it. narrate://manifesto/{lang} is what Narrate stands for: eight beliefs, each with the glossary words, articles and pages it leads to. Use search_sources and get_source to cite a source by its own title and publisher; search_keywords and list_specials lead to the pages to read with read_page. Asked what Narrate offers? list_shop_catalog gives the shop's products and get_quote_request_form the questions for a quote; ordering and asking for a quote happen on the page they link to. Someone who wants the Fabrik app (iPhone, iPad, Android), which is in a closed alpha? With their consent, request_beta_access hands in their request; Narrate's team invites by mail. Need an example? suggest_examples, list_examples and get_example give Narrate's made-up examples per audience group, societal issue and sector; say they are made up, never present one as a client's work. When is World Water Day, Prinsjesdag or Dutch Design Week in a year to come? list_events gives the event calendar ten years ahead, each date with its source and whether it is fixed or still expected. Looking for who funds, supports or measures impact work? list_parties gives every organization in Narrate's three landscapes with its roles (funder, impact_organization, accelerator); list_indicators the indicator catalogue, list_metrics the metrics (what you measure, with a QUDT quantity kind and unit) it builds on. What funders allow for monitoring and evaluation: list_funder_norms. Someone with a link from Narrate to sign a quote, answer an evaluation or read a shared page? The key in that link opens that one document: get_quote_to_sign and start_quote_signing, get_client_evaluation_form and submit_client_evaluation, open_shared_link and request_shared_link_code. Never guess or reuse a key, a password or a code, and let the person sign, answer or ask themselves. Use search_glossary before you write about impact, and use Narrate's words: rights-holders, duty-bearers and stakeholders (rechthebbenden, plichtdragers, belanghebbenden); the six layers input, activity, output, outtake, outcome, impact. Cite pages by their URL. Dutch copy uses 'je', English is British English. The tagline stays English, in every language: impact in numbers and stories.",
"tools": [
{
"description": "Reads a value with its unit as people type it, in Dutch or English (\"500 kWh/jaar\", \"€ 1.200 per maand\", \"2 ton CO2\"), and converts it with QUDT's units (list_metrics). Give text, or value with from; to (a unit) or metric (a metric id) to convert, neither to only read it. Units convert when they share a dimension vector, and without one a quantity kind too. Money converts into another currency at the ECB rate of date (YYYY-MM-DD, today when left out): rate. price_year brings euros (the input or the result) to the prices of to_price_year (latest when left out) with the CBS consumer price index: price. factor (list_emission_factors) turns energy or fuel into kg CO2-eq: emission. Answer: input, si, result or refused (dimension, quantity_kind, currency), alternatives and the emission factors that fit (factors).",
"inputSchema": {
"properties": {
"date": {
"description": "The day of the ECB rate, YYYY-MM-DD; today's when left out.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"factor": {
"description": "An emission factor id from list_emission_factors, to convert into kg CO2-eq.",
"maxLength": 100,
"type": "string"
},
"from": {
"description": "The unit of value: a symbol, UCUM code, id or name.",
"maxLength": 100,
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"metric": {
"description": "Convert into the unit of this metric (an id from list_metrics).",
"maxLength": 100,
"type": "string"
},
"price_year": {
"description": "The year whose prices an amount of money is in.",
"maximum": 2100,
"minimum": 1996,
"type": "integer"
},
"system": {
"description": "The reader's system of units: metric (default) or imperial, whose units (QUDT's IMPERIAL and USCS: miles, pounds, gallons) then come first among the alternatives.",
"enum": [
"metric",
"imperial"
],
"type": "string"
},
"text": {
"description": "A value with its unit, such as \"500 kWh/jaar\".",
"maxLength": 200,
"type": "string"
},
"to": {
"description": "The unit to convert into.",
"maxLength": 100,
"type": "string"
},
"to_price_year": {
"description": "The year to bring it to; the latest year of the index when left out.",
"maximum": 2100,
"minimum": 1996,
"type": "integer"
},
"value": {
"description": "The value, with from instead of text.",
"type": "number"
}
},
"type": "object"
},
"name": "convert_quantity",
"outputSchema": {
"additionalProperties": {},
"properties": {
"alternatives": {
"items": {
"additionalProperties": {},
"properties": {
"unit": {
"additionalProperties": {},
"properties": {
"currencies": {
"items": {
"type": "string"
},
"type": "array"
},
"dimension_vector": {
"type": "string"
},
"id": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"parts": {
"items": {
"additionalProperties": {},
"properties": {
"power": {
"type": "number"
},
"unit": {
"type": "string"
}
},
"required": [
"unit",
"power"
],
"type": "object"
},
"type": "array"
},
"quantity_kinds": {
"items": {
"type": "string"
},
"type": "array"
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"symbol",
"name",
"dimension_vector",
"quantity_kinds",
"currencies"
],
"type": "object"
},
"value": {
"type": "number"
}
},
"required": [
"value",
"unit"
],
"type": "object"
},
"type": "array"
},
"emission": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"amount": {
"type": "number"
},
"biogenic": {
"type": [
"number",
"null"
]
},
"chain": {
"type": [
"number",
"null"
]
},
"direct": {
"type": [
"number",
"null"
]
},
"id": {
"type": "string"
},
"infrastructure": {
"type": [
"number",
"null"
]
},
"kg_co2e": {
"type": "number"
},
"kind": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"note": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"per_unit": {
"additionalProperties": {},
"properties": {
"currencies": {
"items": {
"type": "string"
},
"type": "array"
},
"dimension_vector": {
"type": "string"
},
"id": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"parts": {
"items": {
"additionalProperties": {},
"properties": {
"power": {
"type": "number"
},
"unit": {
"type": "string"
}
},
"required": [
"unit",
"power"
],
"type": "object"
},
"type": "array"
},
"quantity_kinds": {
"items": {
"type": "string"
},
"type": "array"
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"symbol",
"name",
"dimension_vector",
"quantity_kinds",
"currencies"
],
"type": "object"
},
"quote": {
"type": "string"
},
"source_id": {
"type": "string"
},
"total": {
"type": "number"
},
"url": {
"type": [
"string",
"null"
]
},
"year": {
"type": "number"
}
},
"required": [
"id",
"name",
"kind",
"per_unit",
"total",
"direct",
"chain",
"biogenic",
"infrastructure",
"year",
"source_id",
"quote",
"url",
"note",
"amount",
"kg_co2e"
],
"type": "object"
},
{
"type": "null"
}
]
},
"factors": {
"items": {
"additionalProperties": {},
"properties": {
"biogenic": {
"type": [
"number",
"null"
]
},
"chain": {
"type": [
"number",
"null"
]
},
"direct": {
"type": [
"number",
"null"
]
},
"id": {
"type": "string"
},
"infrastructure": {
"type": [
"number",
"null"
]
},
"kg_co2e": {
"type": "number"
},
"kind": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"note": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"per_unit": {
"additionalProperties": {},
"properties": {
"currencies": {
"items": {
"type": "string"
},
"type": "array"
},
"dimension_vector": {
"type": "string"
},
"id": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"parts": {
"items": {
"additionalProperties": {},
"properties": {
"power": {
"type": "number"
},
"unit": {
"type": "string"
}
},
"required": [
"unit",
"power"
],
"type": "object"
},
"type": "array"
},
"quantity_kinds": {
"items": {
"type": "string"
},
"type": "array"
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"symbol",
"name",
"dimension_vector",
"quantity_kinds",
"currencies"
],
"type": "object"
},
"quote": {
"type": "string"
},
"source_id": {
"type": "string"
},
"total": {
"type": "number"
},
"url": {
"type": [
"string",
"null"
]
},
"year": {
"type": "number"
}
},
"required": [
"id",
"name",
"kind",
"per_unit",
"total",
"direct",
"chain",
"biogenic",
"infrastructure",
"year",
"source_id",
"quote",
"url",
"note",
"kg_co2e"
],
"type": "object"
},
"type": "array"
},
"input": {
"additionalProperties": {},
"properties": {
"unit": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"currencies": {
"items": {
"type": "string"
},
"type": "array"
},
"dimension_vector": {
"type": "string"
},
"id": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"parts": {
"items": {
"additionalProperties": {},
"properties": {
"power": {
"type": "number"
},
"unit": {
"type": "string"
}
},
"required": [
"unit",
"power"
],
"type": "object"
},
"type": "array"
},
"quantity_kinds": {
"items": {
"type": "string"
},
"type": "array"
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"symbol",
"name",
"dimension_vector",
"quantity_kinds",
"currencies"
],
"type": "object"
},
{
"type": "null"
}
]
},
"value": {
"type": "number"
}
},
"required": [
"value",
"unit"
],
"type": "object"
},
"page": {
"type": "string"
},
"price": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"factor": {
"type": "number"
},
"from_year": {
"type": "number"
},
"source_id": {
"type": "string"
},
"to_year": {
"type": "number"
}
},
"required": [
"from_year",
"to_year",
"factor",
"source_id"
],
"type": "object"
},
{
"type": "null"
}
]
},
"rate": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"date": {
"type": "string"
},
"factor": {
"type": "number"
},
"from": {
"type": "string"
},
"source_id": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to",
"factor",
"date",
"source_id"
],
"type": "object"
},
{
"type": "null"
}
]
},
"refused": {
"anyOf": [
{
"enum": [
"dimension",
"quantity_kind",
"currency"
],
"type": "string"
},
{
"type": "null"
}
]
},
"result": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"metric": {
"type": [
"string",
"null"
]
},
"unit": {
"additionalProperties": {},
"properties": {
"currencies": {
"items": {
"type": "string"
},
"type": "array"
},
"dimension_vector": {
"type": "string"
},
"id": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"parts": {
"items": {
"additionalProperties": {},
"properties": {
"power": {
"type": "number"
},
"unit": {
"type": "string"
}
},
"required": [
"unit",
"power"
],
"type": "object"
},
"type": "array"
},
"quantity_kinds": {
"items": {
"type": "string"
},
"type": "array"
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"symbol",
"name",
"dimension_vector",
"quantity_kinds",
"currencies"
],
"type": "object"
},
"value": {
"type": "number"
}
},
"required": [
"value",
"unit",
"metric"
],
"type": "object"
},
{
"type": "null"
}
]
},
"si": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"dimension_vector": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"value",
"dimension_vector"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"input",
"si",
"result",
"refused",
"alternatives",
"page"
],
"type": "object"
}
},
{
"description": "Ask, with the pairing id and the poll token from device_pair_start, whether the person confirmed the code: waiting, ready (once, with the OAuth authorization code to exchange with the device's PKCE verifier and the redirect_uri https://narrate.works/oauth/pair), session (once: a team member gave the screen one session instead of their account; keep the poll token, it is the screen's access for screen_read_session and screen_set_live until the end of the day) or expired. Ask every few seconds, not faster. Never cached.",
"inputSchema": {
"properties": {
"pairing_id": {
"description": "The pairing's id, from device_pair_start.",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"poll_token": {
"description": "The poll token from device_pair_start.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"pairing_id",
"poll_token"
],
"type": "object"
},
"name": "device_pair_poll",
"outputSchema": {
"additionalProperties": {},
"properties": {
"authorization_code": {
"type": "string"
},
"state": {
"enum": [
"waiting",
"ready",
"session",
"expired"
],
"type": "string"
}
},
"required": [
"state"
],
"type": "object"
}
},
{
"description": "Start pairing a television (or another device without a keyboard) with a person's account, as Narrate's Apple TV app does. Send the PKCE S256 challenge of a verifier only the device keeps, and the device's own OAuth client id. The answer is a six-letter code to show, a QR address (https://narrate.works/tv?code=…) and a poll token to keep secret; the person confirms the code on https://narrate.works/tv, signed in, and allows the app. Then poll with device_pair_poll. A code holds for ten minutes.",
"inputSchema": {
"properties": {
"client_id": {
"description": "The device app's OAuth client id.",
"pattern": "^[0-9a-f-]{36}$",
"type": "string"
},
"code_challenge": {
"description": "The PKCE S256 challenge (base64url of the SHA-256 of the verifier).",
"pattern": "^[A-Za-z0-9_-]{43}$",
"type": "string"
},
"device_name": {
"default": "",
"description": "What the person sees on the phone, such as Apple TV in the living room.",
"maxLength": 80,
"type": "string"
}
},
"required": [
"code_challenge",
"client_id"
],
"type": "object"
},
"name": "device_pair_start",
"outputSchema": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"pairing_id": {
"type": "string"
},
"poll_token": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"pairing_id",
"code",
"poll_token",
"expires_at",
"url"
],
"type": "object"
}
},
{
"description": "Per audience group: how many made-up examples it has, how many the group would run itself and over how many societal issues they spread, against the norm of the library. Also the totals per societal issue and scale, and the groups still below the norm.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "example_coverage",
"outputSchema": {
"additionalProperties": {},
"properties": {
"audiences": {
"items": {
"additionalProperties": {},
"properties": {
"audience": {
"type": "string"
},
"ids": {
"items": {
"type": "string"
},
"type": "array"
},
"leading": {
"type": "number"
},
"societalIssues": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"audience",
"total",
"leading",
"societalIssues",
"ids"
],
"type": "object"
},
"type": "array"
},
"belowNorm": {
"items": {
"type": "string"
},
"type": "array"
},
"examples": {
"type": "number"
},
"nace": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"norm": {
"additionalProperties": {},
"properties": {
"leadingPerAudience": {
"type": "number"
},
"perAudience": {
"type": "number"
},
"societalIssuesPerAudience": {
"type": "number"
}
},
"required": [
"perAudience",
"leadingPerAudience",
"societalIssuesPerAudience"
],
"type": "object"
},
"scales": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"societalIssues": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"norm",
"examples",
"audiences",
"belowNorm",
"societalIssues",
"scales"
],
"type": "object"
}
},
{
"description": "Read what a free key for Narrate's API was used for: its name, when it was made and last used, and the calls per day and per tool over the last days (30 by default, at most 90). Only how often, never what a call held. The key itself is the access, so only its holder can read this.",
"inputSchema": {
"properties": {
"days": {
"default": 30,
"description": "How many days back, 1 to 90.",
"maximum": 90,
"minimum": 1,
"type": "integer"
},
"key": {
"description": "The key, nrk_ and 32 characters.",
"pattern": "^nrk_[A-Za-z0-9_-]{32}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"key"
],
"type": "object"
},
"name": "get_api_key_usage",
"outputSchema": {
"additionalProperties": {},
"properties": {
"created_at": {
"type": "string"
},
"days": {
"items": {
"additionalProperties": {},
"properties": {
"calls": {
"type": "number"
},
"day": {
"type": "string"
},
"tool": {
"type": "string"
}
},
"required": [
"day",
"tool",
"calls"
],
"type": "object"
},
"type": "array"
},
"key_prefix": {
"type": "string"
},
"label": {
"type": "string"
},
"last_used_at": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"label",
"key_prefix",
"created_at",
"last_used_at",
"days"
],
"type": "object"
}
},
{
"description": "The CBS key figures (Kerncijfers wijken en buurten) of the Netherlands (NL00), a municipality (GM0363), a district (WK036300) or a neighbourhood (BU0363AA01), per edition from 2023, as Maktoob keeps them (stream cbs-kerncijfers-wijken-buurten in data_observations, checked nightly). A baseline of an area: residents and ages, households, dwellings and WOZ value, owned and rented, gas and electricity, homes without gas or with solar power, labour participation, income, poverty, social assistance, Wmo, businesses, cars, distances to a GP and a supermarket, land area and urbanity. Per edition: year, table_id (StatLine) and values, measure id to figure; a measure without a figure is left out (income and poverty come a year or two later). measures gives each id with its label and unit (keur is × € 1,000). Codes follow the edition's own classification, as in nl-municipalities, nl-districts and nl-neighbourhoods. source_id is cbs-kerncijfers-wijken-buurten.",
"inputSchema": {
"properties": {
"code": {
"description": "The area's CBS code: NL00, GM0363, WK036300 or BU0363AA01.",
"pattern": "^(NL00|GM\\d{4}|WK\\d{4}[0-9A-Z]{2}|BU\\d{4}[0-9A-Z]{4})$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"year": {
"description": "One edition only, such as 2025. Without it, every stored edition.",
"maximum": 2200,
"minimum": 2000,
"type": "integer"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "get_area_statistics",
"outputSchema": {
"additionalProperties": {},
"properties": {
"area_code": {
"type": "string"
},
"area_kind": {
"type": "string"
},
"measures": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"unit": {
"type": "string"
}
},
"required": [
"id",
"unit",
"label"
],
"type": "object"
},
"type": "array"
},
"source_id": {
"type": "string"
},
"years": {
"items": {
"additionalProperties": {},
"properties": {
"table_id": {
"type": "string"
},
"values": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"year": {
"type": "number"
}
},
"required": [
"year",
"table_id",
"values"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"area_code",
"area_kind",
"source_id",
"years",
"measures"
],
"type": "object"
}
},
{
"description": "The societal issues and sectors where Narrate did work for one audience group, taken only from the cases and clients its own page shows. A group without such proof gets an empty list. Name the group by its key ('municipalities') or the slug of its page ('gemeenten').",
"inputSchema": {
"properties": {
"audience": {
"description": "The group: its key or the last part of its address, e.g. 'gemeenten' or 'municipalities'.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"audience"
],
"type": "object"
},
"name": "get_audience_fields",
"outputSchema": {
"additionalProperties": {},
"properties": {
"audience": {
"type": "string"
},
"fields": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"kind",
"name",
"url"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
},
"proof": {
"additionalProperties": {},
"properties": {
"cases": {
"items": {
"type": "string"
},
"type": "array"
},
"klanten": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"cases",
"klanten"
],
"type": "object"
}
},
"required": [
"audience",
"page",
"proof",
"fields"
],
"type": "object"
}
},
{
"description": "The evaluation form a client of Narrate got by mail (narrate.works/klantevaluatie#<key>), opened with the key from that link: which moment (midway or final), the track and organisation, when it opens and closes, its status (planned, open or closed) and the answer given earlier, if any. No account: the key is the access and opens this one answer only. found is false for a key that opens nothing. Counted per key and per visitor.",
"inputSchema": {
"properties": {
"key": {
"description": "The key from the link (the part after #, 43 characters). It opens this one document only.",
"pattern": "^[A-Za-z0-9_-]{43}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"key"
],
"type": "object"
},
"name": "get_client_evaluation_form",
"outputSchema": {
"additionalProperties": {},
"properties": {
"form": {
"additionalProperties": {},
"properties": {
"closes_on": {
"type": "string"
},
"earlier": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"consent": {
"type": "string"
},
"job_title": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"quote": {
"type": [
"string",
"null"
]
},
"ratings": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"texts": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"ratings",
"texts",
"quote",
"consent",
"name",
"job_title"
],
"type": "object"
},
{
"type": "null"
}
]
},
"moment": {
"enum": [
"midway",
"final"
],
"type": "string"
},
"opens_on": {
"type": "string"
},
"organization": {
"type": "string"
},
"status": {
"enum": [
"planned",
"open",
"closed"
],
"type": "string"
},
"track": {
"type": "string"
}
},
"required": [
"moment",
"track",
"organization",
"opens_on",
"closes_on",
"status",
"earlier"
],
"type": "object"
},
"found": {
"type": "boolean"
}
},
"required": [
"found"
],
"type": "object"
}
},
{
"description": "The reference lists Narrate keeps (narrate.works/naslag/lijsten), with each code's name in Dutch or British English. Classifications: sdg, iris (IRIS+ categories), nace (NACE Rev. 2.1 sections; the answer's sectors names our sectors in each), elf (Dutch legal forms, ISO 20275), enterprise-size (EU Recommendation 2003/361), ownership, recognition (ANBI, B Corp and other statuses a third party grants an enterprise), entrepreneurial-practice, founder-profile, enterprise-stage, reporting-obligation (CSRD), mission-lock, customer-market (ESA 2010 sectors), revenue-model, funding (SAFE); sources gives a code's own source, eu-taxonomy, six-capitals and five-dimensions; list_indicators names an indicator's place in them. Geographies by id, such as nl-municipalities (list_geographies). Code lists: countries (ISO 3166-1 alpha-2), regions (UN M49), languages (ISO 639-1), currencies (ISO 4217) and time_zones (IANA). Without list it names every list with its number of codes.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"list": {
"description": "Which list, such as countries, currencies, sdg, nace or six-capitals. Empty names every list.",
"maxLength": 60,
"type": "string"
},
"query": {
"default": "",
"description": "Part of a code or name to filter on, e.g. 'NL' or 'Europe'. Empty gives the whole list.",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
},
"name": "get_code_list",
"outputSchema": {
"additionalProperties": {},
"properties": {
"items": {
"items": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"code",
"name"
],
"type": "object"
},
"type": "array"
},
"list": {
"type": "string"
},
"lists": {
"items": {
"additionalProperties": {},
"properties": {
"codes": {
"type": "number"
},
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name",
"kind",
"codes"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
},
"sectors": {
"items": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"divisions": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"code",
"id",
"name",
"divisions"
],
"type": "object"
},
"type": "array"
},
"sources": {
"items": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"code",
"source"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"list",
"items"
],
"type": "object"
}
},
{
"description": "Maktoob, Narrate's open reference work, described as datasets along DCAT-AP 3.0 and DCAT-AP-NL, with Dublin Core: the whole set and its parts (terms, links, frameworks, actors, evidence, metrics, QUDT's units), each with its files, licence (CC BY 4.0), version, release date and pages, and the API and MCP server that serve them. doi is the DOI of the current version once Zenodo has given one, concept_doi the one that always points at the newest. files gives the catalogue itself as Turtle, JSON-LD and RDF/XML, for a data portal to harvest.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_dataset_catalog",
"outputSchema": {
"additionalProperties": {},
"properties": {
"concept_doi": {
"type": [
"string",
"null"
]
},
"datasets": {
"items": {
"additionalProperties": {},
"properties": {
"files": {
"items": {
"additionalProperties": {},
"properties": {
"format": {
"type": "string"
},
"media_type": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"url",
"format",
"media_type"
],
"type": "object"
},
"type": "array"
},
"id": {
"type": "string"
},
"iri": {
"type": "string"
},
"title": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
}
},
"required": [
"id",
"iri",
"title",
"files"
],
"type": "object"
},
"type": "array"
},
"doi": {
"type": [
"string",
"null"
]
},
"files": {
"additionalProperties": {},
"properties": {
"jsonld": {
"type": "string"
},
"rdfxml": {
"type": "string"
},
"turtle": {
"type": "string"
}
},
"required": [
"turtle",
"jsonld",
"rdfxml"
],
"type": "object"
},
"iri": {
"type": "string"
},
"issued": {
"type": [
"string",
"null"
]
},
"license": {
"type": "string"
},
"services": {
"items": {
"additionalProperties": {},
"properties": {
"endpoint": {
"type": "string"
},
"id": {
"type": "string"
},
"iri": {
"type": "string"
}
},
"required": [
"id",
"iri",
"endpoint"
],
"type": "object"
},
"type": "array"
},
"version": {
"type": "string"
}
},
"required": [
"iri",
"version",
"issued",
"license",
"doi",
"concept_doi",
"files",
"datasets",
"services"
],
"type": "object"
}
},
{
"description": "One made-up example by its id (from suggest_examples or list_examples): its card, the audience groups it serves and its tags.",
"inputSchema": {
"properties": {
"id": {
"description": "The example's id, such as repaircafe.",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_example",
"outputSchema": {
"additionalProperties": {},
"properties": {
"examples": {
"items": {
"additionalProperties": {},
"properties": {
"audiences": {
"items": {
"type": "string"
},
"type": "array"
},
"change": {
"type": "string"
},
"facts": {
"items": {
"additionalProperties": {},
"properties": {
"source": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"text",
"source"
],
"type": "object"
},
"type": "array"
},
"figure": {
"type": "string"
},
"id": {
"type": "string"
},
"madeUp": {
"const": true,
"type": "boolean"
},
"organisation": {
"type": "string"
},
"rightsHolder": {
"type": "string"
},
"situation": {
"type": "string"
},
"tension": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"title",
"organisation",
"situation",
"change",
"rightsHolder",
"figure",
"tension",
"audiences",
"madeUp"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"examples"
],
"type": "object"
}
},
{
"description": "One area of a geography of list_geographies (narrate.works/naslag/geografieen/<geography>/<code>), such as GM0363 of nl-municipalities, with every area of the other geographies it overlaps: the province, RES, GGD and other regions, water board and NUTS area a municipality lies in, and the areas a region holds. share is the part of this area in the other, other_share the reverse, 0 to 1; relation is within (share 0.75 or more), contains (the other lies in this one) or overlaps. Measured on the simplified map borders, so a municipality lies in its province for about 0.98. Districts, postcodes and business parks are measured against municipalities and provinces only. outline true adds the area's polygon as GeoJSON (WGS 84, as its source publishes it). Every polygon of a geography: list_geography_outlines. Find a code with get_code_list.",
"inputSchema": {
"properties": {
"code": {
"description": "The area's code in that geography, such as GM0363 or ES16.",
"maxLength": 60,
"type": "string"
},
"geography": {
"description": "The geography's id, such as nl-municipalities or nl-res-regions (list_geographies).",
"maxLength": 60,
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"outline": {
"default": false,
"description": "Also give the area's polygon as GeoJSON (WGS 84), as its source publishes it.",
"type": "boolean"
}
},
"required": [
"geography",
"code"
],
"type": "object"
},
"name": "get_geography_area",
"outputSchema": {
"additionalProperties": {},
"properties": {
"area": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"division": {
"additionalProperties": {},
"properties": {
"description": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"map": {
"type": "boolean"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"source": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"name",
"description",
"source",
"year",
"map"
],
"type": "object"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"outline": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
{
"type": "null"
}
]
},
"overlaps": {
"items": {
"additionalProperties": {},
"properties": {
"areas": {
"items": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"other_share": {
"type": "number"
},
"page": {
"type": "string"
},
"relation": {
"enum": [
"within",
"contains",
"overlaps"
],
"type": "string"
},
"share": {
"type": "number"
}
},
"required": [
"code",
"name",
"share",
"other_share",
"relation",
"page"
],
"type": "object"
},
"type": "array"
},
"division": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
}
},
"required": [
"id",
"name"
],
"type": "object"
}
},
"required": [
"division",
"areas"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"division",
"code",
"name",
"overlaps"
],
"type": "object"
},
"page": {
"type": "string"
}
},
"required": [
"area",
"page"
],
"type": "object"
}
},
{
"description": "Everything about one word of the Narrate glossary by its id (from search_glossary): the term in both languages, its definition per language level, the words to avoid, an example, the words not to confuse it with, and its source. On the public server, reviewed_by lists who checked the word in Narrate's review queue with a verdict that held, most recent first, only those who chose to show a name or pseudonym.",
"inputSchema": {
"properties": {
"id": {
"description": "The stable id, e.g. 'rechthebbenden'.",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_glossary_term",
"outputSchema": {
"additionalProperties": {},
"properties": {
"reviewed_by": {
"items": {
"additionalProperties": {},
"properties": {
"name": {
"type": "string"
},
"reviewed_on": {
"type": "string"
}
},
"required": [
"name",
"reviewed_on"
],
"type": "object"
},
"type": "array"
},
"term": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"term"
],
"type": "object"
}
},
{
"description": "The links of one glossary word or one source in Narrate's reference work (Maktoob), both ways, each with its open-standard name: broader and narrower (skos:broader, iso-thes:broaderPartitive), related (skos:related), not to be confused, the defining source (dcterms:source), the sources read for a word (cito:citesAsAuthority), and between sources: cites, extends, critiques, discusses (CiTO), the same work (owl:sameAs) and replaced by (dcterms:isReplacedBy). A link between sources says why it holds and where it shows. Ids come from search_glossary or search_sources.",
"inputSchema": {
"properties": {
"id": {
"description": "The stable id, e.g. 'verandertheorie' or 'mayne-2001'.",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"kind": {
"description": "term for a glossary word, source for a source.",
"enum": [
"term",
"source"
],
"type": "string"
}
},
"required": [
"kind",
"id"
],
"type": "object"
},
"name": "get_links",
"outputSchema": {
"additionalProperties": {},
"properties": {
"incoming": {
"items": {
"additionalProperties": {},
"properties": {
"relation": {
"type": "string"
},
"standard": {
"type": "string"
}
},
"required": [
"relation",
"standard"
],
"type": "object"
},
"type": "array"
},
"item": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
}
},
"required": [
"kind",
"id"
],
"type": "object"
},
"outgoing": {
"items": {
"additionalProperties": {},
"properties": {
"relation": {
"type": "string"
},
"standard": {
"type": "string"
}
},
"required": [
"relation",
"standard"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"item",
"outgoing",
"incoming"
],
"type": "object"
}
},
{
"description": "How large Maktoob, Narrate's reference work, is now: the number of public rows per part, counted live. concepts, concept_links and concept_mappings (to other frameworks); sources; frameworks; actors; indicators; metrics and metric_parts; QUDT's layers (dimension_vectors, quantity_kinds, units, physical_constants, unit_prefixes, systems_of_units); societal_issues; classifications and their codes (without the geographies); geographies and geography_areas, the divisions of the Netherlands into areas, counted apart and never in the total; tools; technologies; and the Dojo (schools_of_thought, frictions, causes, assumptions, patterns, currents). growth gives per day since November 2026 how many rows each part had (days, and one number per day per part); concepts and sources keep no date: kept gives them from the stand the database keeps each night, from its first day (from). Shown on /in/getallen/over/naslag.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_maktoob_size",
"outputSchema": {
"additionalProperties": {},
"properties": {
"actors": {
"type": "number"
},
"assumptions": {
"type": "number"
},
"causes": {
"type": "number"
},
"classification_codes": {
"type": "number"
},
"classifications": {
"type": "number"
},
"concept_links": {
"type": "number"
},
"concept_mappings": {
"type": "number"
},
"concepts": {
"type": "number"
},
"currents": {
"type": "number"
},
"dimension_vectors": {
"type": "number"
},
"frameworks": {
"type": "number"
},
"frictions": {
"type": "number"
},
"geographies": {
"type": "number"
},
"geography_areas": {
"type": "number"
},
"growth": {
"additionalProperties": {},
"properties": {
"days": {
"items": {
"type": "string"
},
"type": "array"
},
"kept": {
"additionalProperties": {},
"properties": {
"from": {
"type": "string"
},
"parts": {
"additionalProperties": {
"items": {
"type": "number"
},
"type": "array"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"from",
"parts"
],
"type": "object"
},
"parts": {
"additionalProperties": {
"items": {
"type": "number"
},
"type": "array"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"days",
"parts"
],
"type": "object"
},
"indicators": {
"type": "number"
},
"metric_parts": {
"type": "number"
},
"metrics": {
"type": "number"
},
"page": {
"type": "string"
},
"patterns": {
"type": "number"
},
"physical_constants": {
"type": "number"
},
"quantity_kinds": {
"type": "number"
},
"schools_of_thought": {
"type": "number"
},
"societal_issues": {
"type": "number"
},
"sources": {
"type": "number"
},
"systems_of_units": {
"type": "number"
},
"technologies": {
"type": "number"
},
"tools": {
"type": "number"
},
"unit_prefixes": {
"type": "number"
},
"units": {
"type": "number"
}
},
"required": [
"concepts",
"concept_links",
"concept_mappings",
"sources",
"frameworks",
"actors",
"indicators",
"metrics",
"metric_parts",
"dimension_vectors",
"quantity_kinds",
"units",
"physical_constants",
"unit_prefixes",
"systems_of_units",
"societal_issues",
"classifications",
"classification_codes",
"tools",
"technologies",
"schools_of_thought",
"frictions",
"causes",
"assumptions",
"patterns",
"currents",
"growth",
"page"
],
"type": "object"
}
},
{
"description": "One of Narrate's partners as its landing page on the site shows it: name, logo, colour, tagline, description, a quote, and the partner's public programmes (accelerator, network or consultancy) with their sector, driver and promotion code. Give the partner's slug, and a programme's slug to have that programme too when it is not public. Narrate's own landing pages read this too.",
"inputSchema": {
"properties": {
"program": {
"description": "A programme's slug, to have that programme in the answer even when it is not listed.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"slug": {
"description": "The partner's slug, as in its address on the site.",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_partner",
"outputSchema": {
"additionalProperties": {},
"properties": {
"partner": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"description": {
"type": "string"
},
"logo": {
"type": "string"
},
"name": {
"type": "string"
},
"primary_color": {
"type": "string"
},
"programs": {
"items": {
"additionalProperties": {},
"properties": {
"driver": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"promo_code": {
"type": [
"string",
"null"
]
},
"slug": {
"type": "string"
},
"type": {
"type": "string"
},
"vertical": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"name",
"type",
"vertical",
"driver",
"promo_code"
],
"type": "object"
},
"type": "array"
},
"slug": {
"type": "string"
},
"tagline": {
"type": "string"
},
"testimonial": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"author": {
"type": "string"
},
"quote": {
"type": "string"
},
"role": {
"type": "string"
}
},
"required": [
"quote",
"author",
"role"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"name",
"logo",
"primary_color",
"tagline",
"description",
"programs",
"testimonial"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"partner"
],
"type": "object"
}
},
{
"description": "One product of Narrate's shop that ends in a quote, with the questions the request form asks (each with its options, or the range for a number) and the page where the person fills it in. Take the product id from list_shop_catalog. The request itself is sent on that page, by the person: this tool only reads.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"product_id": {
"description": "The product's id, from list_shop_catalog.",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "get_quote_request_form",
"outputSchema": {
"additionalProperties": {},
"properties": {
"intro": {
"type": [
"string",
"null"
]
},
"page": {
"type": "string"
},
"product": {
"additionalProperties": {},
"properties": {
"billing_frequency": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"image_url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"outcome": {
"enum": [
"quote",
"cart"
],
"type": "string"
},
"price": {
"type": [
"number",
"null"
]
},
"questionnaire": {
"description": "The key of the questions a quote request asks; get_quote_request_form gives them.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"description",
"price",
"billing_frequency",
"image_url",
"outcome"
],
"type": "object"
},
"questions": {
"items": {
"additionalProperties": {},
"properties": {
"hint": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"kind": {
"enum": [
"one",
"several",
"number"
],
"type": "string"
},
"max": {
"type": [
"number",
"null"
]
},
"min": {
"type": [
"number",
"null"
]
},
"options": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"id",
"text"
],
"type": "object"
},
"type": "array"
},
"question": {
"type": "string"
}
},
"required": [
"id",
"kind",
"question",
"hint",
"options",
"min",
"max"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"product",
"intro",
"questions",
"page"
],
"type": "object"
}
},
{
"description": "The quote Narrate sent to sign, opened with the key from the signing link (narrate.works/offerte-tekenen#<key>, English /sign-quote): number, title, the lines and terms, the proposal, who is expected to sign, and its status (open, signed or expired). No account: the key is the access and opens this one quote only. found is false for a key that opens nothing (unknown, recalled or not sent yet). Counted per key and per visitor.",
"inputSchema": {
"properties": {
"key": {
"description": "The key from the link (the part after #, 43 characters). It opens this one document only.",
"pattern": "^[A-Za-z0-9_-]{43}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"key"
],
"type": "object"
},
"name": "get_quote_to_sign",
"outputSchema": {
"additionalProperties": {},
"properties": {
"found": {
"type": "boolean"
},
"quote": {
"additionalProperties": {},
"properties": {
"company": {
"type": [
"string",
"null"
]
},
"currency": {
"const": "EUR",
"type": "string"
},
"discount_percentage": {
"type": "number"
},
"introduction": {
"type": [
"string",
"null"
]
},
"lines": {
"items": {
"additionalProperties": {},
"properties": {
"billing_frequency": {
"type": [
"string",
"null"
]
},
"cost_center": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"discount_percentage": {
"type": "number"
},
"name": {
"type": "string"
},
"price": {
"type": "number"
},
"quantity": {
"type": "number"
}
},
"required": [
"name",
"description",
"quantity",
"price",
"billing_frequency",
"discount_percentage",
"cost_center"
],
"type": "object"
},
"type": "array"
},
"number": {
"type": "string"
},
"offer": {
"type": [
"string",
"null"
]
},
"payment_term_days": {
"type": "number"
},
"proposal": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"proposal_extras": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"purchase_order_number": {
"type": [
"string",
"null"
]
},
"reference": {
"type": [
"string",
"null"
]
},
"sent_at": {
"type": [
"string",
"null"
]
},
"signed": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"at": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"name",
"at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"signer": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"job_title": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"job_title",
"email"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"open",
"signed",
"expired"
],
"type": "string"
},
"terms": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"total_excl_vat": {
"type": "number"
},
"valid_until": {
"type": "string"
},
"vat_percentage": {
"type": "number"
}
},
"required": [
"number",
"title",
"introduction",
"offer",
"terms",
"vat_percentage",
"payment_term_days",
"discount_percentage",
"reference",
"purchase_order_number",
"signer",
"valid_until",
"sent_at",
"total_excl_vat",
"currency",
"company",
"lines",
"status",
"signed",
"proposal",
"proposal_extras"
],
"type": "object"
}
},
"required": [
"found"
],
"type": "object"
}
},
{
"description": "The settings the Narrate team turned away from their default on glossary words (concept), sources (source) and articles (article): whether an assistant may read it (ai_readable), whether it is findable in search (searchable) and whether readers can respond (reader_comments). Only what differs from the default; everything else is on. Narrate's own site search uses this too.",
"inputSchema": {
"properties": {
"kind": {
"description": "Only this kind. Leave it out for all three.",
"enum": [
"concept",
"source",
"article"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_reference_settings",
"outputSchema": {
"additionalProperties": {},
"properties": {
"settings": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"setting": {
"type": "string"
},
"value": {
"type": [
"boolean",
"string",
"number"
]
}
},
"required": [
"kind",
"id",
"setting",
"value"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"settings"
],
"type": "object"
}
},
{
"description": "Everything public about one source by its id (from search_sources): title, publisher, date, URL, licence, the literal quote Narrate leans on and where it stands, whether it was checked three times, and whether something overtook it.",
"inputSchema": {
"properties": {
"id": {
"description": "The stable id, e.g. 'csrd'.",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_source",
"outputSchema": {
"additionalProperties": {},
"properties": {
"source": {
"additionalProperties": {},
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"publisher": {
"type": "string"
},
"register": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title",
"publisher",
"date",
"url",
"register"
],
"type": "object"
}
},
"required": [
"source"
],
"type": "object"
}
},
{
"description": "How Narrate's services stand right now (the website; Fabrik's signing in, data, workspace, presenter and phone, Sada, email, payments, signing documents, calendar, video and phone notifications; the API and MCP servers: working, slow or disrupted), the notice that is open, and planned maintenance within a day. The same answer as narrate.works/api/status and the status page. When Supabase itself is down this tool may not answer either; narrate.works/api/status then still does.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "get_status",
"outputSchema": {
"additionalProperties": {},
"properties": {
"not_in_use": {
"items": {
"type": "string"
},
"type": "array"
},
"notice": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"page": {
"type": "string"
},
"services": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"ms": {
"type": "number"
},
"state": {
"enum": [
"working",
"slow",
"disrupted"
],
"type": "string"
}
},
"required": [
"id",
"state"
],
"type": "object"
},
"type": "array"
},
"time": {
"type": "string"
},
"upcoming": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"updated_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"time",
"services",
"updated_at",
"page"
],
"type": "object"
}
},
{
"description": "Keep a person's answers so far to a vraaggesprek, so they get a reminder by mail to finish it, by the code in its link. Only for the person themselves, when they ask for the reminder and give their own mail address: it is what the page behind the link does. Without key: starts an unfinished response with the address and answers its key (keep it; it opens the answers again). With key: saves the answers so far; remind false stops the reminders and wipes the address. At most two reminders go out, two and five days apart; the address is wiped once the response is handed in (submit_interview_response with the key), the link closes, or 14 days after the last reminder. A shared device (tablet, paper) keeps nothing.",
"inputSchema": {
"properties": {
"answers": {
"additionalProperties": {
"anyOf": [
{
"maxLength": 4000,
"type": "string"
},
{
"type": "number"
},
{
"items": {
"maxLength": 200,
"type": "string"
},
"maxItems": 30,
"type": "array"
},
{
"type": "null"
}
]
},
"description": "The answers so far, by question id.",
"propertyNames": {
"maxLength": 60,
"type": "string"
},
"type": "object"
},
"code": {
"description": "The code in the link, the part after /v/ (narrate.works/v/<code>).",
"pattern": "^[a-z0-9-]{4,40}$",
"type": "string"
},
"consent": {
"default": false,
"description": "Whether the person agreed to what the vraaggesprek says it does with the answers.",
"type": "boolean"
},
"email": {
"description": "The person's own mail address, for the reminder. Needed without key.",
"format": "email",
"maxLength": 254,
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"key": {
"description": "The key of a kept response: what keep_interview_response answered, or the verder part of the reminder's link.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"lang": {
"description": "The language of the reminder: nl or en.",
"enum": [
"nl",
"en"
],
"type": "string"
},
"remind": {
"default": true,
"description": "false stops the reminders and wipes the address.",
"type": "boolean"
}
},
"required": [
"code",
"answers"
],
"type": "object"
},
"name": "keep_interview_response",
"outputSchema": {
"additionalProperties": {},
"properties": {
"kept": {
"const": true,
"type": "boolean"
},
"key": {
"type": "string"
},
"number": {
"type": "number"
},
"remind": {
"type": "boolean"
}
},
"required": [
"kept",
"number",
"key",
"remind"
],
"type": "object"
}
},
{
"description": "The day each reference item was added, for the items that are also in Fabrik's documentation repo (fabrik-documentation-roadmap): begrippen, frameworks, problems (frictions), schools of thought, patterns, causes and assumptions. Per item: table, id, added_on (YYYY-MM-DD) and added_from, which says where the date came from: the file, the first commit, and whether it is the date written next to the item, the document's date or the commit's. Items not in that repo are left out; their day is when their row was made. Filter with table.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"table": {
"enum": [
"concepts",
"frictions",
"schools_of_thought",
"patterns",
"causes",
"assumptions",
"frameworks"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_added_dates",
"outputSchema": {
"additionalProperties": {},
"properties": {
"count": {
"type": "number"
},
"items": {
"items": {
"additionalProperties": {},
"properties": {
"added_from": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"added_on": {
"type": "string"
},
"id": {
"type": "string"
},
"table": {
"type": "string"
}
},
"required": [
"table",
"id",
"added_on",
"added_from"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"items",
"count"
],
"type": "object"
}
},
{
"description": "Narrate's published articles, newest first, as on narrate.works/materialen/artikelen (English /resources/articles). Choose a form to get one category: opinion gives the opinion pieces (/materialen/artikelen/opinie), guide the guides, longread the long reads, story the stories from practice, note the notes, ourWork the pieces on how we work. Returns each with its title, description, form, date, URL and the address of its card (narrate://articles/…); read one in full with read_page or that card.",
"inputSchema": {
"properties": {
"form": {
"description": "Only the articles of this form (category). Leave it out for every article.",
"enum": [
"guide",
"opinion",
"story",
"longread",
"note",
"ourWork"
],
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"limit": {
"default": 50,
"description": "How many articles, newest first.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"query": {
"default": "",
"description": "Words to look for in the title or description. Empty lists them all.",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "list_articles",
"outputSchema": {
"additionalProperties": {},
"properties": {
"articles": {
"items": {
"additionalProperties": {},
"properties": {
"date": {
"type": "string"
},
"form": {
"type": "string"
},
"formName": {
"type": "string"
},
"resource": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"title",
"form",
"formName",
"date",
"url",
"resource"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
}
},
"required": [
"articles",
"page"
],
"type": "object"
}
},
{
"description": "Where every ball of the ball graph on the public chart pages lies in the network view, worked out ahead of time: a map of ball id to [x, y] in whole units. Only positions, no content. Narrate's own ball graph reads this too.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_ball_graph_positions",
"outputSchema": {
"additionalProperties": {},
"properties": {
"positions": {
"additionalProperties": {
"items": {
"type": "number"
},
"type": "array"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"positions"
],
"type": "object"
}
},
{
"description": "The paper books on Narrate's own shelf, as the library pages show them: every book (title, authors in order, language, year, publisher, ISBN, cover), the shelves they stand on in order, and the authors with their Wikidata id. Each book names its source in the source register (source_id; read it with get_source).",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_books",
"outputSchema": {
"additionalProperties": {},
"properties": {
"authors": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
"type": "array"
},
"authorships": {
"items": {
"additionalProperties": {},
"properties": {
"author_id": {
"type": "string"
},
"book_id": {
"type": "string"
}
},
"required": [
"book_id",
"author_id"
],
"type": "object"
},
"type": "array"
},
"books": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"title"
],
"type": "object"
},
"type": "array"
},
"shelves": {
"items": {
"additionalProperties": {},
"properties": {
"key": {
"type": "string"
}
},
"required": [
"key"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"books",
"shelves",
"authors",
"authorships"
],
"type": "object"
}
},
{
"description": "The currents (traditions) that come together in impact management, in lane order: development co-operation, evaluation, evidence, finance, reporting and more. Per current its name and one line in Dutch and English, the ids of the sources it rests on (get_source), the frameworks that come from it (`origins`, their first current) and the ones from elsewhere that also touch it (`touches`), oldest first, each as the id, name and year of a record in list_framework_origins. The Dojo's page of currents shows the same.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_currents",
"outputSchema": {
"additionalProperties": {},
"properties": {
"currents": {
"items": {
"additionalProperties": {},
"properties": {
"explanation": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"id": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"origins": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"year": {
"type": "number"
}
},
"required": [
"id",
"name",
"year"
],
"type": "object"
},
"type": "array"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
},
"touches": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"year": {
"type": "number"
}
},
"required": [
"id",
"name",
"year"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"name",
"explanation",
"sources",
"origins",
"touches"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
}
},
"required": [
"currents",
"page"
],
"type": "object"
}
},
{
"description": "Emission factors of Maktoob: how many kg CO2-equivalent one unit of an energy carrier causes, from the Dutch standard list (co2emissiefactoren.nl, 2026). Per factor: id, name, kind (elektriciteit, brandstof-energie, brandstof-voertuig, warmte), the unit it is per (a row of public.units), total (well-to-wheel) and its parts direct and chain, biogenic or infrastructure where the list gives them, year, source_id in the source register, the literal row of the list as quote, and its url. Filter with kind. Use one in convert_quantity with factor.",
"inputSchema": {
"properties": {
"kind": {
"enum": [
"elektriciteit",
"brandstof-energie",
"brandstof-voertuig",
"warmte",
"overig"
],
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_emission_factors",
"outputSchema": {
"additionalProperties": {},
"properties": {
"factors": {
"items": {
"additionalProperties": {},
"properties": {
"biogenic": {
"type": [
"number",
"null"
]
},
"chain": {
"type": [
"number",
"null"
]
},
"direct": {
"type": [
"number",
"null"
]
},
"id": {
"type": "string"
},
"infrastructure": {
"type": [
"number",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"note": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"per_unit": {
"additionalProperties": {},
"properties": {
"currencies": {
"items": {
"type": "string"
},
"type": "array"
},
"dimension_vector": {
"type": "string"
},
"id": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"parts": {
"items": {
"additionalProperties": {},
"properties": {
"power": {
"type": "number"
},
"unit": {
"type": "string"
}
},
"required": [
"unit",
"power"
],
"type": "object"
},
"type": "array"
},
"quantity_kinds": {
"items": {
"type": "string"
},
"type": "array"
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"symbol",
"name",
"dimension_vector",
"quantity_kinds",
"currencies"
],
"type": "object"
},
"quote": {
"type": "string"
},
"source_id": {
"type": "string"
},
"total": {
"type": "number"
},
"url": {
"type": [
"string",
"null"
]
},
"year": {
"type": "number"
}
},
"required": [
"id",
"name",
"kind",
"per_unit",
"total",
"direct",
"chain",
"biogenic",
"infrastructure",
"year",
"source_id",
"quote",
"url",
"note"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
}
},
"required": [
"factors",
"page"
],
"type": "object"
}
},
{
"description": "Narrate's event calendar (narrate.works/materialen/evenementenkalender): international days of the UN, days and weeks in the field of impact work, moments in nature and in politics, up to ten years ahead. Each event has its dates, a sentence in Dutch and English, its source in the public source register (sourceId, read it with get_source), the day it was checked, and how sure the date is (basis): source when a person read it in the source, rule when the source itself fixes the day (a law, a UN resolution), projected when the rhythm is carried forward until the organisers announce it (then uncertain is true). Filter by kind, by days (from and to, ISO) and by basis. The regulatory calendar's dates are not here.",
"inputSchema": {
"properties": {
"basis": {
"default": [],
"description": "source, rule or projected; empty for all.",
"items": {
"enum": [
"source",
"rule",
"projected"
],
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"cadence": {
"description": "Only the events of this rhythm (an id such as wereldwaterdag).",
"maxLength": 80,
"type": "string"
},
"from": {
"description": "Only events that run on or after this day (ISO). Default: today.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"kinds": {
"default": [],
"description": "nature, field, world_day or politics; empty for all four.",
"items": {
"enum": [
"nature",
"field",
"world_day",
"politics"
],
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"to": {
"description": "Only events that begin on or before this day (ISO).",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"type": "object"
},
"name": "list_events",
"outputSchema": {
"additionalProperties": {},
"properties": {
"events": {
"items": {
"additionalProperties": {},
"properties": {
"basis": {
"description": "source: read in the source by a person; rule: the source fixes the day (a law, a UN resolution); projected: the rhythm carried forward until the organisers announce the date.",
"type": "string"
},
"cadence": {
"description": "The rhythm of Narrate's content calendar this is one time of.",
"type": [
"string",
"null"
]
},
"checkedOn": {
"description": "The day the date was last read in its source, or carried forward from its rule.",
"type": "string"
},
"date": {
"description": "The first day: YYYY-MM-DD, or YYYY-MM or YYYY when only that is known.",
"type": "string"
},
"endDate": {
"description": "The last day of an event that lasts longer than a day.",
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"kind": {
"description": "nature, field, world_day or politics.",
"type": "string"
},
"quoteId": {
"type": [
"string",
"null"
]
},
"sourceId": {
"description": "The source in Narrate's public source register (get_source).",
"type": "string"
},
"text": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"uncertain": {
"type": "boolean"
}
},
"required": [
"id",
"kind",
"cadence",
"date",
"endDate",
"text",
"sourceId",
"quoteId",
"checkedOn",
"uncertain",
"basis"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
}
},
"required": [
"events",
"page"
],
"type": "object"
}
},
{
"description": "Every made-up example in Narrate's library that matches all given filters, in library order, each as a short card: situation, the change they want, the rights-holders, one figure and what is hard about it. No filter lists them all.",
"inputSchema": {
"properties": {
"audience": {
"description": "Only examples this audience group recognises.",
"enum": [
"socialEnterprises",
"nonprofitLeaders",
"communityOrganisations",
"associations",
"corporateSustainability",
"smeSuppliers",
"smeVoluntaryReporting",
"familyBusinesses",
"founders",
"scaleUps",
"industryChangemakers",
"bCorps",
"regularBusinesses",
"moneyFirstBusinesses",
"investors",
"familyOffices",
"philanthropy",
"foundations",
"governments",
"municipalities",
"provincesRegionalAgencies",
"publicSectorBodies",
"governmentProgrammes",
"publicPrivatePartnerships",
"euFundedProjects",
"industryAssociations",
"thinkTanksPolicyResearchers",
"networksEcosystemBuilders",
"impactConsultancies",
"impactDataSoftware",
"standardSetters",
"universitiesResearch",
"capacityBuildersTrainers",
"incubatorsAccelerators",
"otherProfessionalServices",
"prAgencies",
"marketingAgencies",
"accountancies",
"lawFirms",
"lobbyOrganisations",
"sportsClubs",
"culturalSocieties",
"heritageSocieties",
"otherOrganisations"
],
"type": "string"
},
"challenge": {
"description": "Old name of societal_issue; still read.",
"enum": [
"energietransitie",
"voedseltransitie",
"klimaat",
"circulaire-economie",
"wonen-en-leefomgeving",
"herstel-van-natuur",
"meedoen",
"kansengelijkheid",
"zorg-en-gezondheid"
],
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"nace": {
"description": "Only examples in this NACE section.",
"enum": [
"A",
"B",
"C",
"D",
"E",
"F",
"G",
"H",
"I",
"J",
"K",
"L",
"M",
"N",
"O",
"P",
"Q",
"R",
"S",
"T"
],
"type": "string"
},
"scale": {
"description": "Only examples at this scale.",
"enum": [
"neighbourhood",
"city",
"region",
"country",
"europe",
"world"
],
"type": "string"
},
"societal_issue": {
"description": "Only examples about this societal issue.",
"enum": [
"energietransitie",
"voedseltransitie",
"klimaat",
"circulaire-economie",
"wonen-en-leefomgeving",
"herstel-van-natuur",
"meedoen",
"kansengelijkheid",
"zorg-en-gezondheid"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_examples",
"outputSchema": {
"additionalProperties": {},
"properties": {
"examples": {
"items": {
"additionalProperties": {},
"properties": {
"audiences": {
"items": {
"type": "string"
},
"type": "array"
},
"change": {
"type": "string"
},
"facts": {
"items": {
"additionalProperties": {},
"properties": {
"source": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"text",
"source"
],
"type": "object"
},
"type": "array"
},
"figure": {
"type": "string"
},
"id": {
"type": "string"
},
"madeUp": {
"const": true,
"type": "boolean"
},
"organisation": {
"type": "string"
},
"rightsHolder": {
"type": "string"
},
"situation": {
"type": "string"
},
"tension": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"title",
"organisation",
"situation",
"change",
"rightsHolder",
"figure",
"tension",
"audiences",
"madeUp"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"examples"
],
"type": "object"
}
},
{
"description": "The European Central Bank's euro reference rates as Maktoob keeps them (public.exchange_rates, fetched every afternoon, from 2015): per day and currency the rate, 1 EUR = rate units of currency. Give date (YYYY-MM-DD) for one day: a day without rates (a weekend, a holiday) gives the last working day before it. Or from and to for a range of at most 366 days. currencies narrows to ISO 4217 codes (USD, GBP). source_id is ecb-eurofxref in the source register. To convert an amount, use convert_quantity.",
"inputSchema": {
"properties": {
"currencies": {
"description": "ISO 4217 codes; all when left out.",
"items": {
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"maxItems": 40,
"type": "array"
},
"date": {
"description": "One day, YYYY-MM-DD; today when nothing is given.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"from": {
"description": "First day of a range, YYYY-MM-DD.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"to": {
"description": "Last day of a range, YYYY-MM-DD; today when left out.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
}
},
"type": "object"
},
"name": "list_exchange_rates",
"outputSchema": {
"additionalProperties": {},
"properties": {
"base": {
"type": "string"
},
"from": {
"type": "string"
},
"rates": {
"items": {
"additionalProperties": {},
"properties": {
"currency": {
"type": "string"
},
"day": {
"type": "string"
},
"rate": {
"type": "number"
}
},
"required": [
"day",
"currency",
"rate"
],
"type": "object"
},
"type": "array"
},
"source_id": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"rates",
"base",
"source_id",
"from",
"to"
],
"type": "object"
}
},
{
"description": "Narrate's herkomst list: where the frameworks, standards and methods of the impact field come from. Per record the organisation, the year (and whether that year is certain), the country, city and seat, the language it was written in, the source it rests on, a note, the list it belongs to (soup: the alphabet soup of standards; fabrik and fabrik_research: what Fabrik imports or studies; mentioned: named in passing) and its currents: the tradition its makers worked in first, then the currents it also touches. `currents` lists those currents in lane order, each with its name, one line and the ids of its sources (get_source). In list order. Narrate's own map of origins and its currents read this too.",
"inputSchema": {
"properties": {
"list": {
"description": "Only the records of this list. Leave it out for all of them.",
"enum": [
"soup",
"fabrik",
"fabrik_research",
"mentioned"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_framework_origins",
"outputSchema": {
"additionalProperties": {},
"properties": {
"currents": {
"items": {
"additionalProperties": {},
"properties": {
"explanation": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"id": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"name",
"explanation",
"sources"
],
"type": "object"
},
"type": "array"
},
"origins": {
"items": {
"additionalProperties": {},
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"country": {
"type": "string"
},
"id": {
"type": "string"
},
"language": {
"type": "string"
},
"list": {
"type": "string"
},
"name": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"note": {
"type": [
"string",
"null"
]
},
"organization": {
"type": "string"
},
"position": {
"type": "number"
},
"seat": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"year": {
"type": "number"
},
"year_certain": {
"type": "boolean"
}
},
"required": [
"id",
"year",
"organization",
"country",
"language",
"source_url",
"list"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"origins",
"currents"
],
"type": "object"
}
},
{
"description": "What funders allow, advise or spent for monitoring and evaluation, as a share of their money (narrate.works/materialen/financiersnormen). Per norm: funder, funder_type, region, year, share_low to share_high in per cent (a ceiling starts at 0), base (what it is a share of: project, program, organization, eu_funds, capital), scope (evaluation, monitoring_and_evaluation, technical_assistance), status (requirement, ceiling, guideline, rule_of_thumb, measured), scale (project or portfolio), budget_min and budget_max (the project budgets the norm applies to, in budget_currency; null when the source names none), source_id in the source register and an explanation. Only a project-scale share of a project fits one budget. comparisons sets a norm against what was spent. Narrate advises 6 to 8 per cent of a project: calculate_budget.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_funder_norms",
"outputSchema": {
"additionalProperties": {},
"properties": {
"comparisons": {
"items": {
"additionalProperties": {},
"properties": {
"explanation": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"id": {
"type": "string"
},
"norm_share_high": {
"type": "number"
},
"norm_share_low": {
"type": "number"
},
"norm_source_id": {
"type": "string"
},
"practice_share_high": {
"type": "number"
},
"practice_share_low": {
"type": "number"
},
"practice_source_id": {
"type": "string"
},
"practice_year": {
"type": "number"
},
"who": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
}
},
"required": [
"id",
"who",
"norm_share_low",
"norm_share_high",
"norm_source_id",
"practice_share_low",
"practice_share_high",
"practice_year",
"practice_source_id",
"explanation"
],
"type": "object"
},
"type": "array"
},
"norms": {
"items": {
"additionalProperties": {},
"properties": {
"base": {
"type": "string"
},
"budget_currency": {
"type": [
"string",
"null"
]
},
"budget_max": {
"type": [
"number",
"null"
]
},
"budget_min": {
"type": [
"number",
"null"
]
},
"explanation": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"funder": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"funder_type": {
"type": "string"
},
"id": {
"type": "string"
},
"instruments": {
"items": {
"type": "string"
},
"type": "array"
},
"money_kind": {
"type": [
"string",
"null"
]
},
"perspective": {
"type": [
"string",
"null"
]
},
"perspective_reason": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"quote_key": {
"type": [
"string",
"null"
]
},
"region": {
"type": "string"
},
"scale": {
"type": "string"
},
"scope": {
"type": "string"
},
"share_high": {
"type": "number"
},
"share_low": {
"type": "number"
},
"short_name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"source_id": {
"type": "string"
},
"status": {
"type": "string"
},
"year": {
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"funder",
"short_name",
"funder_type",
"region",
"year",
"share_low",
"share_high",
"base",
"scope",
"status",
"scale",
"source_id",
"quote_key",
"explanation",
"perspective",
"perspective_reason",
"money_kind",
"instruments"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
}
},
"required": [
"norms",
"comparisons",
"page"
],
"type": "object"
}
},
{
"description": "Narrate's funding calendar: grant rounds, research calls, European funds and loans for work with impact (SDE++, MIT, VEKI, DEI+, Innovatiekrediet, NWO Take-off, EIC Accelerator, LIFE, Innovation Fund), round by round. Per round its scheme, names (Dutch and English), form (grant, research_call, eu_fund, loan), level (regional, national, european), funder and page, the audience groups it suits, its status today (upcoming, open, oversubscribed, closed), when it opens and closes, its budget, the day we look at it again and why, and its moments in order: the date (a day, a month or a year), what happens then (opens, closes, deadline, budget, budget_changed, oversubscribed, rules_published, calls_announced), the amount for a budget, its source and quote id (get_source gives the quote), the day we checked it and whether it may still move. from_feed: a call from the EU Funding & Tenders Portal, with url, no quote. The same rows as narrate.works/materialen/financieringskalender.",
"inputSchema": {
"properties": {
"form": {
"description": "Only this kind of money.",
"enum": [
"grant",
"research_call",
"eu_fund",
"loan"
],
"type": "string"
},
"from": {
"description": "Only the rounds that still run on or after this date (YYYY, YYYY-MM or YYYY-MM-DD), such as today for what you can still apply to.",
"pattern": "^\\d{4}(-(0[1-9]|1[0-2])(-(0[1-9]|[12]\\d|3[01]))?)?$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"level": {
"description": "Only money from this level.",
"enum": [
"regional",
"national",
"european"
],
"type": "string"
},
"status": {
"description": "Only the rounds with this status today. Leave it out for all of them.",
"enum": [
"upcoming",
"open",
"oversubscribed",
"closed"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_funding_calendar",
"outputSchema": {
"additionalProperties": {},
"properties": {
"page": {
"type": "string"
},
"rounds": {
"items": {
"additionalProperties": {},
"properties": {
"audiences": {
"items": {
"type": "string"
},
"type": "array"
},
"budget_eur": {
"type": [
"number",
"null"
]
},
"closes": {
"type": [
"string",
"null"
]
},
"form": {
"type": "string"
},
"full_name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"funder": {
"type": "string"
},
"level": {
"type": "string"
},
"moments": {
"items": {
"additionalProperties": {},
"properties": {
"amount_eur": {
"type": [
"number",
"null"
]
},
"checked_on": {
"type": "string"
},
"date": {
"type": "string"
},
"from_feed": {
"type": "boolean"
},
"milestone": {
"type": "string"
},
"quote_id": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"text": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"uncertain": {
"type": "boolean"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"date",
"milestone",
"text",
"amount_eur",
"source",
"quote_id",
"checked_on",
"uncertain",
"from_feed",
"url"
],
"type": "object"
},
"type": "array"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"opens": {
"type": [
"string",
"null"
]
},
"review_on": {
"type": "string"
},
"review_reason": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"round": {
"type": "string"
},
"scheme": {
"type": "string"
},
"status": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"scheme",
"round",
"name",
"full_name",
"form",
"level",
"funder",
"url",
"audiences",
"status",
"opens",
"closes",
"budget_eur",
"review_on",
"review_reason",
"moments"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"rounds",
"page"
],
"type": "object"
}
},
{
"description": "Every division of the Netherlands into areas that Narrate keeps (narrate.works/naslag/geografieen), each with its areas, codes and source: CBS divisions (provinces, municipalities, COROP, policy regions such as labour market, GGD, safety, RES and youth care regions, court districts, districts and neighbourhoods), postcodes PC4 and PC6, MIRT regions, NUTS 1 to 3, water boards, Natura 2000, National Parks, World Heritage, business parks (IBIS), grid operators, environmental services and the Kingdom (ISO 3166-2:NL). Codes are CBS's own (PV27, GM0363), postcodes (1011, 1011AB), NUTS codes or a slug. year is the year of the borders; map is a JSON file with each area's outline as an SVG path in kilometres of the Dutch grid. A geography with more than 1,000 areas comes without codes (areas says how many): search them with get_code_list and a query. Countries and world regions are in get_code_list too. Each area's polygon as GeoJSON: list_geography_outlines and get_geography_area.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_geographies",
"outputSchema": {
"additionalProperties": {},
"properties": {
"geographies": {
"items": {
"additionalProperties": {},
"properties": {
"areas": {
"type": "number"
},
"codes": {
"items": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"code",
"name"
],
"type": "object"
},
"type": "array"
},
"description": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"id": {
"type": "string"
},
"map": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"source": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
}
},
"required": [
"id",
"name",
"description",
"source",
"year",
"areas",
"map",
"codes"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
}
},
"required": [
"geographies",
"page"
],
"type": "object"
}
},
{
"description": "The polygons of the areas of one geography of list_geographies as a GeoJSON FeatureCollection in WGS 84 (EPSG:4326, six decimals; RFC 7946): each area's border as its source publishes it (CBS Gebiedsindelingen via PDOK, generalised; PC4; NUTS 2024 from Eurostat GISCO at 1:1 million; the water boards, Natura 2000 and the rest), not simplified further for the map. Each feature's id is the area's code; its properties give geography, code and name. A page holds at most 500 areas or about 4 MB, in the order of the codes: give offset to read on, next_offset says where the next page starts (null at the end). Give codes for only those areas. The Kingdom and PC6 have no polygons yet. One area with what it lies in: get_geography_area.",
"inputSchema": {
"properties": {
"codes": {
"description": "Only these areas, by code.",
"items": {
"maxLength": 60,
"type": "string"
},
"maxItems": 500,
"type": "array"
},
"geography": {
"description": "The geography's id, such as nl-municipalities (list_geographies).",
"maxLength": 60,
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"limit": {
"default": 200,
"description": "At most this many areas, up to 500.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Skip this many areas: the next_offset of the page before.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"geography"
],
"type": "object"
},
"name": "list_geography_outlines",
"outputSchema": {
"additionalProperties": {},
"properties": {
"features": {
"items": {
"additionalProperties": {},
"properties": {
"geometry": {
"additionalProperties": {},
"properties": {
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"id": {
"type": "string"
},
"properties": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"geography": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"geography",
"code",
"name"
],
"type": "object"
},
"type": {
"const": "Feature",
"type": "string"
}
},
"required": [
"type",
"id",
"properties",
"geometry"
],
"type": "object"
},
"type": "array"
},
"geography": {
"type": "string"
},
"next_offset": {
"type": [
"number",
"null"
]
},
"page": {
"type": "string"
},
"total": {
"type": "number"
},
"type": {
"const": "FeatureCollection",
"type": "string"
}
},
"required": [
"type",
"features",
"geography",
"total",
"next_offset",
"page"
],
"type": "object"
}
},
{
"description": "Every indicator in Narrate's indicator catalogue (narrate.works/naslag/indicatoren): its name and definition in Dutch and English, the unit, the layer (input to impact), the domain, the SDG it measures, the metric and QUDT kind it maps to, which direction is better, in how many initiatives it is used, whether it comes from a document of an initiative or a public page (origin: document or bron), and our reading in six classifications beside the SDG (classifications: societal issue, a societal issue id of /naslag/opgaven; nace, iris, dimension, taxonomy and capital, each a code of its list on /naslag/lijsten and get_code_list; a missing key means none). Without the quotes, sources and initiative names, which are for the team.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_indicators",
"outputSchema": {
"additionalProperties": {},
"properties": {
"indicators": {
"items": {
"additionalProperties": {},
"properties": {
"classifications": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"definition": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"id": {
"type": "string"
},
"initiatives": {
"type": "number"
},
"layer": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"origin": {
"type": [
"string",
"null"
]
},
"unit": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"definition",
"unit",
"layer",
"initiatives"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
}
},
"required": [
"indicators",
"page"
],
"type": "object"
}
},
{
"description": "Every photo of Narrate's public library (/bibliotheek): the stock, archive, object and team photos and the public photos of initiatives, each with its path, kind, position, record (what it shows, who made it, how it may be used) and traits. Consent and private photos are never in it.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_library_assets",
"outputSchema": {
"additionalProperties": {},
"properties": {
"assets": {
"items": {
"additionalProperties": {},
"properties": {
"kind": {
"type": "string"
},
"path": {
"type": "string"
}
},
"required": [
"path",
"kind"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"assets"
],
"type": "object"
}
},
{
"description": "Every metric in Maktoob, Narrate's reference work (narrate.works/naslag/metrics): what you measure, apart from any goal. Each has a name and definition (Dutch and English), a QUDT quantity kind and unit (local name and IRI), its data type, its composition (Fabrik ADR-108) and parts (other metrics, each with a power; a divisor says how the total is spread over it, linear or weighted), which direction is better (almost always none) and the indicators that measure it. Below come QUDT's three layers as far as Maktoob uses them: dimension_vectors (with a formula such as L²·M·T⁻²), quantity_kinds (dimension vector, broader kind) and units (symbol, factor to the SI unit, quantity kinds). Every row has its IRI (QUDT's, or under w3id.org/maktoob when origin is maktoob: a row Maktoob adds to QUDT, such as euro per year), the metrics that use it and our begrip for it (concept, a glossary id). An indicator adds a goal and a context to a metric: list_indicators.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_metrics",
"outputSchema": {
"additionalProperties": {},
"properties": {
"dimension_vectors": {
"items": {
"additionalProperties": {},
"properties": {
"concept": {
"type": [
"string",
"null"
]
},
"definition": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"formula": {
"type": "string"
},
"id": {
"type": "string"
},
"iri": {
"type": "string"
},
"metrics": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"quantity_kinds": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"iri",
"formula",
"name",
"definition",
"quantity_kinds",
"metrics"
],
"type": "object"
},
"type": "array"
},
"metrics": {
"items": {
"additionalProperties": {},
"properties": {
"composition": {
"type": "string"
},
"data_type": {
"type": "string"
},
"definition": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"denominator": {
"type": [
"string",
"null"
]
},
"dimension_vector": {
"type": [
"string",
"null"
]
},
"dimension_vector_iri": {
"type": [
"string",
"null"
]
},
"direction": {
"type": "string"
},
"id": {
"type": "string"
},
"indicator_names": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
"type": "array"
},
"indicators": {
"items": {
"type": "string"
},
"type": "array"
},
"maktoob": {
"type": [
"string",
"null"
]
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"numerator": {
"type": [
"string",
"null"
]
},
"parts": {
"items": {
"additionalProperties": {},
"properties": {
"distribution": {
"anyOf": [
{
"enum": [
"linear",
"weighted"
],
"type": "string"
},
{
"type": "null"
}
]
},
"metric": {
"type": "string"
},
"name": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"power": {
"type": "number"
}
},
"required": [
"metric",
"power",
"name"
],
"type": "object"
},
"type": "array"
},
"quantity_kind": {
"type": "string"
},
"quantity_kind_iri": {
"type": "string"
},
"unit": {
"type": "string"
},
"unit_iri": {
"type": "string"
},
"unit_symbol": {
"type": "string"
}
},
"required": [
"id",
"name",
"definition",
"quantity_kind",
"unit",
"quantity_kind_iri",
"unit_iri",
"data_type",
"composition",
"numerator",
"denominator",
"direction",
"maktoob",
"indicators",
"dimension_vector",
"dimension_vector_iri",
"unit_symbol",
"indicator_names"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
},
"pages": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"quantity_kinds": {
"items": {
"additionalProperties": {},
"properties": {
"broader": {
"type": [
"string",
"null"
]
},
"broader_iri": {
"type": [
"string",
"null"
]
},
"concept": {
"type": [
"string",
"null"
]
},
"definition": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"dimension_vector": {
"type": "string"
},
"id": {
"type": "string"
},
"iri": {
"type": "string"
},
"metrics": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"origin": {
"enum": [
"qudt",
"maktoob"
],
"type": "string"
},
"units": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"iri",
"name",
"definition",
"dimension_vector",
"broader",
"broader_iri",
"units",
"metrics"
],
"type": "object"
},
"type": "array"
},
"units": {
"items": {
"additionalProperties": {},
"properties": {
"concept": {
"type": [
"string",
"null"
]
},
"dimension_vector": {
"type": "string"
},
"factor": {
"type": "number"
},
"id": {
"type": "string"
},
"iri": {
"type": "string"
},
"metrics": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"origin": {
"enum": [
"qudt",
"maktoob"
],
"type": "string"
},
"quantity_kinds": {
"items": {
"type": "string"
},
"type": "array"
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"iri",
"name",
"symbol",
"factor",
"dimension_vector",
"quantity_kinds",
"metrics"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"metrics",
"dimension_vectors",
"quantity_kinds",
"units",
"page",
"pages"
],
"type": "object"
}
},
{
"description": "Every organization in Narrate's public landscapes, each once with its roles: funder (the funding landscape: public schemes, funds, foundations, impact investors, banks), impact_organization (the impact landscape: who makes impact enterprise possible in the Netherlands) and accelerator (the innovation landscape: accelerators, incubators, field labs and programs, public view). Give role for one landscape in its own order; without it every party comes once, by name. Each role holds the landscape's entry, such as a funder's kind, layer, instruments and phases, an impact organization's category, themes and evidence, or an accelerator's years, SDGs, reach and sources, with a summary in Dutch and English where there is one. Values are Narrate's own codes. sources holds the funders' web pages in the public source register.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"role": {
"description": "Only the parties with this role: funder, impact_organization or accelerator.",
"enum": [
"funder",
"impact_organization",
"accelerator"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_parties",
"outputSchema": {
"additionalProperties": {},
"properties": {
"pages": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"parties": {
"items": {
"additionalProperties": {},
"properties": {
"accelerator": {
"additionalProperties": {},
"properties": {
"category": {
"type": "string"
},
"location": {
"type": "string"
},
"name": {
"type": "string"
},
"sdgs": {
"items": {
"type": "number"
},
"type": "array"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"name",
"category",
"location",
"sdgs"
],
"type": "object"
},
"funder": {
"additionalProperties": {},
"properties": {
"instruments": {
"items": {
"type": "string"
},
"type": "array"
},
"kind": {
"type": "string"
},
"layer": {
"type": "string"
},
"name": {
"type": "string"
},
"phases": {
"items": {
"type": "string"
},
"type": "array"
},
"slug": {
"type": "string"
},
"summary": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url",
"kind",
"layer",
"instruments",
"phases",
"summary"
],
"type": "object"
},
"impact_organization": {
"additionalProperties": {},
"properties": {
"category": {
"type": "string"
},
"location": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"summary": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"themes": {
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url",
"category",
"location",
"themes",
"summary"
],
"type": "object"
},
"name": {
"type": "string"
},
"roles": {
"items": {
"type": "string"
},
"type": "array"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"name",
"roles"
],
"type": "object"
},
"type": "array"
},
"sources": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"publisher": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"title",
"publisher"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"parties",
"sources",
"pages"
],
"type": "object"
}
},
{
"description": "The CBS consumer price index of all spending per year (StatLine 83131NED, 2015 = 100), as Maktoob keeps it (public.price_indices, series cpi, fetched daily). To bring euros of one year to the prices of another, divide by the index of the one year and multiply by that of the other, or use convert_quantity with price_year. source_id is cbs-cpi-83131ned in the source register.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_price_index",
"outputSchema": {
"additionalProperties": {},
"properties": {
"base_year": {
"type": "number"
},
"index": {
"items": {
"additionalProperties": {},
"properties": {
"value": {
"type": "number"
},
"year": {
"type": "number"
}
},
"required": [
"year",
"value"
],
"type": "object"
},
"type": "array"
},
"series": {
"type": "string"
},
"source_id": {
"type": "string"
}
},
"required": [
"series",
"base_year",
"source_id",
"index"
],
"type": "object"
}
},
{
"description": "Three vocabularies of QUDT next to the metrics of Maktoob, each in full (narrate.works/naslag/metrics/constanten, /voorvoegsels and /stelsels). physical_constants: every physical constant with its value in a QUDT unit, its uncertainty (also in ppm), its determination (such as CODATA 2006) and quantity kind; si marks the seven that define the SI since 2019, with the exact value and the unit each fixes. unit_prefixes: kilo, milli, kibi and the rest, each with its symbol, its exact factor (10ⁿ or 2ⁿ), decimal or binary, and how many units carry it. systems_of_units: SI, CGS, imperial and others, with their base units and how many units belong to them. Names in Dutch and English; every row has its QUDT IRI. Give vocabulary for one of the three; leave it out for all. The quantity kinds and units themselves: list_metrics.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"vocabulary": {
"description": "Only this vocabulary: physical_constants, unit_prefixes or systems_of_units.",
"enum": [
"physical_constants",
"unit_prefixes",
"systems_of_units"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_qudt_vocabularies",
"outputSchema": {
"additionalProperties": {},
"properties": {
"pages": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"physical_constants": {
"items": {
"additionalProperties": {},
"properties": {
"abbreviation": {
"type": [
"string",
"null"
]
},
"definition": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"determination": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"name": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"name",
"source"
],
"type": "object"
},
{
"type": "null"
}
]
},
"exact": {
"type": "boolean"
},
"id": {
"type": "string"
},
"iri": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"origin": {
"enum": [
"qudt",
"maktoob"
],
"type": "string"
},
"quantity_kind": {
"type": [
"string",
"null"
]
},
"quantity_kind_name": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"related": {
"items": {
"type": "string"
},
"type": "array"
},
"si": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"fixes": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"name",
"symbol"
],
"type": "object"
},
"order": {
"type": "number"
},
"since": {
"type": "string"
},
"source": {
"type": "string"
},
"unit": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"name",
"symbol"
],
"type": "object"
},
"value": {
"type": "number"
}
},
"required": [
"order",
"value",
"unit",
"fixes",
"since",
"source"
],
"type": "object"
},
{
"type": "null"
}
]
},
"ucum": {
"type": [
"string",
"null"
]
},
"values": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"relative_uncertainty_ppm": {
"type": [
"number",
"null"
]
},
"symbol": {
"type": "string"
},
"uncertainty": {
"type": [
"number",
"null"
]
},
"value": {
"type": "number"
}
},
"required": [
"id",
"name",
"symbol",
"value",
"uncertainty"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"id",
"iri",
"name",
"definition",
"quantity_kind",
"quantity_kind_name",
"values",
"exact",
"abbreviation",
"ucum",
"related"
],
"type": "object"
},
"type": "array"
},
"systems_of_units": {
"items": {
"additionalProperties": {},
"properties": {
"abbreviation": {
"type": [
"string",
"null"
]
},
"base_units": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"name": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
{
"type": "null"
}
]
},
"symbol": {
"type": "string"
}
},
"required": [
"id",
"name",
"symbol"
],
"type": "object"
},
"type": "array"
},
"definition": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"id": {
"type": "string"
},
"iri": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"units": {
"type": "number"
}
},
"required": [
"id",
"iri",
"name",
"definition",
"abbreviation",
"base_units",
"units"
],
"type": "object"
},
"type": "array"
},
"unit_prefixes": {
"items": {
"additionalProperties": {},
"properties": {
"definition": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"factor": {
"type": "number"
},
"id": {
"type": "string"
},
"iri": {
"type": "string"
},
"kind": {
"enum": [
"decimal",
"binary"
],
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"symbol": {
"type": "string"
},
"ucum": {
"type": [
"string",
"null"
]
},
"units": {
"type": "number"
}
},
"required": [
"id",
"iri",
"name",
"definition",
"symbol",
"factor",
"kind",
"ucum",
"units"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"pages"
],
"type": "object"
}
},
{
"description": "The conversations with readers that the Narrate team shows under an article (\"Gesprek in de marge\"), with each reader's consent: the paragraph each answers and its messages, without any email address or account.",
"inputSchema": {
"properties": {
"article": {
"description": "The article's slug.",
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"article"
],
"type": "object"
},
"name": "list_reader_conversations",
"outputSchema": {
"additionalProperties": {},
"properties": {
"conversations": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
},
"messages": {
"items": {
"additionalProperties": {},
"properties": {
"body": {
"type": "string"
},
"created_at": {
"type": "string"
},
"from": {
"enum": [
"reader",
"team"
],
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"spoken": {
"type": "boolean"
}
},
"required": [
"id",
"from",
"name",
"body",
"spoken",
"created_at"
],
"type": "object"
},
"type": "array"
},
"published_at": {
"type": "string"
},
"quote": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"quote",
"published_at",
"messages"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"conversations"
],
"type": "object"
}
},
{
"description": "Narrate's regulatory calendar: the European and Dutch rules on sustainability and impact reporting (such as the CSRD, the ESRS, the CSDDD, the EUDR, the AI Act and the taxonomy) and the dates that matter for each. Per rule its short and full name (Dutch and English), its status (applies, upcoming, proposal, stalled), the audience groups it concerns, the day we look at it again and why, and its dates in order: the date (a day, a month or a year), what happens then, the source it rests on and the id of the quote in it (get_source gives the quote itself), the day we last checked it and whether the date is still uncertain, and the duties that come back with their rule (an RRULE). The same rows as narrate.works/materialen/regelkalender.",
"inputSchema": {
"properties": {
"from": {
"description": "Only the dates on or after this one (YYYY, YYYY-MM or YYYY-MM-DD), such as today for what is coming. A rule without such a date is left out.",
"pattern": "^\\d{4}(-(0[1-9]|1[0-2])(-(0[1-9]|[12]\\d|3[01]))?)?$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"status": {
"description": "Only the rules with this status. Leave it out for all of them.",
"enum": [
"applies",
"upcoming",
"proposal",
"stalled"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_regulations",
"outputSchema": {
"additionalProperties": {},
"properties": {
"page": {
"type": "string"
},
"regulations": {
"items": {
"additionalProperties": {},
"properties": {
"audiences": {
"items": {
"type": "string"
},
"type": "array"
},
"dates": {
"items": {
"additionalProperties": {},
"properties": {
"checked_on": {
"type": "string"
},
"date": {
"type": "string"
},
"duty": {
"type": [
"string",
"null"
]
},
"quote_id": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"text": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"uncertain": {
"type": "boolean"
}
},
"required": [
"date",
"text",
"source",
"quote_id",
"checked_on",
"uncertain",
"duty"
],
"type": "object"
},
"type": "array"
},
"duties": {
"items": {
"additionalProperties": {},
"properties": {
"description": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"id": {
"type": "string"
},
"quote_id": {
"type": [
"string",
"null"
]
},
"rule": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"starts_on": {
"type": "string"
},
"title": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
}
},
"required": [
"id",
"title",
"description",
"source",
"quote_id",
"starts_on",
"rule"
],
"type": "object"
},
"type": "array"
},
"full_name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"key": {
"type": "string"
},
"name": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"review_on": {
"type": "string"
},
"review_reason": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"status": {
"type": "string"
}
},
"required": [
"key",
"name",
"full_name",
"status",
"audiences",
"review_on",
"review_reason",
"dates",
"duties"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"regulations",
"page"
],
"type": "object"
}
},
{
"description": "The products and services in Narrate's shop, as narrate.works/winkel (English /shop) shows them: name, description, price excluding VAT (null is price on request), billing frequency, thumbnail and what the shop card does: quote (ask for a quote, most products) or basket (order straight away, on invoice). The shop sells to businesses only: ordering needs an EU VAT number, checked with VIES, and from another EU country than the Netherlands the VAT is reverse-charged; a Dutch organisation also gives its KvK number, and one without a VAT number orders with its KvK number and pays Dutch VAT; outside the EU, ask for a quote. For the questions of a quote request, use get_quote_request_form. Ordering and asking for a quote happen on the site; send the person to the page.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_shop_catalog",
"outputSchema": {
"additionalProperties": {},
"properties": {
"page": {
"type": "string"
},
"products": {
"items": {
"additionalProperties": {},
"properties": {
"billing_frequency": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"image_url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"outcome": {
"enum": [
"quote",
"cart"
],
"type": "string"
},
"price": {
"type": [
"number",
"null"
]
},
"questionnaire": {
"description": "The key of the questions a quote request asks; get_quote_request_form gives them.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"description",
"price",
"billing_frequency",
"image_url",
"outcome"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"products",
"page"
],
"type": "object"
}
},
{
"description": "The specials: Narrate's long, illustrated articles, with figures you can explore. Returns each with its title, description and path; read one in full with read_page.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"query": {
"default": "",
"description": "Words to look for in the title or description. Empty lists every special.",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "list_specials",
"outputSchema": {
"additionalProperties": {},
"properties": {
"specials": {
"items": {
"additionalProperties": {},
"properties": {
"description": {
"type": "string"
},
"path": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"path",
"title",
"description",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"specials"
],
"type": "object"
}
},
{
"description": "Figures per area and year in Maktoob, by source. eurostat-sdg (default): EU SDG indicators (sdg_01_10 to sdg_17_60). eurostat-hicp: consumer prices per EU country (prc_hicp_aind). worldbank-wdi: PPP factors (PA.NUS.PPP for GDP, PA.NUS.PRVT.PP for consumption) and consumer prices (FP.CPI.TOTL, FP.CPI.TOTL.ZG). un-sdg: ~700 UN SDG series (SI_POV_DAY1), areas NL, M49_001 world, M49_150, M49_513. cbs-monitor-brede-welvaart: ~300 CBS well-being indicators named in Dutch (mediaan-vermogen-van-huishoudens), view trend (NL) or eu. leefbaarometer: liveability lbm and its dimensions afw, fys, onv, soc, vrz, won per municipality (GM0363) or district (WK0363AA); name the areas. No goal or dataset: the catalogue; else every series (labels name its choices) with figures from from_year on. areas: ISO alpha-2 (NL, DE), aggregates (EU27_2020, EUU) or CBS codes; default NL and the EU. source follows from dataset.",
"inputSchema": {
"properties": {
"areas": {
"description": "Areas: NL, DE, EU27_2020, EUU, M49_001, or a municipality or district (GM0363, WK0363AA) at the Leefbaarometer. Default NL and the EU (EU27_2020 at Eurostat, EUU at the World Bank), at the UN the world (M49_001).",
"items": {
"pattern": "^[A-Z0-9_]{2,20}$",
"type": "string"
},
"maxItems": 40,
"minItems": 1,
"type": "array"
},
"dataset": {
"description": "One data set: Eurostat SDG (sdg_01_10), World Bank (PA.NUS.PPP), UN SDG series (SI_POV_DAY1) or CBS indicator (ontwikkelingshulp).",
"pattern": "^(sdg_\\d{2}_[a-z0-9_]+|[a-z]{2}(\\.[a-z0-9]+){1,5}|[a-z][a-z0-9]*(_[a-z0-9]+){1,6}|[a-z0-9]+(-[a-z0-9]+){0,20})$",
"type": "string"
},
"from_year": {
"description": "Figures from this year on. Default: every year.",
"maximum": 2200,
"minimum": 1950,
"type": "integer"
},
"goal": {
"description": "One Sustainable Development Goal, 1 to 17.",
"maximum": 17,
"minimum": 1,
"type": "integer"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"source": {
"description": "eurostat-sdg (default), eurostat-hicp, worldbank-wdi, un-sdg, cbs-monitor-brede-welvaart or leefbaarometer.",
"enum": [
"eurostat-sdg",
"eurostat-hicp",
"worldbank-wdi",
"un-sdg",
"cbs-monitor-brede-welvaart",
"leefbaarometer"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_statistics",
"outputSchema": {
"additionalProperties": {},
"properties": {
"datasets": {
"items": {
"additionalProperties": {},
"properties": {
"dataset": {
"type": "string"
},
"goal": {
"type": [
"number",
"null"
]
},
"series": {
"type": "number"
},
"title": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
}
},
"required": [
"en"
],
"type": "object"
}
},
"required": [
"dataset",
"title",
"goal",
"series"
],
"type": "object"
},
"type": "array"
},
"series": {
"items": {
"additionalProperties": {},
"properties": {
"dataset": {
"type": "string"
},
"dimensions": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"goal": {
"type": [
"number",
"null"
]
},
"id": {
"type": "string"
},
"labels": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"observations": {
"items": {
"additionalProperties": {},
"properties": {
"area_code": {
"type": "string"
},
"period": {
"type": "string"
},
"status": {
"type": [
"string",
"null"
]
},
"value": {
"type": "number"
}
},
"required": [
"area_code",
"period",
"value",
"status"
],
"type": "object"
},
"type": "array"
},
"title": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
}
},
"required": [
"en"
],
"type": "object"
},
"unit": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"dataset",
"title",
"goal",
"unit",
"dimensions",
"labels",
"observations"
],
"type": "object"
},
"type": "array"
},
"source_id": {
"type": "string"
}
},
"required": [
"source_id",
"datasets",
"series"
],
"type": "object"
}
},
{
"description": "Open a vraaggesprek (a questionnaire or interview) by the code in its link: its title, the words at the start, what the person agrees to and its sections with their questions in order, in the language asked for when the vraaggesprek has it (else in its own; language and languages say which). Each question has an id, its kind (single, multiple, number, scale, open), its options and only_if: ask it only when an earlier question was answered with one of those option ids. found is false when the link is closed or the vraaggesprek is not open. Never shows anyone's answers.",
"inputSchema": {
"properties": {
"code": {
"description": "The code in the link, the part after /v/ (narrate.works/v/<code>).",
"pattern": "^[a-z0-9-]{4,40}$",
"type": "string"
},
"lang": {
"description": "The language to read it in: nl or en.",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "open_interview_link",
"outputSchema": {
"additionalProperties": {},
"properties": {
"found": {
"type": "boolean"
},
"interview": {
"additionalProperties": {},
"properties": {
"sections": {
"items": {
"additionalProperties": {},
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"type": "array"
},
"title": {
"type": "string"
}
},
"required": [
"title",
"sections"
],
"type": "object"
}
},
"required": [
"found"
],
"type": "object"
}
},
{
"description": "Opens the page behind a protected share link (narrate.works/gedeeld#<key>, English /shared), with the key from that link and what the link asks for: a password, or an allowed e-mail address with the code mailed to it (request_shared_link_code). First call it with only the key: opened is false with reason credentials and needs says what to ask the person for. Once open: the title, the page as Markdown, a note, whether it may be printed, the watermark and how many opens are left. Every successful call counts as an open, and a link can have a limit, so only open it when the person wants to read it. Wrong passwords and codes make the link wait. Never guess a password or code.",
"inputSchema": {
"properties": {
"code": {
"description": "The six-digit code mailed to that address.",
"maxLength": 12,
"type": "string"
},
"email": {
"description": "The person's e-mail address, when the link is for certain addresses.",
"maxLength": 320,
"type": "string"
},
"key": {
"description": "The key from the share link (the part after #, 43 characters). It opens this one page only.",
"pattern": "^[A-Za-z0-9_-]{43}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"password": {
"description": "The password the person was given, when the link has one.",
"maxLength": 1000,
"type": "string"
}
},
"required": [
"key"
],
"type": "object"
},
"name": "open_shared_link",
"outputSchema": {
"additionalProperties": {},
"properties": {
"needs": {
"additionalProperties": {},
"properties": {
"email": {
"type": "boolean"
},
"password": {
"type": "boolean"
}
},
"required": [
"password",
"email"
],
"type": "object"
},
"opened": {
"type": "boolean"
},
"page": {
"additionalProperties": {},
"properties": {
"allow_print": {
"type": "boolean"
},
"brand": {
"anyOf": [
{
"additionalProperties": {},
"properties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"expires_at": {
"type": "string"
},
"kind": {
"enum": [
"snapshot",
"live"
],
"type": "string"
},
"lang": {
"enum": [
"nl",
"en"
],
"type": "string"
},
"markdown": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"views_left": {
"type": [
"number",
"null"
]
},
"watermark": {
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"markdown",
"lang",
"kind",
"expires_at",
"note",
"watermark",
"allow_print",
"views_left",
"brand"
],
"type": "object"
},
"reason": {
"enum": [
"credentials",
"unknown",
"wrong_password",
"wrong_code",
"too_many",
"expired",
"revoked",
"used_up",
"gone"
],
"type": "string"
}
},
"required": [
"opened"
],
"type": "object"
}
},
{
"description": "Read where the presenter's screen of a live session is, by its room code: the state the screen keeps (the presentation, the slide, a running timer) and how many milliseconds ago it was set. live is null when the screen has not been live for twelve hours. follow_url is the page where someone elsewhere watches the slides without joining, the link SharePlay and the apps open too. Never cached.",
"inputSchema": {
"properties": {
"code": {
"description": "The room code on the presenter's screen, such as FCA6.",
"maxLength": 40,
"minLength": 2,
"pattern": "^[A-Za-z0-9-]+$",
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "presentation_read_live",
"outputSchema": {
"additionalProperties": {},
"properties": {
"follow_url": {
"type": "string"
},
"live": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"age_ms": {
"type": "number"
},
"state": {}
},
"required": [
"state",
"age_ms"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"live",
"follow_url"
],
"type": "object"
}
},
{
"description": "Save a phone's answer to a slide of a live session it signed up for (presentation_sign_up): a choice, a point on a scale or a line of text. The id is the phone's own for this answer, so sending it twice keeps one.",
"inputSchema": {
"properties": {
"code": {
"description": "The room code on the presenter's screen, such as FCA6.",
"maxLength": 40,
"minLength": 2,
"pattern": "^[A-Za-z0-9-]+$",
"type": "string"
},
"id": {
"description": "The answer's own id, made by the phone.",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"participant": {
"description": "The phone's own random id, the same for every call from it.",
"maxLength": 100,
"minLength": 1,
"pattern": "^[^/]+$",
"type": "string"
},
"slide": {
"description": "The slide's id.",
"maxLength": 120,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.-]+$",
"type": "string"
},
"value": {
"anyOf": [
{
"maxLength": 4000,
"type": "string"
},
{
"type": "number"
}
],
"description": "The answer: the chosen option ids, a number or text."
}
},
"required": [
"id",
"code",
"participant",
"slide",
"value"
],
"type": "object"
},
"name": "presentation_save_answer",
"outputSchema": {
"additionalProperties": {},
"properties": {
"saved": {
"const": true,
"type": "boolean"
}
},
"required": [
"saved"
],
"type": "object"
}
},
{
"description": "Sign a phone up for a live session of Narrate, by the room code on the presenter's screen: the person's name, email address and initiative, the version of the terms they agreed to, and whether they want an account. Only for the person themselves, with their consent: it is what the page /doemee does. Works only while the presenter's screen is live; signing up again from the same phone updates the details.",
"inputSchema": {
"properties": {
"beta_version": {
"description": "The alpha terms they agreed to, if any.",
"maxLength": 40,
"type": "string"
},
"code": {
"description": "The room code on the presenter's screen, such as FCA6.",
"maxLength": 40,
"minLength": 2,
"pattern": "^[A-Za-z0-9-]+$",
"type": "string"
},
"create_user": {
"default": false,
"description": "Whether they asked for an account.",
"type": "boolean"
},
"email": {
"description": "Their email address (the same rough check as the database).",
"maxLength": 254,
"pattern": "^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$",
"type": "string"
},
"initiative": {
"default": "",
"description": "The initiative they take part for.",
"maxLength": 200,
"type": "string"
},
"name": {
"description": "The person's name.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"participant": {
"description": "The phone's own random id, the same for every call from it.",
"maxLength": 100,
"minLength": 1,
"pattern": "^[^/]+$",
"type": "string"
},
"partner": {
"default": "",
"description": "The partner of the session, if any.",
"maxLength": 120,
"type": "string"
},
"presentation": {
"description": "The presentation's slug, as the screen shows it.",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"session": {
"default": "",
"description": "The session's id, if the phone knows it.",
"maxLength": 120,
"type": "string"
},
"terms_version": {
"description": "The version of the terms they agreed to.",
"maxLength": 40,
"minLength": 1,
"type": "string"
}
},
"required": [
"code",
"participant",
"presentation",
"name",
"email",
"terms_version"
],
"type": "object"
},
"name": "presentation_sign_up",
"outputSchema": {
"additionalProperties": {},
"properties": {
"photo_folder": {
"description": "The first folder of this phone's photos in storage: Narrate's account.",
"type": "string"
},
"signed_up": {
"const": true,
"type": "boolean"
}
},
"required": [
"signed_up"
],
"type": "object"
}
},
{
"description": "Reads one public page of narrate.works as Markdown, opening with that page's instructions for AI assistants (how to cite it, what not to say). Use a path from search_pages, e.g. '/naslag/begrippen' or '/reference/glossary'.",
"inputSchema": {
"properties": {
"path": {
"description": "The site path, starting with '/'.",
"maxLength": 300,
"minLength": 1,
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
},
"name": "read_page",
"outputSchema": null
},
{
"description": "Get a free key for Narrate's public HTTP API, without an account: the name of the app, script or organisation that calls, and an email address where Narrate can reach its maker if something goes wrong. Send the key as the header x-narrate-key: calls with it count under that name and get a wider limit than calls that do not say who they are. The key is shown only once; keep it secret. Only for the person themselves, with their consent. AI assistants do not need a key: they use the MCP server.",
"inputSchema": {
"properties": {
"email": {
"description": "Where Narrate can reach the maker. Removed when the key is stopped, or after 12 months without use.",
"maxLength": 254,
"pattern": "^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"name": {
"description": "The name of the app, script or organisation, as the team should see it.",
"maxLength": 80,
"minLength": 2,
"type": "string"
},
"website": {
"description": "The website of the app or organisation, if any.",
"maxLength": 200,
"pattern": "^https?:\\/\\/\\S+$",
"type": "string"
}
},
"required": [
"name",
"email"
],
"type": "object"
},
"name": "register_api_client",
"outputSchema": {
"additionalProperties": {},
"properties": {
"key": {
"type": "string"
},
"key_prefix": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"name",
"key",
"key_prefix"
],
"type": "object"
}
},
{
"description": "Ask to join the alpha of the Fabrik apps (iPhone, iPad, Android) for a person, without an account: their email address, and if they like their name, organisation, the platforms they use and a short note. Only with the person's own consent: they asked for it themselves. Narrate's team reads every request and invites a small group of clients; an invitation comes by mail. Nothing is answered about whether the address was known.",
"inputSchema": {
"properties": {
"email": {
"description": "The person's own email address, where the invitation goes.",
"format": "email",
"maxLength": 320,
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"name": {
"description": "Their name.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"note": {
"description": "What they would like to use it for.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
},
"organization": {
"description": "The organisation they work for or with.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"platforms": {
"description": "Where they would use it: ios (iPhone and iPad), android, web.",
"items": {
"enum": [
"ios",
"android",
"web"
],
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"via": {
"default": "assistant",
"description": "Where the request comes from: the site's form, the app, or an assistant (the default).",
"enum": [
"site",
"app",
"assistant"
],
"type": "string"
}
},
"required": [
"email"
],
"type": "object"
},
"name": "request_beta_access",
"outputSchema": {
"additionalProperties": {},
"properties": {
"received": {
"const": true,
"type": "boolean"
}
},
"required": [
"received"
],
"type": "object"
}
},
{
"description": "Asks for the code that opens a protected share link meant for certain e-mail addresses: with the key from the link and the person's address. Only an allowed address gets a mail, with a six-digit code that works for ten minutes; the answer is the same for any other address, so it never tells who the link is for. sent is false with a reason when the link itself is unknown, expired, withdrawn or used up, or after too many requests.",
"inputSchema": {
"properties": {
"email": {
"description": "The person's own e-mail address.",
"maxLength": 320,
"type": "string"
},
"key": {
"description": "The key from the share link (the part after #, 43 characters). It opens this one page only.",
"pattern": "^[A-Za-z0-9_-]{43}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"key",
"email"
],
"type": "object"
},
"name": "request_shared_link_code",
"outputSchema": {
"additionalProperties": {},
"properties": {
"reason": {
"enum": [
"unknown",
"too_many",
"expired",
"revoked",
"used_up"
],
"type": "string"
},
"sent": {
"type": "boolean"
}
},
"required": [
"sent"
],
"type": "object"
}
},
{
"description": "Open the answers so far of a response kept for a reminder, by the code in its link and its key (from keep_interview_response, or the verder part of the reminder's link). Only for the person themselves. found is false when the key opens nothing: the answers were handed in, or the link closed. remind says whether a reminder is still to come.",
"inputSchema": {
"properties": {
"code": {
"description": "The code in the link, the part after /v/ (narrate.works/v/<code>).",
"pattern": "^[a-z0-9-]{4,40}$",
"type": "string"
},
"key": {
"description": "The key of a kept response: what keep_interview_response answered, or the verder part of the reminder's link.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"code",
"key"
],
"type": "object"
},
"name": "resume_interview_response",
"outputSchema": {
"additionalProperties": {},
"properties": {
"answers": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"found": {
"type": "boolean"
},
"number": {
"type": "number"
},
"remind": {
"type": "boolean"
}
},
"required": [
"found"
],
"type": "object"
}
},
{
"description": "Stop a free key for Narrate's API: it no longer works, and the email address that came with it is removed. Use it when a key leaked or is no longer needed; ask for a new one with register_api_client. Ask the person first.",
"inputSchema": {
"properties": {
"key": {
"description": "The key, nrk_ and 32 characters.",
"pattern": "^nrk_[A-Za-z0-9_-]{32}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"key"
],
"type": "object"
},
"name": "revoke_api_key",
"outputSchema": {
"additionalProperties": {},
"properties": {
"revoked": {
"const": true,
"type": "boolean"
}
},
"required": [
"revoked"
],
"type": "object"
}
},
{
"description": "For a screen that was given one session (device_pair_poll answered session): read that session with the pairing id and poll token. Gives the session (name, room code, language, day, place and planned perspectives), the deck as presentations_get_deck gives it, the live position, who holds the remote with the public half of its Ed25519 key (to check the sig_ed of the pointer and drawing commands on the live line; null when nobody holds it), and until when the access holds. Nothing else: no workspace, story or account. Only with POST, as the poll token is the screen's access. Never cached.",
"inputSchema": {
"properties": {
"pairing_id": {
"description": "The pairing's id, from device_pair_start.",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"poll_token": {
"description": "The poll token from device_pair_start: the screen's access.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"pairing_id",
"poll_token"
],
"type": "object"
},
"name": "screen_read_session",
"outputSchema": {
"additionalProperties": {},
"properties": {
"live": {
"anyOf": [
{
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
]
},
"presentation": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"deck": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"deck"
],
"type": "object"
},
{
"type": "null"
}
]
},
"remote": {
"anyOf": [
{
"additionalProperties": {},
"properties": {
"holder": {
"type": "string"
},
"public_key": {
"type": "string"
},
"since": {
"type": "number"
}
},
"required": [
"public_key",
"holder",
"since"
],
"type": "object"
},
{
"type": "null"
}
]
},
"session": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id",
"code"
],
"type": "object"
},
"until": {
"type": "string"
}
},
"required": [
"session",
"until",
"presentation",
"live"
],
"type": "object"
}
},
{
"description": "For a screen that was given one session: set where its room is, as presentations_set_live does for the team, with the pairing id and poll token. The state is a JSON object as the screen keeps it, with `sinds`, when it began, in milliseconds since 1970 (an older one never overwrites a newer, and one more than a minute ahead is refused), at most 20 kB. The phones in the room follow at once.",
"inputSchema": {
"properties": {
"pairing_id": {
"description": "The pairing's id, from device_pair_start.",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"poll_token": {
"description": "The poll token from device_pair_start: the screen's access.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"state": {
"additionalProperties": {},
"description": "The live state, as the presenter's screen keeps it.",
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"pairing_id",
"poll_token",
"state"
],
"type": "object"
},
"name": "screen_set_live",
"outputSchema": {
"additionalProperties": {},
"properties": {
"code": {
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
}
},
{
"description": "Search the words Narrate uses for impact management (begrippen), in Dutch or English. Matches the word, its synonyms and other spellings, its translation, the words it replaces and its definition. Use it before writing about impact, so you use Narrate's words and avoid the ones it replaces. A word that finds nothing is counted, without who looked, so Narrate can add it.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"query": {
"description": "A word or phrase, e.g. 'stakeholder' or 'outtake'. Empty lists every word.",
"maxLength": 200,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_glossary",
"outputSchema": {
"additionalProperties": {},
"properties": {
"terms": {
"items": {
"additionalProperties": {},
"properties": {
"definition": {
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"match": {
"type": "string"
},
"matchedVia": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"id",
"label",
"definition",
"matchedVia",
"match",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"terms"
],
"type": "object"
}
},
{
"description": "The keywords Narrate tags its work with, by group: perspectives, phases, societal issues, sectors, organisational forms, frameworks, technology and product forms. Each keyword links to the page where it lives, to read with read_page.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"query": {
"description": "A word to look for, e.g. 'energie' or 'theory'. Empty lists every keyword.",
"maxLength": 200,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_keywords",
"outputSchema": {
"additionalProperties": {},
"properties": {
"groups": {
"items": {
"additionalProperties": {},
"properties": {
"group": {
"type": "string"
},
"keywords": {
"items": {
"additionalProperties": {},
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"group",
"keywords"
],
"type": "object"
},
"type": "array"
},
"page": {
"type": "string"
}
},
"required": [
"groups",
"page"
],
"type": "object"
}
},
{
"description": "Search the public pages of narrate.works (articles, guides, materials, the glossary) by title, description and full text. Returns paths to read with read_page, with a short fragment where the words occur in the text.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"query": {
"description": "Words to look for in the title, the description or the text.",
"maxLength": 200,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_pages",
"outputSchema": {
"additionalProperties": {},
"properties": {
"pages": {
"items": {
"additionalProperties": {},
"properties": {
"path": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"path",
"title",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"pages"
],
"type": "object"
}
},
{
"description": "Search the sources Narrate cites (reports, laws, standards, books, our own counts) by title, publisher or id. Returns ids to read with get_source. Cite a source by its own title, publisher and URL, not as Narrate's claim. A search that finds nothing is counted, without who looked, so Narrate can add the source.",
"inputSchema": {
"properties": {
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"query": {
"description": "Words to look for in the title or publisher, e.g. 'CSRD' or 'OECD'. Empty lists the most recently consulted.",
"maxLength": 200,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_sources",
"outputSchema": {
"additionalProperties": {},
"properties": {
"sources": {
"items": {
"additionalProperties": {},
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"publisher": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title",
"publisher",
"date",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"sources"
],
"type": "object"
}
},
{
"description": "Starts signing the quote behind the key at Signhost, Narrate's signing service: give the signer's name, job title and e-mail address, and send the person to the url it returns, where they sign themselves. Only while the quote is out for signature and still valid. started is false with a reason: unknown (the key opens nothing), expired, invalid (name or e-mail address) or not_configured. Every start is logged, without the key.",
"inputSchema": {
"properties": {
"email": {
"description": "The signer's e-mail address: Signhost sends the signed quote there.",
"maxLength": 254,
"type": "string"
},
"job_title": {
"description": "The signer's job title.",
"maxLength": 200,
"type": "string"
},
"key": {
"description": "The key from the link (the part after #, 43 characters). It opens this one document only.",
"pattern": "^[A-Za-z0-9_-]{43}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"name": {
"description": "The signer's full name.",
"maxLength": 200,
"type": "string"
}
},
"required": [
"key",
"name",
"email"
],
"type": "object"
},
"name": "start_quote_signing",
"outputSchema": {
"additionalProperties": {},
"properties": {
"reason": {
"enum": [
"unknown",
"expired",
"invalid",
"not_configured"
],
"type": "string"
},
"started": {
"type": "boolean"
},
"url": {
"type": "string"
}
},
"required": [
"started"
],
"type": "object"
}
},
{
"description": "Sends the client's answer to the evaluation behind the key, or changes it, while the moment is open: ratings and texts per question id, and an optional quote with the consent to use it (none, anonymous or name) and the name and job title to go with it. Ask the person for every answer; never fill one in for them. saved is false with a reason: unknown, closed, or missing with the id of the first question that still needs an answer. Every answer is logged, without its content.",
"inputSchema": {
"properties": {
"answer": {
"additionalProperties": {},
"description": "The answer, per question id as get_client_evaluation_form's moment asks it.",
"properties": {
"consent": {
"maxLength": 40,
"type": "string"
},
"job_title": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
]
},
"quote": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
]
},
"ratings": {
"additionalProperties": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"texts": {
"additionalProperties": {
"maxLength": 4000,
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"type": "object"
},
"key": {
"description": "The key from the link (the part after #, 43 characters). It opens this one document only.",
"pattern": "^[A-Za-z0-9_-]{43}$",
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
}
},
"required": [
"key",
"answer"
],
"type": "object"
},
"name": "submit_client_evaluation",
"outputSchema": {
"additionalProperties": {},
"properties": {
"missing": {
"type": "string"
},
"reason": {
"enum": [
"unknown",
"closed",
"missing"
],
"type": "string"
},
"saved": {
"type": "boolean"
}
},
"required": [
"saved"
],
"type": "object"
}
},
{
"description": "Hand in a person's answers to a vraaggesprek by the code in its link (open_interview_link), keyed by question id: a word, a number, or option ids. Only for the person themselves, with their consent: it is what the page behind the link does. Answers to questions it does not have are dropped. complete is false for answers handed in before the end. With the key of a response kept for a reminder (keep_interview_response), it finishes that response and its mail address is wiped. Answers the response's number.",
"inputSchema": {
"properties": {
"answers": {
"additionalProperties": {
"anyOf": [
{
"maxLength": 4000,
"type": "string"
},
{
"type": "number"
},
{
"items": {
"maxLength": 200,
"type": "string"
},
"maxItems": 30,
"type": "array"
},
{
"type": "null"
}
]
},
"description": "The answers by question id.",
"propertyNames": {
"maxLength": 60,
"type": "string"
},
"type": "object"
},
"code": {
"description": "The code in the link, the part after /v/ (narrate.works/v/<code>).",
"pattern": "^[a-z0-9-]{4,40}$",
"type": "string"
},
"complete": {
"default": true,
"type": "boolean"
},
"consent": {
"default": false,
"description": "Whether the person agreed to what the vraaggesprek says it does with the answers.",
"type": "boolean"
},
"key": {
"description": "The key of a kept response: what keep_interview_response answered, or the verder part of the reminder's link.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"code",
"answers"
],
"type": "object"
},
"name": "submit_interview_response",
"outputSchema": {
"additionalProperties": {},
"properties": {
"number": {
"type": "number"
},
"saved": {
"const": true,
"type": "boolean"
}
},
"required": [
"saved",
"number"
],
"type": "object"
}
},
{
"description": "Hand Narrate's team a suggestion without an account: a correction to a page or a glossary word, a missing source, an idea. Say what it is about (subject) and what should change and why (body). Never put personal data in it, such as a name, an email address or a phone number: the suggestion is anonymous and Narrate cannot answer it. The team reads every suggestion; there is no reply through this server.",
"inputSchema": {
"properties": {
"body": {
"description": "What should change, and why.",
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"subject": {
"description": "What it is about, in a few words: a page path, a glossary word, 'the source register'.",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"subject",
"body"
],
"type": "object"
},
"name": "suggest_change",
"outputSchema": {
"additionalProperties": {},
"properties": {
"received": {
"const": true,
"type": "boolean"
}
},
"required": [
"received"
],
"type": "object"
}
},
{
"description": "Narrate's example library: made-up initiatives that explain an idea in the reader's own world. Give an audience group, a societal issue or a NACE section and get the best two to five, the ones the group would run itself first, spread over societal issues. Every example is made up: say so, never present one as a client's work.",
"inputSchema": {
"properties": {
"audience": {
"description": "The audience group, such as sportsClubs or municipalities.",
"enum": [
"socialEnterprises",
"nonprofitLeaders",
"communityOrganisations",
"associations",
"corporateSustainability",
"smeSuppliers",
"smeVoluntaryReporting",
"familyBusinesses",
"founders",
"scaleUps",
"industryChangemakers",
"bCorps",
"regularBusinesses",
"moneyFirstBusinesses",
"investors",
"familyOffices",
"philanthropy",
"foundations",
"governments",
"municipalities",
"provincesRegionalAgencies",
"publicSectorBodies",
"governmentProgrammes",
"publicPrivatePartnerships",
"euFundedProjects",
"industryAssociations",
"thinkTanksPolicyResearchers",
"networksEcosystemBuilders",
"impactConsultancies",
"impactDataSoftware",
"standardSetters",
"universitiesResearch",
"capacityBuildersTrainers",
"incubatorsAccelerators",
"otherProfessionalServices",
"prAgencies",
"marketingAgencies",
"accountancies",
"lawFirms",
"lobbyOrganisations",
"sportsClubs",
"culturalSocieties",
"heritageSocieties",
"otherOrganisations"
],
"type": "string"
},
"challenge": {
"description": "Old name of societal_issue; still read.",
"enum": [
"energietransitie",
"voedseltransitie",
"klimaat",
"circulaire-economie",
"wonen-en-leefomgeving",
"herstel-van-natuur",
"meedoen",
"kansengelijkheid",
"zorg-en-gezondheid"
],
"type": "string"
},
"count": {
"default": 3,
"description": "How many, one to five.",
"maximum": 5,
"minimum": 1,
"type": "integer"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"nace": {
"description": "A NACE Rev. 2.1 section letter, such as Q for education.",
"enum": [
"A",
"B",
"C",
"D",
"E",
"F",
"G",
"H",
"I",
"J",
"K",
"L",
"M",
"N",
"O",
"P",
"Q",
"R",
"S",
"T"
],
"type": "string"
},
"societal_issue": {
"description": "The societal issue, such as energietransitie or kansengelijkheid.",
"enum": [
"energietransitie",
"voedseltransitie",
"klimaat",
"circulaire-economie",
"wonen-en-leefomgeving",
"herstel-van-natuur",
"meedoen",
"kansengelijkheid",
"zorg-en-gezondheid"
],
"type": "string"
}
},
"type": "object"
},
"name": "suggest_examples",
"outputSchema": {
"additionalProperties": {},
"properties": {
"examples": {
"items": {
"additionalProperties": {},
"properties": {
"audiences": {
"items": {
"type": "string"
},
"type": "array"
},
"change": {
"type": "string"
},
"facts": {
"items": {
"additionalProperties": {},
"properties": {
"source": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"text",
"source"
],
"type": "object"
},
"type": "array"
},
"figure": {
"type": "string"
},
"id": {
"type": "string"
},
"madeUp": {
"const": true,
"type": "boolean"
},
"organisation": {
"type": "string"
},
"rightsHolder": {
"type": "string"
},
"situation": {
"type": "string"
},
"tension": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"title",
"organisation",
"situation",
"change",
"rightsHolder",
"figure",
"tension",
"audiences",
"madeUp"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"examples"
],
"type": "object"
}
},
{
"description": "Which of Narrate's terms apply to what an organisation takes from Narrate, as the helper on narrate.works/over/juridisch/voorwaarden (English /about/legal/terms) shows. Call it without documents first: `choices` lists the documents one can choose, each with when it applies. Then pass the slugs that fit and whether Narrate processes personal data for the organisation. `applies` gives the set, each document in the version that applies now, or version null while it is still being prepared.",
"inputSchema": {
"properties": {
"documents": {
"default": [],
"description": "Slugs of the documents chosen, from `choices`.",
"items": {
"maxLength": 60,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"lang": {
"default": "nl",
"description": "Language of the text and the answer: nl (Dutch) or en (British English).",
"enum": [
"nl",
"en"
],
"type": "string"
},
"personal_data": {
"default": false,
"description": "Narrate processes personal data for the organisation.",
"type": "boolean"
}
},
"type": "object"
},
"name": "terms_which_apply",
"outputSchema": {
"additionalProperties": {},
"properties": {
"applies": {
"items": {
"additionalProperties": {},
"properties": {
"applies_when": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"document_url": {
"type": [
"string",
"null"
]
},
"reason": {
"enum": [
"always",
"chosen",
"platform",
"personal_data"
],
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"version": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"title",
"applies_when",
"reason",
"version",
"document_url"
],
"type": "object"
},
"type": "array"
},
"choices": {
"items": {
"additionalProperties": {},
"properties": {
"applies_when": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
},
"slug": {
"type": "string"
},
"title": {
"additionalProperties": {},
"properties": {
"en": {
"type": "string"
},
"nl": {
"type": "string"
}
},
"required": [
"nl",
"en"
],
"type": "object"
}
},
"required": [
"slug",
"title",
"applies_when"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"choices",
"applies"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:66ff2f567a487b6c40526e414c26205a31fb9281996aea3c38741a07673470de | sha256sum