MCP server LayerCall
Commit 11 de nov. de 2026Permite que agentes de IA realizem verificações de fraude em IPs, e-mails, números de telefone, domínios e dispositivos para avaliar pontuações de risco e vereditos.
Também conhecido como LayerCall/layercall-sdk, layercall-sdk
- Stars
- 0
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 1.0.0
- Último commit
- 11 de nov. de 2026
- Licença
- MIT
O que é o MCP LayerCall?
Permite que agentes de IA realizem verificações de fraude em IPs, e-mails, números de telefone, domínios e dispositivos para avaliar pontuações de risco e vereditos.
Resumo gerado a partir do README do projeto
Sobre o MCP server de LayerCall
A LayerCall fornece um MCP server remoto que permite que agentes de IA realizem detecção de fraude e avaliação de risco em tempo real. Desenvolvedores podem conectar clientes como Claude Desktop, Cursor ou VS Code ao serviço via URL e uma chave de API. Essa configuração permite que uma IA avalie a legitimidade de vários identificadores durante uma conversa sem exigir instalações locais.
O servidor expõe sete ferramentas específicas: score_ip, verify_email, lookup_phone, score_domain, score_device, verify_agent e score_user. Essas ferramentas retornam uma pontuação de risco de 0 a 100, um veredito de allow, review ou block, e sinais específicos, como se um IP é uma VPN ou um proxy. O serviço foi projetado para ajudar a identificar bots, e-mails descartáveis e cadastros fraudulentos por meio da análise de pontos de dados como idade do domínio, tipos de linha telefônica e fingerprints de dispositivos.
O que você pode fazer com ele
- 1Verificar a legitimidade de e-mailsO agente pode verificar se um endereço de e-mail é descartável ou pertence a uma conta de função (role account).
- 2Autenticar agentes de IAO sistema pode ser usado para provar que um agente de IA é realmente quem ele afirma ser.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP LayerCall
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP LayerCall no Claude Code
$ claude mcp add --transport http layercall-sdk https://www.layercall.com/api/mcpInstalar o MCP LayerCall no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"layercall-sdk": {
"url": "https://www.layercall.com/api/mcp"
}
}
}Instalar o MCP LayerCall no VS Code
.vscode/mcp.json
{
"servers": {
"layercall-sdk": {
"type": "http",
"url": "https://www.layercall.com/api/mcp"
}
}
}Instalar o MCP LayerCall no VS Code CLI
$ code --add-mcp '{"name":"layercall-sdk","type":"http","url":"https://www.layercall.com/api/mcp"}'Instalar o MCP LayerCall no Codex
$ codex mcp add layercall-sdk --url https://www.layercall.com/api/mcpInstalar o MCP LayerCall no Codex config.toml
~/.codex/config.toml
[mcp_servers.layercall-sdk] url = "https://www.layercall.com/api/mcp"
Instalar o MCP LayerCall no Gemini CLI
$ gemini mcp add -s user --transport http layercall-sdk https://www.layercall.com/api/mcpInstalar o MCP LayerCall no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"layercall-sdk": {
"url": "https://www.layercall.com/api/mcp",
"type": "http"
}
}
}Configuração
LAYERCALL_API_KEY
| Nome | Descrição | Tipo |
|---|---|---|
| LAYERCALL_API_KEY | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívellayercall/layercall-sdk is public and reachablegithub.com/layercall/layercall-sdk ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-11github.com/layercall/layercall-sdk ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPinitialize answered with protocol 2025-06-18 in 918 msPassou
README
Ver no GitHubLayerCall 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
Perguntas sobre o MCP LayerCall
Como adiciono o MCP LayerCall ao Claude Code?
Execute claude mcp add --transport http layercall-sdk https://www.layercall.com/api/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP LayerCall ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quanto custa para começar?
Você pode obter uma chave de API gratuita que inclui 1.000 consultas por mês, sem necessidade de cartão de crédito e sem limite diário.
Quais informações são retornadas em uma verificação de fraude?
Cada endpoint retorna uma pontuação de risco de 0 a 100, um veredito de allow, review ou block, e os sinais específicos por trás da pontuação.
Posso testar a API sem usar dados reais ou incorrer em custos?
Sim, as chaves de modo de teste retornam dados sintéticos determinísticos que seguem o mesmo formato e campos da produção, sem cobrança ou consulta a fontes reais.