나라장터 입찰 MCP

io.github.donghyeon01Published by GitHub account donghyeon01v0.1.0Updated Oct 24, 2026

나라장터 입찰공고·사전규격·낙찰정보 검색. Korean public procurement bids via KONEPS open API.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for searching Korean public procurement (Narajangteo/KONEPS) bid notices, pre-specifications and award history, with optional email alerts.

What you can do
Search bid notices by keyword, period, business type, region and estimated price, with deadline and original link returned per notice. Retrieve a notice's detail: eligibility, schedule, base and estimated amounts, contract method, attachments and change history. Search pre-specifications published before a formal notice to find opportunities early. Aggregate past award results by agency, keyword and business type, including award-rate distribution and frequent winners. Manage alert conditions that are matched daily and emailed.
When to use it
Useful when you want an assistant to look up Korean public tenders, check eligibility and deadlines for a specific notice, or track award patterns and new matching notices without browsing the procurement portal by hand.
Requirements
A remote Streamable HTTP endpoint; no installation or API key needed for the free tools. Pro tools and higher limits require a license key sent as an Authorization Bearer header. Network access to the endpoint is required.
Before you install
Free tools are limited to 30 calls per day per IP; Pro features require a paid license key, which is a secret to keep private. Alert conditions store an email address and cause daily emails to be sent. Data comes from the public procurement open API and is collected hourly, so very recent notices may be missing.

Installation

In SourceWeft

  1. Open 나라장터 입찰 MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.donghyeon01%2Fkr-public-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "io-github-donghyeon01-kr-public-yhjd": {
      "type": "http",
      "url": "https://kr-public-mcp.songdonghyeon01.workers.dev/mcp"
    }
  }
}

README

kr-public-mcp — 나라장터 입찰공고 MCP 서버

[MCP] [Cloudflare Workers] [TypeScript] [License: MIT]

Claude·ChatGPT·Cursor에서 나라장터(조달청) 입찰공고를 검색하고 상세를 조회하는 원격 MCP 서버. 설치·인증키 없이 URL만 붙이면 동작한다 (Streamable HTTP).

  • 엔드포인트: https://kr-public-mcp.songdonghyeon01.workers.dev/mcp
  • 데이터: 조달청 나라장터 공공데이터포털 오픈API (입찰공고·사전규격·낙찰정보)
  • 모든 응답에 출처와 나라장터 원문 링크를 포함한다

도구

도구등급설명
search_bids무료입찰공고 검색 — 키워드·기간·업무구분(공사/용역/물품/외자)·지역·추정가 범위
get_bid_detail무료공고 상세 — 자격요건(면허·참가지역), 일정, 기초금액·추정가, 첨부 링크, 변경 이력
search_pre_specsPro사전규격 검색 — 본공고 전 단계 조기 발굴
analyze_historyPro낙찰 이력 집계 — 낙찰률 분포·다빈도 업체·평균 참가수
watch_bidsPro알림 조건 저장 → 매일 08:00 KST 이메일 매칭 + 마감 임박 알림

무료 도구는 IP 기준 일 30회. Pro는 라이선스 키(크몽 이용권)로 한도 해제 + Pro 도구 개방.

연결

bash
# Claude Codeclaude mcp add --transport http narajangteo https://kr-public-mcp.songdonghyeon01.workers.dev/mcp
jsonc
// 일반 MCP 클라이언트 설정{  "mcpServers": {    "narajangteo": {      "url": "https://kr-public-mcp.songdonghyeon01.workers.dev/mcp",    },  },}

Pro 키 사용 시 헤더: Authorization: Bearer <라이선스 키>.

사용 예시

text
사용자: 이번 주 마감하는 서울 지역 용역 입찰공고 찾아줘→ search_bids(keyword="", region="서울", category="용역", deadline="...") 호출→ 공고명·마감일·추정가·나라장터 원문 링크 목록 응답
사용자: 0012345678 공고의 참가자격 알려줘→ get_bid_detail(bidNo="0012345678") 호출→ 면허·지역 제한, 입찰 일정, 기초금액, 첨부 링크 응답

아키텍처

Cloudflare Workers (stateless createMcpHandler) + D1 + KV + Cron. 수집(Cron → 조달청 API → D1)과 조회(MCP → D1)를 분리해 API 호출 수를 사용자 수와 무관하게 유지 (서버비 ≈ 0 설계). 공무원 성명·연락처는 응답에서 제거하고 저장하지 않는다.

개발

bash
npm installnpm run db:migrate:local && npm run devnpm run typecheck

셋업·배포·운영 규칙: AGENTS.md 참조.

라이선스

MIT. 데이터 출처: 조달청 나라장터 (공공데이터포털 오픈API).

Source: README.md at commit 5b86cc7

Tools

5

search_bids

나라장터 입찰공고를 검색한다. 공고명·기관 키워드, 기간, 업무구분(공사/용역/물품/외자), 지역, 추정가격 범위로 필터링. 수집된 공고만 검색된다(수집은 매시간). 반환: 공고번호, 공고명, 수요기관, 추정가격, 입찰마감일시, D-day, 원문 링크.

Parameterslimitregionkeywordto_datecategoryfrom_datemax_pricemin_price

get_bid_detail

입찰공고 상세 조회. 자격요건(면허·참가가능지역), 일정(공고·개찰·마감), 기초금액·추정가격, 계약방법, 첨부파일 링크, 변경 이력을 반환한다. search_bids 결과의 공고번호를 넣으면 된다.

Parametersbid_norequiredbid_seq

search_pre_specs

나라장터 사전규격(발주 전 규격 공개)을 검색한다. 본공고 전 단계라 조기 발굴에 유용하다. 반환: 사전규격등록번호, 품명, 수요기관, 배정예산, 의견 마감일, 연결된 본공고 번호. Pro 전용.

Parametersagencykeywordto_datecategoryfrom_date

analyze_history

과거 낙찰 결과를 기관·키워드·업무구분으로 집계한다. 낙찰률 분포(최소·평균·최대), 다빈도 낙찰업체, 평균 참가업체 수, 최근 낙찰 목록을 반환한다. Pro 전용.

Parametersagencymonthskeywordcategory

watch_bids

입찰 알림 조건을 관리한다. add로 조건+이메일 저장, list로 조건 확인, remove로 삭제, matches로 최근 매칭 공고 조회. 저장된 조건은 매일 08:00 KST에 신규 공고와 매칭해 이메일로 보낸다. Pro 전용.

Parametersemaillabelactionrequiredregionkeywordcategorywatch_idmax_pricemin_price

Version history

1
  1. v0.1.0LatestSep 23, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts