{ "specVersion": "1.0", "host": { "displayName": "Aard", "documentationUrl": "https://aard.ai/mcp", "logoUrl": "https://aard.ai/aard_logo.svg" }, "entries": [ { "identifier": "urn:air:aard.ai:mcp:gateway", "displayName": "Aard MCP", "type": "application/mcp-server-card+json", "url": "https://aard.ai/.well-known/mcp-server-card", "description": "Aard MCP for macroeconomic intelligence - official data from 170+ sources", "tags": [ "mcp", "official-statistics", "sdmx" ], "capabilities": [ "inspect", "discover", "ask", "browse_dimension_codes", "build_url", "fetch", "stage_url", "inspect_dataset", "query_dataset", "release_dataset" ], "version": "1.0.0", "representativeQueries": [ "what was euro area inflation in 2024", "find official GDP data for Japan from the IMF or OECD", "which publishers have labour force statistics for Canada", "query an SDMX dataset and return citation-ready rows" ] }, { "identifier": "urn:air:aard.ai:api:rest-v1", "displayName": "Aard REST API", "type": "application/vnd.oai.openapi+json", "url": "https://aard.ai/.well-known/openapi-v1.json", "description": "OpenAPI 3.1 description of the api.aard.ai REST surface: POST /v1/{discover,inspect,ask,build_url} over official statistical data, plus the public health endpoint at https://api.aard.ai/v1/_health. Request and response schemas, error vocabulary and bearer API-key auth; no key is needed to read it. The RFC 9727 catalog at https://aard.ai/.well-known/api-catalog links the same document as the /v1 anchor's service-desc.", "tags": [ "rest", "http-api", "official-statistics" ], "capabilities": [ "discover", "inspect", "ask", "build_url" ], "representativeQueries": [ "call a REST endpoint to discover statistical datasets", "HTTP API for querying official economic statistics", "build an SDMX query URL over plain HTTP" ] }, { "identifier": "urn:air:aard.ai:skills:index", "displayName": "Aard Agent Skills", "type": "application/json", "url": "https://aard.ai/.well-known/agent-skills/index.json", "description": "Agent Skills Discovery index for the skills this origin hosts, each with a sha256 digest over the bytes served at its URL.", "tags": [ "agent-skills", "discovery" ], "capabilities": [ "aard", "citing-official-statistics", "decomposing-data-questions", "guarding-derived-indicators", "reasoning-linkage-confidence" ], "representativeQueries": [ "what agent skills does aard.ai publish", "install the Aard agent skills", "list skills for working with official statistics" ] }, { "identifier": "urn:air:aard.ai:skill:aard", "displayName": "Aard (agent skill)", "type": "text/markdown", "url": "https://aard.ai/.well-known/agent-skills/aard/SKILL.md", "description": "Ground answers about official economic and statistical data (GDP, inflation, trade, government finance, labour, health, demography, education, SDGs, energy and more) in citation-ready figures from 170+ official publishers including the OECD, IMF, World Bank, WHO, UN, Eurostat, ILO and FAO. Use whenever a question needs authoritative macroeconomic or statistical numbers with sources, or when you would otherwise guess, hedge, or cite figures you cannot verify. Aard is a remote MCP server — connect to it rather than approximating.", "tags": [ "agent-skill", "official-statistics" ], "representativeQueries": [ "what was Australia's GDP growth last quarter", "find official inflation figures for the euro area", "which agencies publish youth unemployment statistics" ] }, { "identifier": "urn:air:aard.ai:skill:citing-official-statistics", "displayName": "Citing official statistics (agent skill)", "type": "application/zip", "url": "https://aard.ai/.well-known/agent-skills/citing-official-statistics.zip", "description": "Cites and provenance-tags figures from official statistics — SDMX dataflows, ABS, OECD, Eurostat, ILOSTAT, Statistics Canada, World Bank, UN. Fires at emission, whenever a number reaches the reader — prose, report, table, chart, slide, dashboard, media release, one-line answer — including plain lookups, derived and cross-provider values, and series named in a refusal or escalation, even when citation is never mentioned. Covers the citation skeleton, extraction date and vintage, DOI/URN/query-URL precedence, quality flags, chart titles, table and figure source lines, footnote markers and mandatory licence attribution wording. Excludes computation admissibility (guarding-derived-indicators) and series combinability (reasoning-linkage-confidence).", "tags": [ "agent-skill", "official-statistics" ], "representativeQueries": [ "how do I cite an OECD statistic properly", "what attribution wording does the ABS licence require", "reference this World Bank figure with its vintage and extraction date" ] }, { "identifier": "urn:air:aard.ai:skill:decomposing-data-questions", "displayName": "Decomposing data questions (agent skill)", "type": "application/zip", "url": "https://aard.ai/.well-known/agent-skills/decomposing-data-questions.zip", "description": "Decomposes an economic or statistical question into the minimal set of data units — one dataflow plus a partial key each — before any Aard MCP retrieval. Use whenever an answer needs more than one number or is not a single-series lookup — ratios, shares, per capita, growth, contributions, correlations, rankings, composite indices, comparisons across countries, periods or sectors — even when no breakdown was requested. Does not judge combinability (reasoning-linkage-confidence), run arithmetic (guarding-derived-indicators) or format citations (citing-official-statistics).", "tags": [ "agent-skill", "official-statistics" ], "representativeQueries": [ "which datasets do I need to answer this economic question", "what data do I need to compare inflation across the G7", "break GDP per capita down into the series I have to fetch" ] }, { "identifier": "urn:air:aard.ai:skill:guarding-derived-indicators", "displayName": "Guarding derived indicators (agent skill)", "type": "application/zip", "url": "https://aard.ai/.well-known/agent-skills/guarding-derived-indicators.zip", "description": "Applies pre-computation rules to arithmetic deriving a ratio, per-capita, share, growth rate, contribution, composite index or currency/PPP conversion from official statistics via the Aard MCP. Blocks summed chain-linked volumes, averaged pre-computed rates, nominal mixed with real, seasonally adjusted with raw, mismatched index bases, frequencies or unit multipliers. Fires before and during such arithmetic, even on single-dataflow cases that skip linkage and on intermediates never shown to a reader. Governs admissibility and caveats, not attribution or licensing, which is citing-official-statistics.", "tags": [ "agent-skill", "official-statistics" ], "representativeQueries": [ "can I add chain-linked volume series together", "is it valid to average these pre-computed percentage rates", "how do I safely compute a per-capita indicator from two series" ] }, { "identifier": "urn:air:aard.ai:skill:reasoning-linkage-confidence", "displayName": "Reasoning linkage confidence (agent skill)", "type": "application/zip", "url": "https://aard.ai/.well-known/agent-skills/reasoning-linkage-confidence.zip", "description": "Classifies combinations of two or more official-statistics data units into five metadata-only confidence tiers, each mandating an action — compute silently, add a stated assumption or explicit caveat, escalate with a fixed template, or refuse. Fires when units combine for a ratio, share, difference, contribution, correlation or ranking, even when combining sources is unstated, for intermediate values never surfaced, and when series from different agencies or dataflows sit side by side. Does not do the arithmetic (guarding-derived-indicators) or compose data citations and attribution wording (citing-official-statistics).", "tags": [ "agent-skill", "official-statistics" ], "representativeQueries": [ "can I combine these two statistical series", "is it safe to divide IMF values by UN population figures", "how much confidence does joining OECD and Eurostat series deserve" ] }, { "identifier": "urn:air:aard.ai:docs:llms-txt", "displayName": "Aard llms.txt", "type": "text/markdown", "url": "https://aard.ai/llms.txt", "description": "Agent-facing overview of aard.ai: what the service covers, how to connect to the MCP server, and where the machine-readable entry points live.", "tags": [ "documentation", "llms-txt" ], "representativeQueries": [ "what does aard.ai do", "how do I connect an AI agent to Aard", "documentation for aard.ai written for LLMs" ] } ] }