MCP server de LayerCall
Commit 11 nov 2026Permite que los agentes de IA realicen verificaciones de fraude en IPs, correos electrónicos, números de teléfono, dominios y dispositivos para evaluar puntuaciones de riesgo y veredictos.
También conocido como LayerCall/layercall-sdk, layercall-sdk
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.0.0
- Último commit
- 11 nov 2026
- Licencia
- MIT
¿Qué es LayerCall MCP?
LayerCall es un MCP server. Permite que los agentes de IA realicen verificaciones de fraude en IPs, correos electrónicos, números de teléfono, dominios y dispositivos para evaluar puntuaciones de riesgo y veredictos.
Resumen generado a partir del README del proyecto
Acerca del MCP server de LayerCall
LayerCall ofrece un MCP server remoto que permite a los agentes de IA realizar detección de fraude y evaluación de riesgos en tiempo real. Los desarrolladores pueden conectar clientes como Claude Desktop, Cursor o VS Code al servicio mediante una URL y una API key. Esta configuración permite que una IA evalúe la legitimidad de diversos identificadores durante una conversación sin necesidad de instalaciones locales.
El servidor expone siete herramientas específicas: score_ip, verify_email, lookup_phone, score_domain, score_device, verify_agent y score_user. Estas herramientas devuelven una puntuación de riesgo de 0 a 100, un veredicto de allow, review o block, y señales específicas, como si una IP es una VPN o un proxy. El servicio está diseñado para ayudar a identificar bots, correos desechables y registros fraudulentos mediante el análisis de puntos de datos como la antigüedad del dominio, tipos de líneas telefónicas y huellas digitales de dispositivos.
Qué puedes hacer con él
- 1Verificar la legitimidad de correos electrónicosEl agente puede comprobar si una dirección de correo electrónico es desechable o pertenece a una cuenta de rol.
- 2Autenticar agentes de IAEl sistema puede utilizarse para demostrar que un agente de IA es realmente quien dice ser.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar LayerCall MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar LayerCall MCP en Claude Code
$ claude mcp add --transport http layercall-sdk https://www.layercall.com/api/mcpInstalar LayerCall MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"layercall-sdk": {
"url": "https://www.layercall.com/api/mcp"
}
}
}Instalar LayerCall MCP en VS Code
.vscode/mcp.json
{
"servers": {
"layercall-sdk": {
"type": "http",
"url": "https://www.layercall.com/api/mcp"
}
}
}Instalar LayerCall MCP en VS Code CLI
$ code --add-mcp '{"name":"layercall-sdk","type":"http","url":"https://www.layercall.com/api/mcp"}'Instalar LayerCall MCP en Codex
$ codex mcp add layercall-sdk --url https://www.layercall.com/api/mcpInstalar LayerCall MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.layercall-sdk] url = "https://www.layercall.com/api/mcp"
Instalar LayerCall MCP en Gemini CLI
$ gemini mcp add -s user --transport http layercall-sdk https://www.layercall.com/api/mcpInstalar LayerCall MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"layercall-sdk": {
"url": "https://www.layercall.com/api/mcp",
"type": "http"
}
}
}Configuración
LAYERCALL_API_KEY
| Nombre | Descripción | Tipo |
|---|---|---|
| LAYERCALL_API_KEY | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblelayercall/layercall-sdk is public and reachablegithub.com/layercall/layercall-sdk ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-11github.com/layercall/layercall-sdk ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 918 msAprobado
README
Ver en 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
Preguntas sobre LayerCall MCP
¿Cómo agrego LayerCall MCP a Claude Code?
Ejecuta claude mcp add --transport http layercall-sdk https://www.layercall.com/api/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego LayerCall MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cuánto cuesta empezar?
Puedes obtener una API key gratuita que incluye 1,000 consultas al mes sin necesidad de tarjeta de crédito y sin límite diario.
¿Qué información devuelve una verificación de fraude?
Cada endpoint devuelve una puntuación de riesgo del 0 al 100, un veredicto de allow, review o block, y las señales específicas detrás de esa puntuación.
¿Puedo probar la API sin usar datos reales o incurrir en costos?
Sí, las llaves en modo de prueba devuelven datos sintéticos deterministas que mantienen la misma estructura y campos que la producción, pero sin generar cargos ni consultar fuentes en vivo.