MCP server de Arnakoff
Commit 12 nov 2026Permite que un cliente de IA verifique sitios web, correos electrónicos, números de teléfono, IBAN o números SIREN contra fuentes antifraude y listas negras.
También conocido como arnakoff/api, api
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.0.0
- Último commit
- 12 nov 2026
- Licencia
- AGPL-3.0
¿Qué es Arnakoff MCP?
Arnakoff es un MCP server. Permite que un cliente de IA verifique sitios web, correos electrónicos, números de teléfono, IBAN o números SIREN contra fuentes antifraude y listas negras.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Arnakoff
Arnakoff ofrece un servicio de verificación antifraude diseñado para ayudar a desarrolladores y clientes de IA a identificar riesgos potenciales asociados con identificadores específicos. Al contrastar sitios web, direcciones de correo electrónico, números de teléfono, IBAN o números SIREN con listas negras públicas y registros oficiales, el servidor devuelve señales basadas en hechos en lugar de acusaciones. Cruza datos con fuentes como las listas negras de la AMF y el ACPR, el directorio SIRENE y la numeración de ARCEP para proporcionar contexto en francés.
Los usuarios pueden integrar este servicio como un MCP server remoto mediante una solicitud POST o ejecutarlo localmente usando el método stdio con el comando cmd/mcp. El acceso requiere una clave de API gratuita que se obtiene mediante un proceso de solicitud por correo electrónico. El sistema prioriza la privacidad asegurando que los datos personales, como correos electrónicos e IBAN, nunca se registren en texto plano ni se compartan con terceros. También mantiene una alta integridad de datos rechazando instantáneas de fuentes que muestren una pérdida significativa de entradas durante la sincronización.
Qué puedes hacer con él
- 1Verificar la legitimidad empresarialComprueba si el número SIREN de una empresa es válido y está reconocido por los registros oficiales franceses.
- 2Detectar sitios web fraudulentosIdentifica si un dominio figura en las listas negras de autoridades financieras o si tiene una antigüedad sospechosa.
- 3Evaluar identificadores financierosValida IBAN frente a señales de fraude conocidas sin comprometer la privacidad del usuario.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Arnakoff MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Arnakoff MCP en Claude Code
$ claude mcp add --transport http api https://api.arnakoff.com/mcpInstalar Arnakoff MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"api": {
"url": "https://api.arnakoff.com/mcp"
}
}
}Instalar Arnakoff MCP en VS Code
.vscode/mcp.json
{
"servers": {
"api": {
"type": "http",
"url": "https://api.arnakoff.com/mcp"
}
}
}Instalar Arnakoff MCP en VS Code CLI
$ code --add-mcp '{"name":"api","type":"http","url":"https://api.arnakoff.com/mcp"}'Instalar Arnakoff MCP en Codex
$ codex mcp add api --url https://api.arnakoff.com/mcpInstalar Arnakoff MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.api] url = "https://api.arnakoff.com/mcp"
Instalar Arnakoff MCP en Gemini CLI
$ gemini mcp add -s user --transport http api https://api.arnakoff.com/mcpInstalar Arnakoff MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"api": {
"url": "https://api.arnakoff.com/mcp",
"type": "http"
}
}
}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 accesiblearnakoff/api is public and reachablegithub.com/arnakoff/api ↗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)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-12github.com/arnakoff/api ↗Aprobado
- OpenSSF ScorecardOpenSSF Scorecard 7.4 / 10; weakest: Code-Review 0, Maintained 0, CII-Best-Practices 0scorecard.dev/viewer/?uri=github.com/arnakoff/api ↗Aprobado
- 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 MCPHTTPS endpoint answered 401 (sign-in required)Aprobado
README
Ver en GitHubArnakoff API
API publique anti-arnaque : pour un site, un e-mail, un numéro de téléphone, un IBAN ou un SIREN, elle renvoie des signaux sourcés expliqués en français.
Statut
En service depuis le 06/11/2026, version 1.0.0 : https://api.arnakoff.com. Le contrat (api/openapi.yaml) est stable : un changement cassant passera par une nouvelle version majeure ou par une dépréciation annoncée (Deprecation, Sunset). La clé est gratuite et s'obtient par un lien de connexion envoyé par e-mail (POST /v1/keys/request) ; la page du site qui la demande n'est pas encore en ligne. Suis la suite dans la feuille de route.
Ce que fait l'API
Tu lui donnes une entrée ; elle la confronte à des sources publiques (listes noires de l'AMF et de l'ACPR, répertoire SIRENE, BODACC, âge du domaine, numérotation de l'ARCEP…) et renvoie une liste de signaux. Chaque signal porte :
code: identifiant stable du signal ;level: niveau du signal ;message: une phrase factuelle en français, par exemple « Figure sur la liste noire de l'AMF depuis le 08/10/2026 » ;sourceetsource_url: l'éditeur de la donnée et où la vérifier ;observed_at: la date à laquelle la donnée a été relevée.
Les signaux prévus sont dans docs/signals.md, les sources et leurs licences dans docs/sources.md. L'API est aussi exposée comme serveur MCP : à distance sur POST /mcp, avec la même clé et le même quota que /v1/check, ou en local avec cmd/mcp (stdio). Il figure dans le registre MCP officiel sous le nom com.arnakoff/api.
Principes
- Jamais « sûr ». Sans signal, la réponse est « Aucun signal connu dans nos sources » : l'absence d'une liste noire ne prouve rien.
- Des faits, pas des accusations. Chaque signal cite sa source ; aucun message ne qualifie une entité nommée d'arnaque.
- Des licences d'abord. Une source n'est utilisée que si sa licence autorise la réutilisation commerciale.
- Les données personnelles protégées. Les e-mails, numéros et IBAN ne sont jamais journalisés en clair ni transmis à un tiers.
- Aucune URL fournie par l'utilisateur n'est appelée. Les registres sont interrogés par identifiant, à travers une liste d'hôtes autorisés.
- Une synchronisation prudente. Un instantané de source invalide, ou qui perd plus de 20 % de ses entrées, est rejeté ; le précédent reste en service.
Démarrer
Il te faut Go 1.27 : la version exacte (toolchain go1.27.3) est dans go.mod et se télécharge d'elle-même. Installe aussi golangci-lint à la version indiquée dans docs/standards.md.
go build ./...
go vet ./...
golangci-lint run
go test -race -shuffle=on ./...
go tool govulncheck ./... tool
La CI lance les mêmes commandes sur chaque pull request. Les tests n'utilisent jamais le réseau.
Avec Docker, l'image (Dockerfile) contient les commandes api, sync et admin sur une base distroless sans shell, exécutées par un utilisateur non root. compose.yaml lance l'API et la synchronisation, qui partagent le volume des instantanés :
cp .env.example .env # renseigner ARNAKOFF_LOG_KEY, ARNAKOFF_DATABASE_URL et ARNAKOFF_API_KEY_SECRET
docker compose up --build
Chaque version publiée (tag vX.Y.Z) produit l'image ghcr.io/arnakoff/api pour linux/amd64 et linux/arm64, taguée X.Y.Z, X.Y et latest, avec son SBOM et son attestation de provenance. Elle est signée sans clé par cosign depuis le workflow image.yml ; pour vérifier la signature d'une version (ici 0.48.0) :
cosign verify ghcr.io/arnakoff/api:0.48.0 \
--certificate-identity https://github.com/arnakoff/api/.github/workflows/image.yml@refs/tags/v0.48.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
Le SBOM et la provenance se lisent avec docker buildx imagetools inspect ghcr.io/arnakoff/api:0.48.0 --format '{{ json .SBOM.SPDX }}' (ou '{{ json .Provenance.SLSA }}').
Organisation
Architecture propre (ADR 0002) : les dépendances vont vers l'intérieur uniquement.
| Dossier | Rôle |
|---|---|
internal/domain/ |
Objets métier, normalisation des entrées et règles des signaux, sans entrée-sortie. |
internal/app/ |
Cas d'usage (vérification, synchronisation) et interfaces dont ils ont besoin. |
internal/adapter/ |
Sources, registres, stockage, API HTTP et serveur MCP. |
internal/platform/ |
Client HTTP sortant, journaux, configuration. |
cmd/ |
Points d'entrée : api, sync, mcp et eval. |
Documentation
- Décisions d'architecture : 0001 — Socle technique, 0002 — Architecture propre, 0003 — Licences, 0004 — Stockage des clés et des quotas, 0005 — Hébergement de production, 0006 — Durées de conservation, 0007 — Rotation automatique des clés, 0008 — Offres, prix et quotas.
- Standards et versions, sources, signaux.
- Le site et la documentation publique de l'API sont dans
arnakoff/web.
Contribuer
Lis CONTRIBUTING.md. Pour une faille de sécurité, suis la politique de sécurité, jamais une issue publique. Pour de l'aide, vois SUPPORT.md.
Licence
Le code est sous GNU AGPL-3.0-only (ADR 0003). Les données gardent la licence de leur source, indiquée dans docs/sources.md.
Preguntas sobre Arnakoff MCP
¿Cómo agrego Arnakoff MCP a Claude Code?
Ejecuta claude mcp add --transport http api https://api.arnakoff.com/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Arnakoff 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.
¿Qué puedo verificar con la API de Arnakoff?
Puedes comprobar un sitio web, un correo electrónico, un número de teléfono, un IBAN o un número SIREN en busca de señales antifraude.
¿La falta de señales significa que una fuente es segura?
No, la ausencia de una señal en una lista negra no demuestra nada; el sistema nunca tiene una 'certeza' absoluta.
¿Cómo obtengo una clave de API?
La clave es gratuita y se obtiene mediante un enlace de inicio de sesión enviado por correo electrónico a través del endpoint POST /v1/keys/request.
¿Están protegidos mis datos personales?
Sí, los correos electrónicos, números de teléfono e IBAN nunca se registran en texto plano ni se transmiten a terceros.