원문 캡처 · github.com
원문 캡처 · github.com

OpenRegistry는 80개가 넘는 국가·지역의 공식 기업 등기소에 실시간으로 질의해 기업 정보와 원본 공시를 가져오는 MCP 서버와 API다. 기업 검색, 임원·주주·주요 지배자 정보, 담보권, 공시, 재무제표 문서를 조회할 수 있으며 무료 이용층과 더 높은 할당량·조회 범위를 제공하는 유료 키가 있다. 서비스 운영사 Sophymarine은 데이터를 정부 등기소의 응답 그대로 돌려준다고 설명한다.

지원 대상에는 UK Companies House, 아일랜드 CRO, 프랑스 RNE, 스페인 BORME, 이탈리아 InfoCamere, 노르웨이 Brreg, 폴란드 KRS, 네덜란드 KVK, 벨기에 KBO, 스위스 Zefix, 핀란드, 체코, 한국, 대만, 뉴질랜드, 케이맨제도, 호주, 캐나다 등이 포함된다. 데이터는 UK Companies House, CRO Ireland, Brønnøysund, Zefix, KRS Ministry of Justice 등에서 제공받는다. 각 기관의 이용 조건은 UK Open Government Licence, CRO Ireland, Brønnøysund, Zefix, KRS Ministry of Justice에서 확인할 수 있다.

서비스 엔드포인트는 https://openregistry.sophymarine.com/mcp다. MCP(Model Context Protocol)를 지원하는 클라이언트에서 연결해 사용할 수 있으며, 인증에는 OAuth 2.1과 동적 클라이언트 등록(DCR)을 사용한다. 무료 이용층은 API 키를 붙이지 않아도 된다.

데이터 조회와 한계

Sophymarine에 따르면 각 도구 호출은 해당 시점에 정부 등기소 API로 실시간 질의한다. 중간 데이터 집계소나 자체 캐시를 거치지 않으며, 원본 필드명·상태값·식별자와 공시 파일의 바이트를 변경하지 않고 반환한다. 문서 형식은 XHTML iXBRL, PDF, XBRL 등이 될 수 있다. 응답에 있는 관할권과 등기소 식별자로 정부 기록의 URL을 재구성할 수 있다. 기업 소유 관계도 한 번의 프롬프트에서 여러 관할권에 걸쳐 조회할 수 있다고 운영사는 설명한다.

일부 실소유자 등록부는 CJEU C-37/20 판결 이후 AML 의무가 있는 기관·관계자에게만 공개됐다. 독일, 스페인, 이탈리아, 네덜란드, 룩셈부르크, 오스트리아, 몰타, 포르투갈과 케이맨제도 등 제한된 등록부는 OpenRegistry가 대신 조회하지 않는다. 이 경우 재시도해도 해결되지 않는 HTTP 501 응답과, 자격을 갖춘 이용자가 접근을 신청할 수 있는 법정 포털을 가리키는 alternative_url을 반환한다. 서비스가 데이터를 보유하지 않는 곳에서는 그 사실을 감추지 않고 대체 경로를 제공한다.

운영사가 제시한 사례에서는 AI 에이전트가 Iceland Foods Ltd의 주주 관계를 영국 내 지주회사 4곳(WD FF MIDCO → ICELAND VLNCO → LANNIS → WD FF LIMITED)을 거슬러 조회하고, 최종적으로 개인 8명을 찾아냈다. 제시된 자료에서 Tarsem Dhaliwal의 지분은 41.35%로 가장 컸고 Walker 가족의 합산 지분은 51.31%였다. 운영사는 지분 수와 비율이 등기소의 CS01 PDF에서 그대로 읽은 값이라고 설명한다. 이는 제품 소개에 제시된 사례이며 독립 검증 결과로 제시된 것은 아니다.

영국에서는 주요 지배자(PSC) 등록부와 자본금 명세서에 나타나는 주주 정보가 서로 다를 수 있다. 예를 들어 10% 주주는 자본금 명세서에 나오지만 PSC에는 없을 수 있고, 법인 수탁자는 PSC에 나타나면서 주주가 아닐 수 있다. OpenRegistry는 각각 get_persons_with_significant_control과 get_shareholders로 두 종류의 정보를 제공한다고 안내한다. 자세한 사례는 주주와 PSC 비교 자료에서 볼 수 있다.

할당량과 오류 처리

익명 요청은 IP별, 로그인한 요청은 사용자별로 제한된다. 이와 별도로 search_companies를 통해 60초 동안 조회할 수 있는 서로 다른 관할권 수에 팬아웃 한도가 적용된다. 한도를 넘으면 HTTP 429와 초 단위로 올림한 Retry-After 헤더가 돌아온다. 응답의 retry_after_ms를 그대로 따르면 되며, 고정된 이동 시간창이므로 그 위에 지수형 대기 시간을 더할 필요는 없다고 문서는 설명한다. 팬아웃 한도는 60초 이동 창이며, 가장 오래된 국가가 창에서 빠지면 새 국가를 조회할 수 있다. Pro는 60초에 서로 다른 국가 10곳, Max는 30곳까지 허용하고 Enterprise는 무제한이다.

오류별 권장 처리는 다음과 같다.

  • 429 rate-limited: retry_after_ms만큼 기다린 뒤 한 번 재시도한다.
  • 429 fanout: 같은 요청을 다시 보내지 말고, 해당 시간 창에서 이미 조회한 국가로 다음 요청을 보낸다.
  • 501 not_proxied_by_design: 재시도하지 말고 이용자에게 alternative_url을 제공한다.
  • 501 alternative_tool_required: alternative_tool과 alternative_args를 넣어 다시 요청한다.
  • 5xx upstream_error: retry_after_ms가 있으면 그만큼 기다리고, 없으면 30초 기다린다. 최대 3회 재시도한다.
  • 4xx not_found: 재시도하지 말고 search_companies로 유효한 ID를 다시 찾는다.

상류 정부 등기소에 장애가 생기면 서비스는 그 오류를 구조화된 응답으로 감싸 원문 그대로 전달한다. 프레임워크별 연동 안내에는 참고용 대기·재시도 구현을 제공하며, LangChain 연동 안내에서 확인할 수 있다.

에이전트 워크플로와 연동

OpenRegistry는 KYC 및 국가 간 실사, 실소유자 소유망 추적, 이사 검색·PEP 검사, XBRL 재무제표 조회, 기업 공시 모니터링, 여러 나라의 상호명 등록 가능 여부 확인, 업종·경쟁사 검색, 페이퍼컴퍼니 탐지, 해산 후 재등장한 기업 탐지, 규제기관 허가 기업 목록 작성 등 10개 Claude Agent Skills를 제공한다. 이 스킬은 Claude Code 프로젝트의 .claude/skills/에 넣거나 Claude 호환 에이전트에서 사용할 수 있다. 각 스킬은 MCP 프롬프트로도 제공되며, 클라이언트에서 prompts/list로 목록을 확인하고 prompts/get으로 호출한다.

스킬 파일과 개요는 저장소의 skills 디렉터리와 skills/README.md에 있다. 각각의 결과물은 다음과 같다.

  • KYC 및 국가 간 실사: 기업 프로필, 이사, 실소유자, 주주, 담보권, 최신 결산을 담은 법정 실사 자료.
  • 국가 간 실소유자 추적: 개인 실소유자에 도달할 때까지 여러 관할권의 소유 관계를 추적한다.
  • 이사 검색 및 PEP 검사: 한 사람이 운영한 모든 기업과 공동 이사 네트워크를 찾는다.
  • 기업 결산 및 XBRL 재무정보: 최신 법정 결산을 XBRL, iXBRL, PDF로 가져오고 주요 수치를 제시한다.
  • 기업 공시 모니터링 및 이벤트 알림: 정해진 기간의 중요 공시를 분류하고 표시한다.
  • 세계 기업명 사용 가능 여부 확인: 10개가 넘는 국가에서 상호 등록 가능 여부를 확인한다.
  • 업종·경쟁사 검색: 여러 관할권의 업종 내 기업을 찾아 순위를 매기고 정보를 보강한다.
  • 페이퍼컴퍼니 탐지: 이사 1명, 결산 자료 없음, 해외 사무소 등의 AML 신호를 표시한다.
  • Phoenix Company Radar: 같은 이사·주소를 가진 기업이 해산 후 다시 생기는 사기 패턴을 찾는다.
  • Sector Gatekeeper List: CIMA, FCA, BaFin, FSS 허가를 받은 규제 대상 기업을 찾는다.

주요 에이전트 프레임워크에는 일반 MCP 어댑터가 있어, 운영사 설명으로는 프레임워크별 코드를 추가하지 않고 27개 도구와 10개 프롬프트 워크플로를 연결할 수 있다. 통합 안내는 LangChain·LangGraph, LlamaIndex, CrewAI, Haystack, AutoGen, Vercel AI SDK에서 확인할 수 있다.

클라이언트 연결 방법

모든 클라이언트에서 사용하는 호스팅 주소는 https://openregistry.sophymarine.com/mcp다. 연결 절차와 설정은 클라이언트별로 다르다.

  • Claude Desktop: Settings → Connectors → Add custom connector에서 주소를 입력한다. 구버전처럼 Connectors 화면이 없는 경우 claude_desktop_config.json에 다음 설정을 추가한다.
json
{
 "mcpServers": {
 "openregistry": {
 "command": "npx",
 "args": ["-y", "mcp-remote", "https://openregistry.sophymarine.com/mcp"]
 }
 }
}
  • Claude Code: 다음 명령을 실행한다.
text
claude mcp add --transport http openregistry https://openregistry.sophymarine.com/mcp

Claude Code 2.1.1 이상에서는 JSON 형식도 사용할 수 있다.

text
claude mcp add-json openregistry '{"type":"http","url":"https://openregistry.sophymarine.com/mcp"}'
text
gemini extensions install https://github.com/sophymarine/openregistry

수동 설정은 ~/.gemini/settings.json에 추가한다. Gemini는 url이 아니라 httpUrl을 사용한다.

json
{
 "mcpServers": {
 "openregistry": {
 "httpUrl": "https://openregistry.sophymarine.com/mcp"
 }
 }
}

소비자용 Google Gemini 앱(gemini.google.com)은 현재 사용자 지정 MCP를 지원하지 않는다. Gemini CLI와 Google Cloud 관리자 경로를 통한 Gemini Enterprise에서는 사용할 수 있다.

  • ChatGPT: Plus, Pro, Business, Enterprise, Education 요금제에서만 사용할 수 있으며 Free 요금제에는 Developer Mode가 없다. Settings → Apps & Connectors → Advanced settings에서 Developer Mode를 켠 뒤 Connectors 페이지에서 Create를 누르고 MCP 주소를 입력한다. 자세한 내용은 OpenAI 개발자 모드 안내를 참고한다.
  • Perplexity: Pro, Max, Enterprise 요금제만 지원한다. Settings → Connectors → Add custom remote connector에서 주소를 입력하고 OAuth를 선택한다. 일반 채팅, Comet 브라우저, Computer 에이전트 워크플로에서 사용할 수 있다. 2026년 3월 13일 변경 내역에 안내가 있다.
  • Cursor: 설치 링크를 이용하거나 ~/.cursor/mcp.json에 다음을 추가한다.
json
{
 "mcpServers": {
 "openregistry": {
 "url": "https://openregistry.sophymarine.com/mcp"
 }
 }
}
json
{
 "servers": {
 "openregistry": {
 "type": "http",
 "url": "https://openregistry.sophymarine.com/mcp"
 }
 }
}

GitHub Copilot은 JetBrains, Visual Studio, Xcode, Eclipse에서도 mcp-config.json 방식의 사용자 지정 MCP를 지원한다. IDE별 안내는 GitHub Copilot 문서를 참고한다. Copilot CLI에서는 ~/.copilot/mcp-config.json 또는 대화형 /mcp add 명령을 사용한다.

  • Microsoft 365 Copilot(Word, Excel, PowerPoint, Teams, Outlook): Microsoft 365 Copilot 라이선스가 필요하며 조직 단위로 배포한다. Microsoft Copilot Studio에서 에이전트를 열거나 새로 만든 뒤 Tools → Add a tool → New tool → Model Context Protocol을 선택한다. 주소를 입력하고 인증 방식으로 OAuth 2.0 → Dynamic discovery를 선택한다. OpenRegistry는 DCR 검색을 지원하므로 별도 설정은 필요하지 않다. 에이전트를 게시하고 전역 관리자 또는 Teams 관리자의 승인을 받으면 Microsoft 365 관리 센터의 승인을 거쳐 각 앱의 Agent Store에 표시된다. 자세한 내용은 Copilot Studio MCP 문서와 Agent Store 안내를 참고한다.
  • Cline: Settings → Cline → MCP Servers → Edit settings에서 cline_mcp_settings.json에 다음을 붙여 넣는다.
json
{
 "mcpServers": {
 "openregistry": {
 "url": "https://openregistry.sophymarine.com/mcp",
 "transport": "streamable-http"
 }
 }
}
  • Windsurf: Cascade 패널의 망치 아이콘 → Configure를 눌러 ~/.codeium/windsurf/mcp_config.json을 연다. url이 아닌 serverUrl을 사용하고 Refresh를 누른다.
json
{
 "mcpServers": {
 "openregistry": {
 "serverUrl": "https://openregistry.sophymarine.com/mcp"
 }
 }
}
  • Zed, Goose, Continue 등 MCP 2025-06-18을 지원하는 클라이언트는 표준 설정을 사용한다.
json
{
 "mcpServers": {
 "openregistry": {
 "url": "https://openregistry.sophymarine.com/mcp"
 }
 }
}

전송에는 MCP 사양 2025-06-18의 Streamable HTTP를 사용하며, 인증은 OAuth 2.1과 RFC 7591에 따른 동적 클라이언트 등록으로 처리한다.

출처 확인, 보안과 운영

응답에는 jurisdiction과 company_id가 들어 있어 정부 기록 URL을 재구성할 수 있다. 예를 들어 영국 기업 ID를 이용해 https://find-and-update.company-information.service.gov.uk/company/09446231에 접근할 수 있다. document_id는 정부의 공시 식별자이며, jurisdiction_data에는 필드명을 그대로 유지한 원본 응답이 담긴다. 공시 문서는 재렌더링하지 않은 원본 바이트로 반환한다. Enterprise 요금제는 모든 응답에 source_url, registry_url, registry_name, data_license, alternative_url을 미리 넣어 규정 준수 보고서에서 출처를 확인하기 쉽게 한다.

인증은 OAuth 2.1과 PKCE, 비밀번호 없는 이메일 매직 링크, RFC 7591 동적 클라이언트 등록을 지원하며 사전 공유 API 키는 쓰지 않는다. Sophymarine은 공식 공개 등기부 데이터를 중계한다고 설명한다. 인증된 요청은 사용자별, 익명 요청은 IP별로 제한하며, 모든 이용자에게 공통으로 적용되는 관할권별 상류 보호 한도도 둔다.

할당량과 관할권별 도구 지원 범위는 list_jurisdictions를 호출하거나 관할권 목록에서 확인할 수 있다. 계정 관리와 호스팅 서비스는 OpenRegistry 계정 페이지, 가동 상태는 상태 페이지에서 확인한다. 기업용 문의와 제휴 연락처는 Sophymarine 문의 페이지다.

공개 저장소에는 문서만 들어 있으며 OpenRegistry 서비스 구현은 비공개다. 서비스 자체의 관할권별 어댑터, MCP 서버, 결제, 인증 코드는 오픈소스가 아니며 PR을 받지 않는다. 저장소에서는 문서·예제·설치 과정, server.mjs 브리지 버그, 스킬·프롬프트, 브랜드 자산 등에 관한 이슈와 PR을 받는다. 호스팅 서비스의 도구 동작 요청은 사용 사례를 설명하는 이슈로 제기할 수 있다. 취약점은 공개 이슈가 아니라 연락 양식으로 신고하며, 범위와 세이프 하버 조건은 SECURITY.md에 있다. 프로젝트 행동 강령은 Contributor Covenant 2.1을 바탕으로 한 문서를 따르며, 문제는 conduct@sophymarine.com으로 알릴 수 있다.

버전이 붙은 릴리스는 GitHub Releases에 올라오며 SemVer를 따른다. 브리지 프로토콜이나 도구 표면 계약에 호환성을 깨는 변경은 메이저, 기능 추가는 마이너, 수정은 패치 버전으로 배포한다. 저장소의 문서·스킬·브랜드 자산과 openregistry 표준 입출력(stdio) 브리지는 CC-BY-4.0으로 공개돼 출처를 표시하면 공유·수정할 수 있다. 호스팅 MCP 서비스 구현은 오픈소스가 아니며 별도 상업 조건을 따른다. 제삼자 저작물 표기는 NOTICE.md에 있다.

OpenRegistry는 Sophymarine이 운영한다. 저장소에 공개된 문서에는 2026년 저작권 표시가 있다.