Kaidn-mcp
OfficialKaidn MCP
Kaidn 사기 점수 API를 위한 Model Context Protocol 서버.
평이한 영어로 사기를 조사하세요 — "이 가입이 왜 차단되었나?", "이 기기가 또 무엇을 접촉했나?", "오늘 아침 검토 대기열에는 무엇이 있나?"
증거, 단순한 점수가 아닌. 모든 이유에는 그 뒤에 있는 원시 숫자가 포함되어 있어 모델이 추측하는 대신 판정을 설명할 수 있습니다.
기본적으로 읽기 전용. 옵트인하지 않는 한 테넌트를 변경하지 않습니다.
할당량 보호. 루프에 있는 에이전트가 10분 안에 한 달 치를 소비할 수 없습니다.
모든 클라이언트. MCP는 개방형 프로토콜입니다 — 로컬에서는 stdio, 원격 및 호스팅 에이전트에서는 Streamable HTTP.
요구 사항
Node.js 18 이상과 Kaidn 대시보드의 API 키가 필요합니다.
시작하기
먼저 클라이언트에 Kaidn MCP 서버를 설치하세요. 표준 구성은 대부분의 도구에서 작동합니다:
{
"mcpServers": {
"kaidn": {
"command": "npx",
"args": ["@kaidn/mcp@latest"],
"env": { "KAIDN_API_KEY": "your_key" }
}
}
}claude mcp add kaidn --env KAIDN_API_KEY=your_key -- npx @kaidn/mcp@latest표준 구성을 claude_desktop_config.json에 추가한 다음 Claude를 다시 시작하세요. 설정 → 개발자 → 구성 편집에서 파일을 열 수 있습니다.
설정 → MCP → 새 MCP 서버 추가, 또는 프로젝트의 .cursor/mcp.json (모든 프로젝트의 경우 ~/.cursor/mcp.json)에 표준 구성을 추가하세요.
code --add-mcp '{"name":"kaidn","command":"npx","args":["@kaidn/mcp@latest"],"env":{"KAIDN_API_KEY":"your_key"}}'표준 구성을 ~/.codeium/windsurf/mcp_config.json에 추가하세요.
MCP 서버 아이콘 → MCP 서버 구성을 통해 cline_mcp_settings.json에 표준 구성을 추가하세요.
표준 구성과 동일한 명령, 인수 및 환경 변수를 사용하여 settings.json의 context_servers 아래에 추가하세요.
모든 MCP 클라이언트는 command, args 및 env 블록을 사용합니다. 위의 표준 구성을 사용하세요. 클라이언트가 프로세스를 생성하는 대신 네트워크를 통해서만 서버에 연결할 수 있는 경우 Streamable HTTP를 참조하세요.
Related MCP server: Maskbreak MCP Server
구성
옵션 | 환경 변수 | 기본값 | 목적 |
| 필수 | 비밀 키입니다. 환경 변수로만 — 플래그나 도구 인수로 절대 사용하지 마세요. | |
|
| API 기본 URL | |
|
| 꺼짐 | 변경 도구 등록 |
|
| 프로세스당 할당량 상한 | |
|
|
| Streamable HTTP 제공 |
|
|
| HTTP 바인드 주소 |
|
|
| HTTP 포트 |
| 설정 안 됨 | HTTP에서 | |
| 사용법 표시 | ||
| 버전 표시 |
우선 순위: CLI 플래그가 환경 변수보다 우선합니다.
API 키는 의도적으로 환경 변수로만 사용됩니다. 플래그로 전달된 키는 프로세스 목록과 셸 기록에 노출됩니다.
전송
전송 | 용도 | 엔드포인트 |
stdio (기본값) | 하위 프로세스를 생성하는 로컬 클라이언트 | — |
Streamable HTTP | 원격 에이전트, 컨테이너, 머신 외부의 모든 것 |
|
HTTP+SSE는 의도적으로 제외되었습니다: 2025-03-26 사양에서 더 이상 사용되지 않으며 2026년 6월에 종료됩니다.
Streamable HTTP
npx @kaidn/mcp@latest --http --port 8765무상태 — 요청마다 새 서버가 생성되고 호출자 간에 공유되는 것이 없으므로 로드 밸런서 뒤에서도 문제없이 작동합니다. GET /health는 인증 없이 접근 가능하므로 오케스트레이터가 토큰을 보유하지 않고도 활성 상태를 확인할 수 있습니다.
Docker
docker build -t kaidn-mcp .# stdio — behaves like the npx invocation
docker run -i --rm -e KAIDN_API_KEY=your_key kaidn-mcp
# HTTP — for remote agents
docker run --rm -p 8765:8765 \
-e KAIDN_API_KEY=your_key \
-e KAIDN_MCP_TRANSPORT=http \
-e KAIDN_MCP_HOST=0.0.0.0 \
-e KAIDN_MCP_HTTP_TOKEN=your_token \
kaidn-mcp다단계 빌드, 권한이 없는 node 사용자로 실행되며 헬스체크가 포함되어 있습니다.
보안
서버는 API 키를 보유합니다. 서버에 접근할 수 있는 사람은 누구나 할당량을 소비할 수 있으므로 기본값은 보수적이며 가드는 경고 대신 폐쇄적으로 실패합니다.
127.0.0.1에 바인딩되며,KAIDN_MCP_HTTP_TOKEN이 설정되지 않은 경우 더 넓은 인터페이스에서 시작을 거부합니다. 계정을 조용히 노출하는 대신 설명과 함께 중지됩니다.기본적으로 읽기 전용.
add_to_list및label_outcome은--allow-writes가 있을 때만 존재합니다.set_config및forget_subject는 어떤 모드에서도 노출되지 않습니다. 하나는 향후 모든 이벤트의 판정을 조용히 변경하고, 다른 하나는 되돌릴 수 없는 GDPR 삭제입니다. 둘 다 대시보드에서 사람 앞에 있어야 합니다.프로세스당 할당량 상한이 있으며, 비용이 드는 모든 응답에 남은 예산이 보고됩니다. 초과할 예약은 부분적으로 소비되는 대신 완전히 거부됩니다.
키는 도구 경계를 절대 넘지 않습니다 — 매개변수로도, 출력으로도, 오류로도 아닙니다.
도구
모든 도구를 지배하는 두 가지: 할당량을 소비하는지, 그리고 무언가를 변경하는지입니다.
읽기 전용 — 기본적으로 사용 가능
도구 | 비용 | 기능 |
| 무료 | 롤링 윈도우에 대한 판정, 점수 및 이유 요약. 여기서 시작하세요. |
| 무료 | 점수가 매겨진 이벤트, 최신순, 판정 또는 유형으로 필터링 가능 |
| 무료 | 한 이벤트에서 발생한 모든 검사와 원시 증거 |
| 무료 |
|
| 무료 | 이 테넌트의 유효 가중치 및 임계값 |
| 1행¹ | 한 엔티티에 대한 강화, 네트워크 평판 및 관련 이벤트 |
| 1행 | 일회용 도메인, 전달 가능성, 사기 점수, 남용 기록 |
| 1행 | 프록시, VPN, Tor, 데이터센터 ASN, 지리, 남용 기록 |
| 1행 | 유효성, 회선 유형, 통신사, 사기 점수 |
| 1행 | 새 이벤트 점수 매기기 (기록도 함) |
¹ 엔티티가 device_id인 경우 무료입니다. 강화는 이메일 또는 IP에서만 비용이 발생합니다.
변경 — --allow-writes 필요
도구 | 기능 |
| 엔티티를 허용 또는 차단 목록에 추가 |
| 확인된 사기 / 차지백 / 정상 결과 보고 |
작업 예시
도구는 체인으로 연결되도록 설계되었습니다. 다음은 이를 위해 만들어진 흐름입니다.
아침 트리아지
당신: 밤새 무슨 일이 있었고, 무엇이 나를 필요로 하나요?
모델은 지난 24시간의 개요를 위해 get_stats를 호출하고, review에 있는 이벤트를 위해 triage_queue를 호출한 다음, 가장 심각한 이벤트에 대해 explain_event를 호출합니다. 여전히 읽어야 하는 대시보드 대신 추론이 첨부된 순위 목록을 얻을 수 있습니다.
"이 고객이 왜 차단되었나요?"
당신: 이벤트
evt_8f21c— 고객이 잘못 차단되었다고 합니다.
explain_event는 발생한 모든 검사와 원시 증거를 반환합니다 — 일치한 데이터센터 ASN, 기기를 공유한 계정 수, 속도 횟수. 고객에게 답하거나 규칙이 잘못되어 조정이 필요하다고 결론 내리기에 충분합니다.
하나의 신호에서 바깥으로 작업
당신:
194.x.x.x는 일회성인가요, 아니면 링의 일부인가요?
investigate_entity는 IP에 대한 강화 및 네트워크 평판과 함께 해당 IP가 나타나는 모든 최근 이벤트를 반환합니다. 동일한 기기 ID가 계속 반복된다면 우연이 아니라 링입니다.
변경 전 규칙 변경 확인
당신: 속도 가중치를 낮추면 무엇이 차단되지 않게 될까요?
get_config는 현재 가중치를 읽고, verdict: "block"이 있는 list_events는 현재 잡히는 것을 보여줍니다. 모델은 약화하려는 검사에 의존하는 항목을 알려줄 수 있습니다.
오류 처리
실패는 예외가 아닌 읽을 수 있는 메시지가 있는 도구 오류로 반환됩니다 — 모델이 이에 대해 조치를 취할 수 있습니다.
표시 | 의미 | 해결 방법 |
| 키 없이 서버가 시작됨 | 클라이언트의 |
| 키가 거부됨 | 대시보드에서 회전하거나 다시 복사하세요. |
| 속도 제한 | 속도를 늦추세요. 키별 제한은 분 단위입니다. |
| 가드가 비용이 많이 드는 실행을 중지했습니다. | 의도적으로 |
| 이벤트가 검색 창보다 오래됨 |
|
| 모호한 조사 | 한 번에 하나의 엔티티에 대해 물어보세요. |
| 토큰이 없는 비루프백 HTTP |
|
오류에는 API 키가 절대 포함되지 않습니다.
문제 해결
클라이언트에 도구가 표시되지 않습니다.
시작 줄을 확인하려면 클라이언트의 MCP 로그를 확인하세요. stderr의 kaidn-mcp: ready (stdio, …)는 서버가 실행 중이고 문제가 클라이언트 쪽에 있음을 의미합니다. 아무것도 표시되지 않으면 일반적으로 npx가 패키지를 확인하지 못했거나 Node가 18보다 오래된 버전임을 의미합니다.
시작된 후 즉시 종료됩니다.
거의 항상 KAIDN_API_KEY가 누락된 경우입니다. 메시지가 stderr에 표시됩니다. 일부 클라이언트는 stderr를 숨기므로 터미널에서 실행하여 확인하세요.
add_to_list와 label_outcome이 누락되었습니다.
설계된 대로 동작합니다. --allow-writes가 필요합니다.
set_config와 forget_subject가 누락되었습니다.
이 역시 설계된 대로이며 어떤 모드에서도 사용할 수 없습니다. SECURITY.md를 참조하세요.
HTTP 모드가 시작을 거부합니다. 베어러 토큰 없이 루프백이 아닌 다른 주소에 바인딩한 경우입니다. 이는 가드가 작동하는 것입니다 — 프로세스가 API 키를 보유하고 있습니다.
모든 것이 느립니다.
강화(Enrichment) 검사는 실시간 업스트림 호출을 수행합니다. get_stats, list_events, explain_event, triage_queue는 무료이고 빠르므로 기록을 읽을 때 이들을 선호하세요.
클라이언트와 독립적으로 서버를 확인하세요:
node dist/index.js --help # no key required
KAIDN_API_KEY=your_key npm start # should print a ready line지원
버그 및 기능 요청: GitHub issues
보안: security@kaidn.io — SECURITY.md 참조
개인정보 및 데이터 처리: PRIVACY.md
API 자체: kaidn.io
소스에서 실행
git clone https://github.com/Kaidn-io/kaidn-mcp.git
cd kaidn-mcp
npm install
npm run build
npm testclaude mcp add kaidn --env KAIDN_API_KEY=your_key -- node /absolute/path/to/kaidn-mcp/dist/index.js클라이언트 없이 시작되는지 확인하려면:
KAIDN_API_KEY=your_key npm startstderr에 kaidn-mcp: ready (stdio, read-only, quota ceiling 100)를 출력한 다음 stdin에서 대기합니다 — 이것이 MCP 전송이므로 침묵이 정상입니다.
증거가 중요한 이유
Kaidn의 엔진은 규칙 우선이고 설명 가능합니다. 모든 이유에는 그 뒤에 있는 원시 숫자가 포함됩니다. 맨 점수는 모델이 추론할 수 있는 것을 제공하지 않지만, 증거가 첨부된 checks[]는 설명할 수 있는 것을 제공합니다. 이것이 explain_event가 유용한 것과 장식적인 것의 차이입니다.
규칙이 결정합니다. 모델이 서술합니다.
프로젝트
CONTRIBUTING.md — 여기에 속하는 내용과 변경 사항이 깨뜨리지 말아야 할 보장
SECURITY.md — 신고, 위협 모델, 알려진 제한 사항
PRIVACY.md — 통과되는 것, 저장되는 것, 저장되지 않는 것
라이선스
MIT
Available Tools
10 toolscheck_emailCheck an email addressA
Enrichment and in-network reputation for one email address: disposable/ throwaway domain, deliverability, fraud score, plus how often the address has been seen abusing other operators. Also returns canonical, the identity key: every alias that reaches one mailbox (+tags, gmail dot tricks, googlemail.com) collapses to the same string, so compare THAT across accounts to tell whether two signups are one person. is_aliased and alias_tricks say which trick was used, and reject_reason says why an address is unusable. Consumes one row of monthly quota.
Inputs: email (required).
check_ipCheck an IP addressA
Enrichment and in-network reputation for one IP: proxy/VPN/Tor, datacenter ASN, geo, fraud score, and cross-operator abuse history. Consumes one row of monthly quota.
Inputs: ip (required).
check_phoneCheck a phone numberA
Validity, line type, carrier and fraud score for one phone number. Consumes one row of monthly quota.
Inputs: phone (required), country.
explain_eventExplain why an event scored the way it didA
The 'why was this blocked?' tool. Returns the event with every check that fired, its weight, and the raw evidence behind it, so the reasoning can be narrated with receipts rather than guessed at. Free.
Inputs: event_id (required).
get_configGet scoring configurationA
This tenant's weight and threshold overrides plus the effective merged engine config. Free. Useful for explaining why a score landed where it did.
Inputs: no named parameters.
get_statsVerdict and reason rollupsA
Aggregate view over a rolling window: totals by verdict, average score and the most common reasons. Free — does not consume quota. Start here to see what changed before drilling into individual events.
Inputs: window_hours.
investigate_entityInvestigate an entity and the ring around itA
One call for what a fraud analyst actually wants. Returns enrichment for the entity, its reputation across the CROSS-OPERATOR abuse network (whether this email, IP or device has already burned other businesses, not just yours), and every recent event it appears in — which is how you get from one suspicious signup to the whole ring of accounts sharing its device, IP or inbox. Supply exactly one of email, ip or device_id. Enrichment consumes one row of monthly quota (device_id lookups are free).
Inputs: ip, email, limit, device_id.
list_eventsList scored eventsA
Scored events for this tenant, newest first. Free — does not consume quota. Filter by verdict or event type to narrow an investigation.
Inputs: event, limit, offset, verdict.
score_eventScore an eventA
Run an event through the scoring engine and get {score, verdict, reasons, checks}. When the event carries an email, the response also has an identity block whose email_canonical is the dedupe key for that address — so one call both scores the event and tells you whether the mailbox is one you have already seen. Consumes one row of monthly quota AND records an event — prefer the read-only tools when investigating history rather than testing new input.
Inputs: event (required), ip, email, phone, +3 more.
triage_queueReview queue, highest risk firstA
Every event sitting on the 'review' verdict, sorted by score descending — the daily triage job. Free.
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose: check_email/check_ip/check_phone target different entity types, the read-only analytics tools (list_events, get_stats, get_config, explain_event, triage_queue) each serve a unique function, investigate_entity combines enrichment and history, and score_event is the only action that records an event. No two tools are easily confused.
All tool names follow a consistent verb_noun snake_case pattern (check_email, list_events, get_config, score_event, etc.). The verbs (check, list, get, explain, investigate, triage, score) clearly indicate the action, and the nouns (email, events, stats, config, entity, queue) indicate the resource.
10 tools is well within the ideal range for a fraud investigation MCP. Each tool covers a distinct need — enrichment, event browsing, stats, config, explanation, investigation, triage, and scoring — without unnecessary redundancy or bloat.
The tool set covers the full investigation lifecycle: enrichment for email/IP/phone/device, listing and triaging events, understanding scores via stats and config, explaining individual verdicts, investigating entity history, and testing new events. There are no obvious missing operations for the stated purpose.
Related MCP Connectors
Score an IP, email, phone, domain or device for fraud in one call, with the signals behind it.
Signup fraud checks: score emails and IPs, look up IPs and manage your blocklist.
Fraud risk score for signups and orders from email, IP, phone and user-agent
Verify companies, domains and counterparties before transacting. Sanctions, UBO, fraud scoring.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables real-time fraud detection and transaction analysis by integrating with Claude through MCP, providing tools to analyze transactions, flag suspicious activity, and manage fraud rules.9-
- AlicenseNot gradedqualityBmaintenanceEnables checking any IP address for VPN, proxy, Tor, datacenter hosting, anonymity, and fraud risk signals, plus API service status, directly from MCP-capable clients like Claude and Cursor.118 npm2MIT
- AlicenseAqualityBmaintenanceEnables AI agents to investigate synthetic fraud cases by pulling transactions, running deterministic rules evaluations, pivoting across devices, and recording auditable case files with provenance.4MIT
- AlicenseCqualityBmaintenanceEnables Claude Desktop, Cursor, and other MCP clients to inspect a Remnawave 3.x panel through natural-language chat, covering users, nodes, traffic, devices, connections, and GeoCheck, with tools generated from the official backend contract to match the panel version. Read-only by default and privacy-filtered, so secrets, keys, and client identifiers are hidden or replaced with aliases before reaching the chat.9113 npm21MIT