# addJuris Procurement MCP Server

Public, read-only [Model Context Protocol](https://modelcontextprotocol.io/) server
for Finnish public procurement (julkinen hankinta) case law from the Market Court
(markkinaoikeus).

- **Endpoint:** `https://procurement.addjuris.fi/mcp`
- **Transport:** Streamable HTTP (MCP spec 2025-06-18)
- **Auth:** None — public, read-only
- **Documentation:** https://procurement.addjuris.fi/mcp-info
- **License:** MIT
- **Maintainer:** Markus Oksanen <oksanen.markus@gmail.com>

## What it exposes

- **Asiasanat / nyckelord** — the Market Court's procurement keyword vocabulary
  (Finnish + Swedish), 412 keywords.
- **Hankintalain säännökset** — provisions of the Public Procurement Act
  (1397/2016) linked per keyword.
- **Hallituksen esitys** — HE 108/2016 vp reasoning per keyword.
- **Oikeuskäytäntöyhteenvedot** — one synthesised case-law summary per keyword
  (currently 22 keywords, each referencing up to 15 selected MAO decisions).
- **MAO decisions** — individual Market Court procurement rulings with Finlex
  links and metadata.

Source data: Finlex open data.

## Tools (8)

All tools are read-only (`readOnlyHint: true`).

| Tool | Description |
|------|-------------|
| `list_keywords` | List procurement keywords (initial-letter filter, pagination). |
| `search_keywords` | Full-text search over Finnish/Swedish keyword labels. |
| `get_keyword_law` | Return the Public Procurement Act provision for a keyword. |
| `get_keyword_government_proposal` | Return the government proposal text for a keyword. |
| `get_keyword_caselaw_summary` | Return the case-law summary for a keyword. |
| `get_keyword_bundle` | Return law + HE + case-law summary + MAO decisions in one call. |
| `list_decisions_by_keyword` | List MAO decisions linked to a keyword (newest first). |
| `get_decision` | Fetch one MAO decision by year and number. |

Full parameter schemas: https://procurement.addjuris.fi/mcp-info

## Client configuration

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

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

## License

MIT © Markus Oksanen