skanfirmy.pl — MCP 서버

AI 에이전트가 폴란드 기업을 검증하고 EU VAT 번호를 공식 정부 레지스트리에서 직접 검증할 수 있게 해주는 무료, 무상태(stateless) MCP(Model Context Protocol) 서버 — 키 없음, 등록 없음, 소스 레지스트리 자체의 제한 외에는 한도 없음.

• 엔드포인트: https://skanfirmy.pl/mcp (Streamable HTTP를 통한 JSON-RPC 2.0)

• 9가지 도구 — VAT 레지스트리(재무부), KRS(법무부), REGON(폴란드 통계청 / GUS) 및 VIES(유럽 위원회)를 결합합니다.

• MCP를 사용할 수 없는 크롤러/에이전트를 위해 일반 REST로도 사용 가능합니다.

Bartosz Kuć 제작 — skanfirmy.pl과 폴란드 및 EU 공개 API 카탈로그인 otwarteAPI.pl을 만든 동일 인물입니다.

도구

Related MCP server: ksef-mcp

연결

원격(Streamable HTTP) 서버를 지원하는 모든 MCP 클라이언트 — 다음을 가리키세요:

https://skanfirmy.pl/mcp

Claude Desktop / stdio 전용 클라이언트 — mcp-remote로 브리지:

{
  "mcpServers": {
    "skanfirmy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://skanfirmy.pl/mcp"]
    }
  }
}

원시 JSON-RPC(MCP 클라이언트 불필요):

# list tools
curl -s https://skanfirmy.pl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# check a company by NIP
curl -s https://skanfirmy.pl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"sprawdz_nip","arguments":{"nip":"5261040828"}}}'

일반 REST(MCP 아님)

URL만 필요한 에이전트/크롤러용:

• GET https://skanfirmy.pl/nip/{nip} — VAT + KRS

• GET https://skanfirmy.pl/nips/{comma,separated,nips} — 일괄(≤30)

• GET https://skanfirmy.pl/regon/{nip} — REGON 레지스트리 데이터

• GET https://skanfirmy.pl/vies/{country}/{number} — EU VAT(VIES)

JSON을 원하면 ?format=json을 추가하세요. 전체 문서: skanfirmy.pl/llms.txt.

Claude Agent Skill

드롭인 Agent Skill을 선호하시나요? skill/에는 **verify-polish-company**가 있습니다 — 단일 SKILL.md로 Claude Code, Claude 앱 또는 Agent SDK에 위 엔드포인트를 언제 어떻게 호출할지 알려줍니다(키 없음, 일반 HTTP 외에 실행할 것 없음):

cp -R skill ~/.claude/skills/verify-polish-company

자세한 내용은 skill/README.md를 참조하세요.

데이터 소스

VAT 레지스트리 / 백색 목록(재무부), KRS(법무부), REGON / BIR(폴란드 통계청 — GUS), VIES(유럽 위원회). 독립 프로젝트 — 이들 중 어느 것과도 제휴하지 않습니다. 아무것도 저장되지 않습니다. 응답은 일시적으로 CDN에 캐시되며(최대 24시간), POST /mcp는 전혀 캐시되지 않습니다.

작성자

Bartosz Kuć · skanfirmy.pl · github.com/bartosz-kuc · linkedin.com/in/bartosz-kuc · cal.com/bartosz-kuc

라이선스

MIT © Bartosz Kuć. 이 저장소는 호스팅된 서버를 문서화하고 MCP 레지스트리 매니페스트를 보관합니다. 서버 자체는 https://skanfirmy.pl/mcp에서 실행됩니다.