Kofa

The KOFA MCP server is used to access Norwegian public procurement decision data and supports data synchronization and HTTP services

Law and compliance Research and data #Norwegian Procurement #Data Synchronization #MCP Service .Python

rating : 2 points

downloads : 6.2K

update time : 2026-03-12

Open Site

What is the KOFA MCP Server?

The KOFA MCP server is a specialized data interface that connects to the official database of the Norwegian Public Procurement Board (Klagenemnda for offentlige anskaffelser, KOFA). This board is responsible for handling complaints and appeals related to public procurement. This server transforms these complex legal decision data into a format that is easy to query and analyze, allowing you to obtain key procurement case information without directly accessing the original database or understanding complex legal terms.

How to use the KOFA MCP Server?

The usage process is divided into two main stages: First, you need to synchronize data from KOFA to a local or cloud database through simple commands; then, you can start the server and query this data through the standard MCP protocol (or HTTP interface). The entire process is completed through command-line tools and is easy to configure.

Applicable scenarios

This tool is very suitable for scenarios that require researching the Norwegian public procurement market, analyzing tender disputes, tracking the case history of specific suppliers or procurement agencies, conducting legal or academic research, and any scenario that requires analysis based on actual procurement decision data.

Main Features

Data Synchronization and Scraping

You can obtain the latest procurement decision cases from the official KOFA source through the simple `kofa sync` command. Using the `--scrape` option can further obtain more detailed HTML metadata to make the case information more complete.

MCP Protocol Server

It runs as a standard MCP server and can be seamlessly integrated with AI assistants that support the MCP protocol (such as Claude Desktop), allowing you to directly query procurement data in natural language.

HTTP Interface

In addition to the MCP protocol, an optional HTTP server mode (`--http`) is also provided, which facilitates access and query through web browsers or other HTTP clients, increasing the flexibility of use.

Cloud Data Storage

It supports storing synchronized data in Supabase (a cloud database service), which is convenient for team collaboration, data persistence, and access from different devices. You only need to configure environment variables to enable it.

Status Check

You can quickly view the statistical information of data synchronization, such as the number of synchronized cases, by using the `kofa status` command to help you understand the data status.

Advantages

**Authoritative Data**: Directly connected to the Norwegian official procurement decision database, the information is accurate and reliable.

**Easy to Use**: Transforms the complex legal database into an interface that can be queried through simple commands and natural language.

**Flexible Integration**: Supports both the MCP protocol and HTTP, and can be easily integrated with AI assistants or custom applications.

**Data Portability**: Supports local and cloud (Supabase) storage to adapt to different usage scenarios.

**Open Source and Transparent**: Developed based on Python, the code can be reviewed and the functions can be extended.

Limitations

**Region-Specific**: Only covers Norwegian public procurement cases and is not applicable to other countries or regions.

**Requires Initialization**: You must perform the data synchronization step before use and cannot obtain the latest data in real-time (unless manually updated).

**Depends on External Services**: If you use Supabase cloud storage, you need to register and configure this service additionally.

**Technical Threshold**: Basic command-line operation knowledge is required for initial installation and configuration.

How to Use

Installation

Open the terminal (command-line tool) on your computer and use Python's package management tool pip for installation.

Environment Configuration (Optional)

If you want to store data in the cloud Supabase database, you need to copy the environment configuration file and fill in your Supabase service address and key.

Synchronize Data

Run the synchronization command to download KOFA's case data. It is recommended to use the `--scrape` parameter for the first time to obtain more detailed information.

Start the Server

After the data synchronization is completed, start the MCP server. You can start a pure MCP protocol server or start a server with an HTTP interface for browser access.

Start Querying

After the server is started, you can start querying. If you use the HTTP mode, open your browser and access the server address (usually http://localhost:8080). If integrated with an AI assistant, you can directly ask questions in natural language.

Usage Cases

Market Research: Analyze IT Service Procurement Trends

A software company wants to know what disputes often occur when Norwegian governments at all levels procure IT services in the past two years to evaluate market risks and opportunities.

Supplier Due Diligence

A Norwegian company wants to confirm whether a new subcontractor has been involved in any public procurement violations or complaint cases before cooperating with it.

Legal and Academic Research

A law student is writing a paper on 'The Legality of Emergency Contract Awards in Norwegian Public Procurement' and needs to find relevant actual cases as support.