# Aura

> Discovery service for Finland's open data. Aura indexes 13,897 datasets from 46 sources (394 publishers) and fetches rows straight from the publishers' APIs (PxWeb, WFS, OData, CSV, JSON, FMI stored queries). Answers include source URL and licence.

Catalogue metadata is mostly in Finnish; queries in Finnish, Swedish and English work. Areas accept names (inflected Finnish/Swedish), municipality codes (837, KU837), region codes (MK06), postcodes (33100) and abolished municipalities (resolved to the successor).

## MCP

- Endpoint (streamable HTTP, no auth, read-only): https://aura.futuai.fi/mcp
- Publisher quality profile: https://aura.futuai.fi/mcp/laatu
- Claude Code: `claude mcp add --transport http aura https://aura.futuai.fi/mcp`

## Tools (public profile)

1. find_data(query, region, source, format, organization) – start here; returns datasets and, when known, ready-made indicators
2. inspect_dataset(dataset_id) – description, fields, licence, quality, availability, query recipe
3. query_source(dataset_id, filters, area) – rows from the source. PxWeb: call without filters first to get dimension codes; time accepts "uusin" (latest) or "2020-2024"
- area_snapshot(region) – area hierarchy, codes and available data
- find_related(dataset_id) – similar datasets

Every response is structured (outputSchema). Follow `next_actions`; errors carry `error.hint` and `error.suggested_call`. Cite `provenance.source_url` and `license` to the user.

## This instance

Also available here: get_facts(indicator|question, areas, period), time_series(indicator, area) and compare_areas(indicator, areas) for 200+ ready-made indicators, plus search inside table classifications and spatial column names.

## Optional

- Author: Tero Rönkkö (tero@futuai.fi). Public service made possible by Futuai Oy.
- Source code (MIT): https://github.com/trotor/aura. The same harvester + catalogue + MCP structure can be pointed at an organisation's own data sources.
- Human-readable pages: https://aura.futuai.fi/ (fi), https://aura.futuai.fi/en, https://aura.futuai.fi/sv