Arnakoff MCP server
Commit Nov 12, 2026Lets an AI client verify websites, emails, phone numbers, IBANs, or SIREN numbers against anti-fraud sources and blacklists.
Also known as arnakoff/api, api
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 12, 2026
- License
- AGPL-3.0
What is Arnakoff MCP?
Arnakoff lets an AI client verify websites, emails, phone numbers, IBANs, or SIREN numbers against anti-fraud sources and blacklists.
Summary generated from the project's README
About Arnakoff MCP server
Arnakoff provides an anti-fraud verification service designed to help developers and AI clients identify potential risks associated with specific identifiers. By checking websites, email addresses, phone numbers, IBANs, or SIREN numbers against public blacklists and official registries, the server returns factual signals rather than accusations. It cross-references data with sources like the AMF and ACPR blacklists, the SIRENE directory, and ARCEP numbering to provide context in French.
Users can integrate this service as a remote MCP server via a POST request or run it locally using the stdio method with the cmd/mcp command. Access requires a free API key obtained through an email request process. The system prioritizes privacy by ensuring that personal data like emails and IBANs are never logged in plain text or shared with third parties. It also maintains high data integrity by rejecting source snapshots that show significant entry loss during synchronization.
What you can do with it
- 1Verify business legitimacyCheck if a company's SIREN number is valid and recognized by official French registries.
- 2Detect fraudulent websitesIdentify if a domain is listed on financial authority blacklists or has a suspicious age.
- 3Screen financial identifiersValidate IBANs against known fraud signals without compromising user privacy.
Written from the project's README. Every use case is checked against a quote from it.
How to install Arnakoff MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Arnakoff MCP in Claude Code
$ claude mcp add --transport http api https://api.arnakoff.com/mcpInstall Arnakoff MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"api": {
"url": "https://api.arnakoff.com/mcp"
}
}
}Install Arnakoff MCP in VS Code
.vscode/mcp.json
{
"servers": {
"api": {
"type": "http",
"url": "https://api.arnakoff.com/mcp"
}
}
}Install Arnakoff MCP in VS Code CLI
$ code --add-mcp '{"name":"api","type":"http","url":"https://api.arnakoff.com/mcp"}'Install Arnakoff MCP in Codex
$ codex mcp add api --url https://api.arnakoff.com/mcpInstall Arnakoff MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.api] url = "https://api.arnakoff.com/mcp"
Install Arnakoff MCP in Gemini CLI
$ gemini mcp add -s user --transport http api https://api.arnakoff.com/mcpInstall Arnakoff MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"api": {
"url": "https://api.arnakoff.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablearnakoff/api is public and reachablegithub.com/arnakoff/api ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/arnakoff/api ↗Pass
- OpenSSF ScorecardOpenSSF Scorecard 7.4 / 10; weakest: Code-Review 0, Maintained 0, CII-Best-Practices 0scorecard.dev/viewer/?uri=github.com/arnakoff/api ↗Pass
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on 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.
Arnakoff MCP questions
How do I add Arnakoff MCP to Claude Code?
Run claude mcp add --transport http api https://api.arnakoff.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Arnakoff MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can I verify with the Arnakoff API?
You can check a website, an email, a phone number, an IBAN, or a SIREN number for anti-fraud signals.
Does a lack of signals mean a source is safe?
No, the absence of a signal from a blacklist does not prove anything; the system is never 'sure'.
How do I get an API key?
The key is free and obtained via a login link sent by email through the POST /v1/keys/request endpoint.
Is my personal data protected?
Yes, emails, phone numbers, and IBANs are never logged in plain text or transmitted to third parties.