contract-compass MCP server
app.sallim · Updated
Korean public procurement law: rule-engine rulings, statutes search, live court precedents
At a glance
contract-compass is an MCP server in the Legal & Government category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 11 tools, including decide_contract_method, search_law and search_references. It scores B (71/100) on the MCP Skills Hub health score as of Oct 28, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install contract-compass in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install contract-compass in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add --transport http contract-compass https://contract.sallim.app/mcp?via=officialVerify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. decide_contract_method, search_law, search_references). It discovers them automatically.
How to install contract-compass in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "contract-compass": { "command": "npx", "args": [ "-y", "mcp-remote", "https://contract.sallim.app/mcp?via=official" ] } } }Why the wrapper?
This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install contract-compass in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "contract-compass": { "url": "https://contract.sallim.app/mcp?via=official" } } }Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install contract-compass in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.contract-compass] command = "npx" args = ["-y", "mcp-remote", "https://contract.sallim.app/mcp?via=official"]Why the wrapper?
Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install contract-compass in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "contract-compass": { "serverUrl": "https://contract.sallim.app/mcp?via=official" } } }Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install contract-compass in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "contract-compass": { "type": "streamableHttp", "url": "https://contract.sallim.app/mcp?via=official" } } }
How to install contract-compass in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "contract-compass": { "type": "http", "url": "https://contract.sallim.app/mcp?via=official" } } }Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What tools does contract-compass expose? (11)
Read from the live server. Click any tool for its input schema.
- decide_contract_method계약방법 결정론 판정 — 룰엔진이 적용 가능한 계약방법 후보와 법령 근거를 반환. 상대방 지위(소기업·여성기업 등)를 안 넣었는데 그 지위로만 열리는 수의 후보가 있으면 `vendor_conditional_candidates`로 따로 온다 — 지위를 추정하지 말고 사용자에게 확인하라. `law_currency`는 이 판정이 기대는 법령(공기업이면 계약사무규칙 포함 — `laws_checked`)의 현행 여부다(2026-10-15). `status`가 "verified"가 아니면 `note_currency`와 `laws_not_verified`가 온다 — 그 규범을 현행으로 단정해 인용하지 말고 그 사실을 밝혀라. Args: contract_type: "construction"(공사) | "service"(용
- search_law법령 조문 검색 — 키워드 또는 조문번호로 조문 스니펫 반환(상위 top_k건). **코퍼스가 둘이고 한 응답은 한 쪽에서만 온다(2026-08-29).** 공공계약(국가·지방계약법 계열 38개 법령)과 **세법**(소득세법·법인세법·부가가치세법·조세특례제한법·지방세법 등 64개 법령)이다. 축은 자동으로 정해진다 — 질의가 세법 법령을 이름으로 부르면 세법 코퍼스로 간다. 법령명이 없어도 세법 고유 개념이면 세법 축에서 찾고, 공공계약 고유 업무를 명시하면 계약 축을 유지한다. 그 밖에는 공공계약 결과가 없거나 의미검색· 주제 밖 낱말 매치뿐일 때 두 축 거리를 비교한다. 이름으로 부른 시행령/시행규칙은 그 하위법령으로 검색을 제한한다(모법 이름만 부르면 기존 검색 유지). `corpus="tax"`/`"
- search_references공공계약 코퍼스 통합 검색 — 법령+계약예규+조달청·행안부 세부기준+실무가이드. LLM 미사용. search_law가 법령 조문 전용인 것과 달리 예규·적격심사 세부기준·실무가이드까지 검색한다. 낙찰하한율·적격심사 배점·실무 절차 등 법령 본문 밖 질문에 사용하라. AI 생성 없이 검색 근거 원문만 반환한다(백엔드 LLM 예산 미차감). **세법은 이 도구가 못 본다(2026-08-29 정직 공시).** 세법 조문은 별도 코퍼스 (`tax_articles` 64개 법령)에 있고 여기 붙어 있는 채널(BM25·doc2query·rerank)은 공공계약 코퍼스 것이다. 소득세법·법인세법·부가가치세법류 질문은 **search_law** (자동으로 세법 축으로 간다) 또는 get_law_article로 가라 — 여
- search_cases판례·법령해석례 검색 — law.go.kr 실시간 조회(항상 현행). LLM 미사용. 분쟁·처분취소·해석 다툼("~해도 되나", "~취소될 수 있나")에 조문만으로 부족할 때 쓰라. 본문은 get_case(kind, case_id)로 이어서 조회. **응답은 무엇으로 몇 건을 봤는지까지 말한다**(2026-08-29). `search_scope`가 "title"이면 사건명·안건명만, "body"면 본문까지 본 것이다. `searched`에 시도한 질의·범위·law.go.kr 총계(`total_cnt`)가 시도 순서대로 실리고, 넓혀서 다시 찾았으면 `retried`가 true다. **0건은 "그런 판례가 없다"가 아니라 "이 범위에서 못 찾았다"이다** — 사용자에게 옮길 때 `searched`가 밝힌 범위
- get_case판례/해석례 본문 조회 — 판시사항·판결요지·참조조문(판례) 또는 질의요지·회답·이유(해석례). 응답의 `source_url`은 국가법령정보센터 원문 주소다 — 판례·해석례를 인용할 때는 **이 링크를 함께 제시하라**(감사·보고서에서 근거를 되짚을 수 있어야 한다). **`error:"case_body_unavailable"`이면 `source_url`은 null이고 `existence_verified`는 false다**(2026-09-04). 이건 "본문만 없다"가 아니다 — 우리는 ①본문 미제공(하급심· 국세청 등 타기관 제공)과 ②그런 일련번호가 없음을 **구분하지 못한다**(본문 API 응답이 같다). 그러니 **링크를 만들어 채우지 마라**: law.go.kr 뷰어는 없는 번호에도 200과 빈 페
- get_law_article법령 조문 원문 조회 — 6,000자를 넘으면 잘라서 주고 `truncated`로 공시한다. **긴 조문은 잘린다(2026-10-15).** 원문이 6,000자를 넘으면 `truncated: true`와 `content_total_chars`(원문 총 글자수)·`content_shown_chars`·`paragraphs_shown`· `paragraphs_omitted`·`paragraph_cut`·`truncation_note`가 온다. 그때 content는 조문 전체가 아니다 — 생략된 항을 "없다"고 말하지 말고, ref에 항을 붙여(예: "소득세법 시행령 제155조제20항") 다시 부르면 그 항부터 창을 열어 준다(`requested_paragraph`). ref에 호를 붙이면(예: "…제26조제1항
- get_law_article_asof**특정 시점에 시행 중이던** 조문 원문 조회 (law.go.kr 연혁 라이브). get_law_article은 항상 현행이다. 과거 사건에 현행 조문을 적용하면 조용히 틀린 답이 된다 — 계약 체결·입찰공고·처분 시점이 과거이면 **반드시 이 도구를 쓰라**: - "2023년에 체결한 계약인데 지체상금률이 맞나" - "재작년 부정당업자 제재가 당시 기준으로 적법했나" - 감사·분쟁·소송 대응(적용법령은 행위시법이 원칙) 응답 필드: effective_date 그 시점에 시행 중이던 판의 시행일자 is_current 그 판이 지금도 현행인가 (False면 이후 개정됨) prev/next_effective_date 직전·직후 개정 시행일 — 경계 판단용 notes 미정비 상호인용 경고 (get_law_art
- estimate_delay_penalty지체상금(국가·공기업)·지연배상금(지방) 산정 — 법정 요율·기준금액·30% 한도를 결정론 적용. **국가와 지방은 요율이 다르다**(물품 0.75/1000 ↔ 0.8/1000, 용역 1.25/1000 ↔ 1.3/1000) — org_type을 반드시 사용자에게 확인해서 넣어라. 법정 용어도 다르다(국가=지체상금, 지방=지연배상금). **이 도구는 지체일수를 정하지 않는다.** 준공검사 소요기간·검사 불합격 재검사 기간· 발주기관 귀책 일수 같은 것은 사실 판단이다 — delay_days/excluded_days는 사용자가 선언한 값으로 계산에 그대로 쓰이고, 응답의 counted_days.disclaimer가 이 사실을 밝힌다. 면책 사유 해당 여부가 쟁점이면 search_references로 예규·감사원
- delay_exemption_guide지체일수에서 **빼는(불산입) 사유** 지도 — estimate_delay_penalty가 정하지 않는 부분. "이 지연은 우리 책임이 아닌데 지체상금을 물어야 하나", "동절기 공사중지 기간도 지체일수인가", "관급자재가 늦게 와서 늦어졌다" 같은 질문에 쓰라. **이 도구는 해당 여부를 판정하지 않는다.** 일반조건 문언 자체가 "계약담당공무원이 인정할 때"를 요건으로 두므로 판단은 발주기관 몫이다. 도구가 주는 것은 셋이다 — ①예규에 있는 사유 목록과 원문 인용 ②각 사유가 인정되려면 **확정돼야 할 사실** (must_establish — 사용자와 하나씩 확인하라) ③기재부·행안부 회신 선례. 쓰는 순서: 이 도구로 사유를 좁힌다 → must_establish를 사용자와 확인한다 → 불산입 일수가
- check_price_adjustment물가변동 계약금액 조정(에스컬레이션) 요건 판정 + 산식 적용 — 이행단계 Phase 3. "자재값이 올랐는데 계약금액을 올려받을 수 있나", "90일 지났나", "단품 조정 되나"에 쓰라. **이 도구는 조정률을 산정하지 못한다.** 품목조정률·지수조정률은 산출내역서와 지수·단가 원천(한국은행 생산자물가지수 등)으로 계산하는 값인데 이 서버는 그 데이터를 갖고 있지 않다 — 그러니 `adjustment_rate_pct`는 **사용자·발주기관이 산정한 값**을 받아 쓰고, 안 주면 요건 ②를 `met: null`로 두고 판정을 보류한다. 없는 값을 지어내지 마라. 판정하는 것(결정론): ①기간 요건(계약체결일 또는 직전 조정기준일부터 90일 이상) ②등락률 3% 문턱 ③**단품 조정 문턱 — 국가·공기업 1
- report_issue사용자가 **오류 제보나 개선 요청을 운영자에게 전해 달라고 했을 때만** 쓴다. 쓰는 때: 사용자가 "이 조문 인용이 틀렸으니 신고해 줘", "운영자에게 알려 줘", "이런 질문도 답하게 해 달라고 전해 줘"처럼 제보·요청을 부탁했을 때. 보내기 전에 무엇이 전달되는지 사용자에게 알린다. 쓰지 않는 때: 사용자가 요청하지 않았는데 질문을 남기려고 부르지 않는다. 답하기 전에 먼저 부르지도 않는다 — 이 도구는 답변·정정을 대신하지 않는다. 전달 내용(인자)과 같은 사용자의 직전 도구 호출 요약(서버 기록)이 운영자 검토용으로 저장된다(개인정보처리방침 https://contract.sallim.app/privacy). 개인 식별 정보(기관명· 사건번호·금액 조합 등)는 일반형으로 바꿔 적는다. Args: c
What the code can do
This is a remote server — nothing is installed or run on your machine, so there is no local code to analyze. What it can reach is described above: your requests go to the provider's host.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Third-party hosted service — Your requests and any data in them are sent to contract.sallim.app.
- No local execution — Nothing is installed or run on your machine.
- Last commit 2 months ago — Actively maintained.
- 0 GitHub stars — Very little community usage so far.
Client compatibility
Health score
B · 71Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%94%
Last commit 72 days ago.
- Adoption20%0%
0 stars.
- Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
- Provenance15%75%
Links to its own repository; package linkage unverified.
- Packaging15%75%
Remote endpoint; authentication requirements not declared.
Documentation
Full README계약나침반 🧭 (Contract Compass)
Korean public procurement law MCP server & web service — a deterministic rule engine for contract-method decisions (94 rules encoded directly from statutes), a searchable corpus of Korean procurement statutes/regulations/adjudication tables, and live court precedents & authoritative interpretations from law.go.kr. All MCP tools are LLM-free: your AI client does the reasoning, this server provides verifiable legal grounds. Remote endpoint: https://contract.sallim.app/mcp
공공계약 방법 결정 도우미 — 국가계약법·지방계약법 등 공공계약 법령을 기반으로, 발주하려는 계약(공사·용역·물품)에 적용 가능한 계약방법(입찰·수의계약·제한경쟁 등)과 법령 근거를 결정론적으로 안내하는 오픈소스 웹서비스 + MCP 서버입니다.
- 결정 위저드: 계약유형·추정가격·조건을 입력하면 룰엔진(법령 직접 인코딩 94룰)이
적용 가능한 계약방법·낙찰자 결정방법·적격심사 기준을 후보와 근거 조문과 함께 제시
- 법령 챗봇(Ask): 국가계약법령·계약예규·감사원 공공계약 실무가이드 등 공개 코퍼스
기반 RAG 검색 + 인용 답변 (웹 UI 전용)
- MCP 서버(무LLM): Claude·ChatGPT·Cursor 등 AI 에이전트가 룰엔진 판정, 법령 조문,
예규·적격심사 세부기준(별표 포함), 판례·법령해석례(law.go.kr 실시간)를 직접 조회
- 기관유형 지원: 국가기관 / 지방자치단체 / 공기업·준정부기관 프로파일
- 결정론 우선: 계약방법 결정은 LLM이 아닌 룰엔진이 수행 — 같은 입력엔 항상 같은
결과. LLM은 웹 챗봇·설명 생성에만 사용(키 없이도 핵심 기능 동작)
⚠️ 면책: 이 서비스는 정보 제공 목적이며 법적 자문·유권해석이 아닙니다. 적격심사 통과점수·낙찰하한율·각종 한도는 발주기관별 세부기준과 법령 개정에 따라 다를 수 있으므로, 실제 발주 전 반드시 소속 기관 계약 부서와 현행 법령을 확인하세요.
MCP 서버 사용하기
원격 엔드포인트(Streamable HTTP): `https://contract.sallim.app/mcp` 무료: IP당 50콜/일 (전 도구) · 유료 키: 한도 상향 — 요금 안내
Excerpt — the full document is on GitHub.
Alternatives to contract-compass
- korea-realtyB · 73Korean real estate: court auctions, 10M+ MOLIT records, subscription notice facts, loan/DSR rules
- BirdB · 74Send and receive across email, SMS, WhatsApp, and voice. One API, one contract.
- LawstronautB · 74Connect AI to millions of laws and court cases with the Lawstronaut MCP.
- DesearchA · 82AI, X and web search, page extraction, X data, People Search, and Company Search.
Maintain contract-compass? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/app-sallim-contract-compass)Catalog data refreshed . Something wrong? Report it.