# 나라장터 낙찰정보

> 나라장터 낙찰정보 is an open-source MCP server for legal and government. Local MCP server for querying Korean public procurement bid results via data.go.kr. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Repository:** https://github.com/opendata-kr/narajangteo-opening-mcp
- **MCP Registry name:** io.github.opendata-kr/narajangteo-opening
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-18

## About

The README describes a local MCP server that wraps the Narajangteo bid-result information service, the Korean public procurement portal's award and opening data published on data.go.kr. Instead of exposing the raw API operations one by one, it groups them into three tools: two search tools for awards and bid openings, and one lookup tool for a single bid notice with its bidder rankings and reserve price details.

Queries can be run in natural language from an MCP client, and the server runs over stdio via npx. It requires a data.go.kr Decoding service key, and the README stresses that the API must be separately approved for the account before calls succeed. Wide date ranges are split into windows internally, and partial failures are reported rather than silently dropped.

The server suits people who track public tenders, competitor win history, or failed and re-bid notices in Korean government procurement and want to ask an AI assistant about them.

## Features

- **Three consolidated tools:** Award, opening and single-notice operations are merged into two search tools and one detailed lookup.
- **Parallel category search:** Searches construction, services, goods and foreign procurement together when no category is given.
- **Automatic date windowing:** Long date ranges are split into windows and queried in sequence.
- **Partial failure reporting:** Failed windows or categories are returned as errors alongside successful results.
- **Korean error normalization:** data.go.kr result codes such as expired keys or traffic limits are returned as readable Korean messages.
- **Own-company bid flagging:** Given a business registration number, marks the matching bidder rows in a bid result.

## Good for

- Look up who won a specific public tender and at what amount
- Track win history of a competitor by business registration number
- Find failed or re-bid notices in a given region or industry
- Review bidder rankings and reserve price details after a bid closes

## Install

### Claude Code (Terminal)

```sh
claude mcp add narajangteo-opening --env DATA_GO_KR_SERVICE_KEY='<DATA_GO_KR_SERVICE_KEY>' -- npx -y @opendata-kr/narajangteo-opening-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "narajangteo-opening": {
      "command": "npx",
      "args": [
        "-y",
        "@opendata-kr/narajangteo-opening-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "narajangteo-opening": {
      "command": "npx",
      "args": [
        "-y",
        "@opendata-kr/narajangteo-opening-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "narajangteo-opening": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@opendata-kr/narajangteo-opening-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "narajangteo-opening": {
      "command": "npx",
      "args": [
        "-y",
        "@opendata-kr/narajangteo-opening-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "narajangteo-opening": {
      "command": "npx",
      "args": [
        "-y",
        "@opendata-kr/narajangteo-opening-mcp"
      ],
      "env": {
        "DATA_GO_KR_SERVICE_KEY": "<DATA_GO_KR_SERVICE_KEY>"
      }
    }
  }
}
```

## Tools

- `search_awards`: Searches final award winners by keyword, institution, region, industry, price range, business number and date.
- `search_openings`: Searches bid opening results and filters by progress status such as completed, failed or re-bid.
- `get_bid_result`: Retrieves winner, opening progress, reserve price details and bidder rankings for one bid notice number.

## FAQ

### Which key does it need?

It requires the data.go.kr Decoding (original) service key, and the README says the Narajangteo bid-result API must be separately applied for under the same account before it works.

### Does it search for new tender notices?

No. The README says re-announcements are handled by a separate bid notice service, and this server covers award, opening and re-bid results.

### Is it free to use?

The package is MIT licensed and runs locally. Access to the underlying data depends on the data.go.kr key and approval.

### Is 나라장터 낙찰정보 free?

Yes. 나라장터 낙찰정보 is open source, so you can use and self-host it for free.

### How do I add 나라장터 낙찰정보 to Claude Code?

Run this command in your terminal: claude mcp add narajangteo-opening --env DATA_GO_KR_SERVICE_KEY='<DATA_GO_KR_SERVICE_KEY>' -- npx -y @opendata-kr/narajangteo-opening-mcp

### What are the best alternatives to 나라장터 낙찰정보?

The closest alternatives to 나라장터 낙찰정보 are 나라장터 사전규격, 경매레이더 Auction Radar, Prebid (프리비드), Korea Data MCP and Korea Public Data.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [나라장터 사전규격](https://ai-powered.com/mcp/listing-mweooyjy): 나라장터 사전규격 is an open-source MCP server for legal and government.
- [경매레이더 Auction Radar](https://ai-powered.com/mcp/auction-radar): 경매레이더 Auction Radar is an MCP server for legal and government.
- [Prebid (프리비드)](https://ai-powered.com/mcp/prebid): Prebid (프리비드) is a freemium MCP server for legal and government.
- [Korea Data MCP](https://ai-powered.com/mcp/korea-data-mcp): Korea Data MCP is an open-source MCP server for finance and payments.
- [Korea Public Data](https://ai-powered.com/mcp/korea-public-data): Korea Public Data is an open-source MCP server for legal and government.
- [TypeBid 标探](https://ai-powered.com/mcp/typebid): TypeBid 标探 is a paid MCP server for legal and government.
- [pncp.dev](https://ai-powered.com/mcp/pncp-dev): pncp.dev is a freemium MCP server for legal and government.
- [BOIM Korea Vendor Directory](https://ai-powered.com/mcp/boim-korea-vendor-directory): BOIM Korea Vendor Directory is a freemium MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/listing-mweooy7m
