addJuris
MCP
Takaisin etusivulle
English·Suomi
MCP Server Support

MCP-palvelimen rajapinta

Tämä sovellus tarjoaa julkisen, vain lukuoikeudellisen Model Context Protocol -rajapinnan Suomen julkisten hankintojen ratkaisukäytäntöön. Rajapinta on tarkoitettu tekoälyagenttien (esim. ChatGPT, Claude, Cursor) käytettäväksi kontekstilähteenä.

Päätepiste
https://procurement.addjuris.fi/mcp

Streamable HTTP (MCP 2025-06-18)

Käyttöoikeus

Julkinen, ei kirjautumista

Kaikki työkalut ovat vain lukuoikeudellisia (readOnlyHint). Ei kirjoitus- tai muokkausoperaatioita.

Tietolähde

Finlexin avoin data

Markkinaoikeuden (MAO) hankintaratkaisut, hankintalaki (1397/2016) ja hallituksen esitys HE 108/2016 vp.

Saatavilla oleva aineisto

  • Asiasanat (asiasanat / nyckelord) — markkinaoikeuden käyttämä hankinta-alan asiasanasto suomeksi ja ruotsiksi, yhteensä 412 asiasanaa.
  • Hankintalain säännökset — laki julkisista hankinnoista ja käyttöoikeussopimuksista (1397/2016), asiasanoihin sidottuna.
  • Hallituksen esitys — HE 108/2016 vp -perustelut asiasanoittain.
  • Oikeuskäytäntöyhteenvedot — yksi tiivistetty synteesi per asiasana markkinaoikeuden ratkaisulinjoista. Yhteenveto on tällä hetkellä saatavilla 22 asiasanasta (yleisimmät hankintavalitusperusteet). Kukin yhteenveto referoi enintään 15 valittua markkinaoikeuden ratkaisua.
  • MAO-päätöstiivistelmät — yksittäiset markkinaoikeuden hankintaratkaisut metatietoineen ja Finlex-linkkeineen.

Tuetut funktiot (8)

list_keywords
List asiasanat
read-only

Listaa markkinaoikeuden hankintaratkaisujen asiasanat. Voidaan suodattaa alkukirjaimen mukaan ja sivuttaa.

Parametrit

  • startsWithstring (max 3)Alkukirjainsuodatin (case-insensitive).
  • limitinteger 1–500 (default 200)Palautettavien asiasanojen määrä.
  • offsetinteger ≥ 0 (default 0)Sivutusoffset.
search_keywords
Search asiasanat
read-only

Hakusanahaku asiasanojen suomen- ja ruotsinkielisistä nimistä. Palauttaa osumat sluginensa.

Parametrit

  • querystring 1–200requiredHakusana (suomi tai ruotsi).
  • limitinteger 1–50 (default 20)Osumien enimmäismäärä.
get_keyword_law
Get hankintalain säännös
read-only

Palauttaa asiasanaan liittyvän hankintalain säännöksen tekstin.

Parametrit

  • slugstring 1–200requiredAsiasanan slug.
get_keyword_government_proposal
Get hallituksen esitys
read-only

Palauttaa asiasanaan liittyvän hallituksen esityksen tekstin.

Parametrit

  • slugstring 1–200requiredAsiasanan slug.
get_keyword_caselaw_summary
Get oikeuskäytäntö
read-only

Palauttaa asiasanan oikeuskäytäntöyhteenvedon — synteesin markkinaoikeuden ratkaisuista.

Parametrit

  • slugstring 1–200requiredAsiasanan slug.
get_keyword_bundle
Get full keyword bundle
read-only

Palauttaa yhdellä kutsulla kaiken asiasanaan liittyvän: hankintalain säännöksen, hallituksen esityksen, oikeuskäytäntöyhteenvedon sekä markkinaoikeuden päätökset Finlex-linkkeineen.

Parametrit

  • slugstring 1–200requiredAsiasanan slug.
  • decisionsLimitinteger 0–200 (default 50)Päätöslistan maksimimäärä.
list_decisions_by_keyword
List MAO decisions by keyword
read-only

Listaa asiasanaan liittyvät markkinaoikeuden hankintaratkaisut uusimmasta vanhimpaan, Finlex-linkein.

Parametrit

  • slugstring 1–200requiredAsiasanan slug.
  • limitinteger 1–200 (default 100)Palautettavien päätösten määrä.
  • offsetinteger ≥ 0 (default 0)Sivutusoffset.
get_decision
Get MAO decision
read-only

Hakee yksittäisen markkinaoikeuden päätöksen vuoden ja numeron perusteella (esim. MAO 123/2024) metatietoineen, Finlex-linkkeineen ja asiasanoineen.

Parametrit

  • yearinteger 1990–2100requiredPäätöksen vuosi.
  • numberinteger 1–9999requiredPäätöksen järjestysnumero.

Yhteysesimerkki

MCP-yhteensopivat asiakkaat (esim. Claude Desktop, Cursor) voivat lisätä palvelimen konfiguraationsa Streamable HTTP -päätepisteenä:

{
  "mcpServers": {
    "addjuris-procurement": {
      "url": "https://procurement.addjuris.fi/mcp"
    }
  }
}

Lisää palvelin MCP-hakemistoon

Palvelin voidaan listata mcp.so-hakemistoon, joka hyväksyy hostatun päätepisteen ilman GitHub-repoa. Laajempi listaus modelcontextprotocol/servers- tai awesome-mcp-servers-listoille edellyttäisi julkista GitHub-repoa MCP-palvelimen lähdekoodilla. Alla valmis kuvaus, jonka voi liittää mcp.so-lomakkeeseen.

Nimi: addJuris Procurement (Hankintavalitus)

Päätepiste: https://procurement.addjuris.fi/mcp

Kuvaus (EN): Public, read-only MCP server for Finnish public procurement case law — Market Court decisions, Public Procurement Act provisions, government proposal, and per-keyword case-law summaries.

README: /mcp-readme.md

Lisenssi: MIT