MCP documentation

Suomi-MCP is a read-only Model Context Protocol server for discovering official Finnish statistics, inspecting source schemas, retrieving bounded PxWeb data, and calculating from retrieved evidence.

Suomi-MCP on vain luku -tilastopalvelin, jolla voi etsiä virallisia suomalaisia tilastoja, tarkastella lähdetaulukoiden rakennetta, hakea rajattuja PxWeb-tietoja ja laskea haetuista havainnoista.

Endpoint and authentication

Use the Streamable HTTP endpoint https://agentfinland.fi/mcp. Sign in with OAuth, or use an API key for clients that need static credentials. Keep API keys private.

Käytä Streamable HTTP -osoitetta https://agentfinland.fi/mcp. Kirjaudu OAuth-valtuutuksella tai käytä pysyvää tunnistetta tarvitsevan asiakkaan kanssa API-avainta. Säilytä avain salassa.

Tool workflow

  1. Record the requested measure, geography, population, period, and operation in a structured plan.
  2. Search candidate sources and inspect the selected table's live dimensions and values.
  3. Retrieve selected schema values; results retain source provenance.
  4. Use evidence-linked calculations and claims when deriving an answer.

The model selects statistical meaning from the question and returned source schemas. The server checks schema membership, response structure, calculation safety, and evidence provenance.

Malli valitsee tilastollisen sisällön kysymyksen ja lähteen palauttaman rakenteen perusteella. Palvelin tarkistaa tunnisteiden kelpoisuuden, vastauksen rakenteen, laskennan turvallisuuden ja lähteiden jäljitettävyyden.

Sources and licensing

Statistics come from official publishers, including Statistics Finland. Follow the citation and licence shown with each result. Suomi-MCP is independent and is not operated by Statistics Finland.

Browse available sources

Setup guides

Choose a client-specific setup guide on the connection page.

Frequently asked questions

What is Suomi-MCP?

Suomi-MCP is a read-only Model Context Protocol server that helps AI assistants find, inspect, and retrieve official Finnish statistics.

Mikä Suomi-MCP on? Suomi-MCP on vain luku -käyttöliittymä MCP-palvelin, jonka avulla tekoälyavustaja voi etsiä, tarkastella ja hakea virallisia suomalaisia tilastoja.

Where do the figures come from?

The service retrieves data from official statistical publishers, including Statistics Finland. Each answer includes source links and retrieval details when available.

Mistä luvut ovat peräisin? Palvelu hakee tiedot virallisilta tilastontuottajilta, kuten Tilastokeskukselta. Vastauksissa näytetään lähdelinkit ja hakutiedot, kun ne ovat saatavilla.

Can Suomi-MCP change or submit data?

No. The MCP tools are read-only. They search public sources, retrieve selected values, and calculate from retrieved evidence.

Voiko Suomi-MCP muuttaa tai lähettää tietoja? Ei. MCP-työkalut ovat vain luku -työkaluja. Ne etsivät julkisia lähteitä, hakevat valittuja arvoja ja tekevät laskelmia haetusta aineistosta.

What if a source cannot answer the whole question?

The assistant should state which requested scope is missing or only partly covered and explain the limitation using the retrieved evidence.

Entä jos lähde ei vastaa koko kysymykseen? Avustajan tulee kertoa, mikä pyydetty rajaus puuttuu tai katetaan vain osittain, ja kuvata rajoite haetun aineiston perusteella.