addJuris
MCP
Back to home
English·Suomi
MCP Server Support

MCP server interface

This application exposes a public, read-only Model Context Protocol interface to Finnish public procurement case law. It is designed to be used as a context source by AI agents (e.g. ChatGPT, Claude, Cursor).

Endpoint
https://procurement.addjuris.fi/mcp

Streamable HTTP (MCP 2025-06-18)

Access

Public, no authentication

All tools are read-only (readOnlyHint). No write or mutation operations.

Data source

Finlex open data

Market Court (MAO) procurement decisions, the Public Procurement Act (1397/2016) and the government proposal HE 108/2016 vp.

Available data

  • Keywords (asiasanat / nyckelord) — the Market Court procurement keyword vocabulary in Finnish and Swedish, totalling 412 keywords.
  • Public Procurement Act provisions — the Act on Public Procurement and Concession Contracts (1397/2016), linked per keyword.
  • Government proposal — HE 108/2016 vp reasoning per keyword.
  • Case-law summaries — one synthesised summary per keyword of Market Court decision lines. Summaries are currently available for 22 keywords (the most common grounds for procurement appeals). Each summary references up to 15 selected Market Court decisions.
  • MAO decision summaries — individual Market Court procurement rulings with metadata and Finlex links.

Supported tools (8)

list_keywords
List keywords
read-only

List Market Court procurement keywords. Supports initial-letter filtering and pagination.

Parameters

  • startsWithstring (max 3)Initial-letter filter (case-insensitive).
  • limitinteger 1–500 (default 200)Maximum number of keywords to return.
  • offsetinteger ≥ 0 (default 0)Pagination offset.
search_keywords
Search keywords
read-only

Full-text search over the Finnish and Swedish labels of the keywords. Returns matches with their slug.

Parameters

  • querystring 1–200requiredSearch term (Finnish or Swedish).
  • limitinteger 1–50 (default 20)Maximum number of matches.
get_keyword_law
Get Public Procurement Act provision
read-only

Return the Public Procurement Act (1397/2016) provision associated with a keyword.

Parameters

  • slugstring 1–200requiredKeyword slug.
get_keyword_government_proposal
Get government proposal
read-only

Return the government proposal (HE 108/2016 vp) reasoning associated with a keyword.

Parameters

  • slugstring 1–200requiredKeyword slug.
get_keyword_caselaw_summary
Get case-law summary
read-only

Return the case-law summary for a keyword — a synthesis of Market Court decisions.

Parameters

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

Return everything associated with a keyword in one call: the Public Procurement Act provision, the government proposal reasoning, the case-law summary and the Market Court decisions with Finlex links.

Parameters

  • slugstring 1–200requiredKeyword slug.
  • decisionsLimitinteger 0–200 (default 50)Maximum number of decisions to include.
list_decisions_by_keyword
List MAO decisions by keyword
read-only

List Market Court procurement decisions linked to a keyword, newest first, with Finlex links.

Parameters

  • slugstring 1–200requiredKeyword slug.
  • limitinteger 1–200 (default 100)Maximum number of decisions to return.
  • offsetinteger ≥ 0 (default 0)Pagination offset.
get_decision
Get MAO decision
read-only

Fetch a single Market Court decision by year and number (e.g. MAO 123/2024) with metadata, Finlex link and associated keywords.

Parameters

  • yearinteger 1990–2100requiredDecision year.
  • numberinteger 1–9999requiredDecision sequence number.

Client configuration

MCP-compatible clients (e.g. Claude Desktop, Cursor) can add the server as a Streamable HTTP endpoint:

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

List server in an MCP directory

The server can be listed on mcp.so, which accepts a hosted endpoint without a GitHub repository. Broader listings on modelcontextprotocol/servers or awesome-mcp-servers would require a public GitHub repository containing the MCP server source. Below is a ready-made description that can be pasted into the mcp.so form.

Name: addJuris Procurement (Hankintavalitus)

Endpoint: https://procurement.addjuris.fi/mcp

Description: 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

License: MIT