LayerCall MCP server
2026년 11월 11일 커밋AI 에이전트가 IP, 이메일, 전화번호, 도메인 및 디바이스에 대한 사기 검사를 수행하여 위험 점수와 판정 결과를 평가할 수 있도록 지원합니다.
다른 이름 LayerCall/layercall-sdk, layercall-sdk
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
LayerCall MCP란?
LayerCall은(는) MCP server입니다. AI 에이전트가 IP, 이메일, 전화번호, 도메인 및 디바이스에 대한 사기 검사를 수행하여 위험 점수와 판정 결과를 평가할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
LayerCall MCP server 정보
LayerCall은 AI 에이전트가 실시간 사기 탐지 및 위험 평가를 수행할 수 있도록 지원하는 원격 MCP server를 제공합니다. 개발자는 URL과 API 키를 통해 Claude Desktop, Cursor 또는 VS Code와 같은 클라이언트를 서비스에 연결할 수 있습니다. 이 설정을 통해 AI는 로컬 설치 없이도 대화 중에 다양한 식별자의 정당성을 평가할 수 있습니다.
이 서버는 score_ip, verify_email, lookup_phone, score_domain, score_device, verify_agent, score_user의 7가지 특정 도구를 제공합니다. 이러한 도구들은 0에서 100 사이의 위험 점수, allow, review 또는 block 판정, 그리고 IP가 VPN인지 또는 프록시인지와 같은 구체적인 시그널을 반환합니다. 이 서비스는 도메인 생성일, 전화 회선 유형, 디바이스 핑거프린트 등의 데이터 포인트를 분석하여 봇, 일회용 이메일 및 사기성 가입을 식별하도록 설계되었습니다.
활용 사례
- 1이메일 정당성 확인에이전트가 이메일 주소가 일회용인지 또는 역할 기반 계정(role account)인지 확인할 수 있습니다.
- 2AI 에이전트 인증시스템을 사용하여 AI 에이전트가 주장하는 신원이 실제와 일치하는지 증명할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
LayerCall MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 LayerCall MCP 설치
$ claude mcp add --transport http layercall-sdk https://www.layercall.com/api/mcpCursor에 LayerCall MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"layercall-sdk": {
"url": "https://www.layercall.com/api/mcp"
}
}
}VS Code에 LayerCall MCP 설치
.vscode/mcp.json
{
"servers": {
"layercall-sdk": {
"type": "http",
"url": "https://www.layercall.com/api/mcp"
}
}
}VS Code CLI에 LayerCall MCP 설치
$ code --add-mcp '{"name":"layercall-sdk","type":"http","url":"https://www.layercall.com/api/mcp"}'Codex에 LayerCall MCP 설치
$ codex mcp add layercall-sdk --url https://www.layercall.com/api/mcpCodex config.toml에 LayerCall MCP 설치
~/.codex/config.toml
[mcp_servers.layercall-sdk] url = "https://www.layercall.com/api/mcp"
Gemini CLI에 LayerCall MCP 설치
$ gemini mcp add -s user --transport http layercall-sdk https://www.layercall.com/api/mcpGemini settings.json에 LayerCall MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"layercall-sdk": {
"url": "https://www.layercall.com/api/mcp",
"type": "http"
}
}
}구성
LAYERCALL_API_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| LAYERCALL_API_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능layercall/layercall-sdk is public and reachablegithub.com/layercall/layercall-sdk ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/layercall/layercall-sdk ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 918 ms통과
README
GitHub에서 보기LayerCall SDKs
Official clients for LayerCall — score an IP, email, phone number, domain, or a whole signup for fraud in a single call.
| Install | Docs | |
|---|---|---|
| Node / TypeScript | npm i layercall |
node/README.md |
| Python | pip install layercall |
python/README.md |
| CLI | npx layercall ip 8.8.8.8 |
below |
Both clients have zero dependencies. A trust check sits on your signup path, which is the worst place in an application to introduce a dependency tree.
Get a free API key — 1,000 lookups a month, no card required, no daily cap.
Try it without installing anything
export LAYERCALL_API_KEY=tl_live_...
npx layercall ip 8.8.8.8
npx layercall email someone@mailinator.com
npx layercall domain example.com
npx layercall user --ip 1.2.3.4 --email a@b.com
What it returns
Every endpoint returns the same shape: a 0–100 risk_score, an
allow | review | block verdict, and the signals behind it.
{
"ip": "185.220.101.1",
"risk_score": 60,
"verdict": "review",
"signals": {
"is_vpn": true,
"is_proxy": true,
"is_datacenter": true,
"is_tor": true,
"recent_abuse": false
},
"geo": { "country": "DE", "city": "Berlin", "asn": "AS60729" },
"vpn_provider": null
}
Two things worth reading before you integrate
Prefer step-up over rejection. The review band starts where an ordinary
commercial VPN lands, and most VPN users are ordinary customers. Send them an
OTP or a 3-D Secure challenge instead of a refusal: a real user clears it in
seconds, an attacker cannot, and a false positive costs friction rather than a
customer. This is what Stripe Radar and Sift both converged on.
null means unknown, not "no". newly_registered is null when a TLD
publishes no RDAP (.de, .ru, .ac.uk among them), and mailbox_exists is
null when the mail provider does not answer honestly — Gmail and Yahoo accept
mail for addresses that do not exist. Treating either as a negative finding is
the specific mistake these fields exist to prevent.
Endpoints
POST/GET /v1/score/ip |
VPN, proxy, Tor, datacenter, geo, ASN |
/v1/verify/email |
Syntax, MX, disposable, role account, domain age |
/v1/lookup/phone |
Numbering-plan validation worldwide, line type |
/v1/score/domain |
RDAP age, registrar, MX/SPF/DMARC, risky TLD |
/v1/score/device |
Device fingerprint reputation + bot probability |
/v1/score/user |
All of the above weighted into one verdict |
/v1/verify/agent |
Web Bot Auth (RFC 9421) — prove an AI agent is who it claims |
/v1/batch |
Up to 500 values of one type |
Full reference: layercall.com/docs · OpenAPI 3.1: layercall.com/openapi.json
Testing without spending anything
Test-mode keys return deterministic synthetic data, drawn from ranges
reserved for exactly this purpose — RFC 5737 addresses, example.com, the
555-01XX fiction block. Same shape and fields as production, so your assertions
are real ones. They never bill, never hit live data sources, and never write to
the shared reputation network.
Every fixture is documented, so you can assert on exact values rather than "did it return a number": layercall.com/docs/test-mode
MCP — call it from an AI agent
LayerCall speaks the Model Context Protocol over Streamable HTTP, so Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf and Zed can run a fraud check mid-conversation. There is nothing to install — it is a remote server, so you add a URL and your API key:
{
"mcpServers": {
"layercall": {
"url": "https://www.layercall.com/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Seven tools are exposed: score_ip, verify_email, lookup_phone,
score_domain, score_device, verify_agent and score_user.
VS Code names the top-level key
servers, notmcpServers. That one difference is the usual reason a copied config silently does nothing.
Per-client setup: layercall.com/docs/mcp
Framework middleware
Drop-in for the two places this usually goes. The middleware attaches
req.trust and leaves the decision to you:
import { layercall } from "layercall/express";
app.post("/signup", layercall(), (req, res) => {
if (req.trust.verdict === "block") return res.status(403).json({ error: "..." });
if (req.trust.verdict === "review") flagForManualReview(req.trust);
createAccount(req.body);
});
There is deliberately no autoBlock: true. A one-line install that starts
rejecting people is the wrong default for a fraud tool — the failure is silent,
it lands on real customers, and you find out from a support ticket.
By default it only scores POST/PUT/PATCH, because a global app.use()
bills a lookup for every request including favicon.ico.
See node/src/express.ts and
node/src/next.ts (scoreRequest, withTrust).
Guides
Written for someone mid-incident rather than someone shopping. Each one ends with what a naive version gets wrong — including the parts that need no LayerCall at all.
- How to stop fake signups
- How to block disposable email addresses at signup
- How to detect VPN and proxy users at signup
- How to stop free trial abuse
- How to add fraud checks without losing real customers
License
MIT
LayerCall MCP 질문
LayerCall MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http layercall-sdk https://www.layercall.com/api/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
LayerCall MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
시작하는 데 비용이 얼마나 드나요?
신용카드 등록 없이 월 1,000회의 조회가 포함된 무료 API 키를 받을 수 있으며 일일 제한도 없습니다.
사기 검사 시 어떤 정보가 반환되나요?
모든 엔드포인트는 0~100 사이의 위험 점수, allow, review 또는 block 판정, 그리고 점수의 근거가 되는 구체적인 시그널을 반환합니다.
실제 데이터를 사용하거나 비용을 지불하지 않고 API를 테스트할 수 있나요?
네, test-mode 키를 사용하면 실제 데이터 소스를 호출하거나 비용을 발생시키지 않으면서 운영 환경과 동일한 구조 및 필드를 가진 결정론적 합성 데이터를 반환합니다.