ffraud

The official CLI and MCP server of FFraud, the free fraud-detection API.
Website · Docs · MCP setup · OpenAPI

FFraud's open fraud database as a CLI and an MCP server. Five tools, no key.

npx ffraud site example.com      # a whole website's security, every finding with its fix
npx ffraud ip 185.220.101.34     # fraud score, VPN, proxy, Tor, network, abuse

tool	what it answers
site_check	How secure is this whole website? Certificate, security headers, cookies, http to https, SPF, DMARC and MX, the domain and its addresses in FFraud's data, bot protection: a 0-100 score, a grade, and every finding with the exact fix.
ip_check	Is this IP a VPN, proxy, Tor node, relay or datacenter host? What is its 0-100 fraud score, who runs the network, where is it, and how much of its /24 is flagged?
email_check	Is this address disposable, a role account, or community-blacklisted?
domain_check	Does this domain hand out throwaway mailboxes, or appear in the phishing dataset?
ip_reports	What did the community actually report this IP for, and when?

Use it as a CLI

npx ffraud site example.com
npx ffraud site example.com --fresh   # again, after you changed the site
npx ffraud ip 45.33.32.156
npx ffraud email throwaway@mailinator.com
npx ffraud domain mailinator.com
npx ffraud reports 45.33.32.156

Every command prints JSON, so it pipes into jq like anything else. npm install -g ffraud puts ffraud on your path.

Use it as an MCP server

The same five tools run on ffraud.com as a remote MCP server, with nothing to install: https://ffraud.com/api/mcp (Streamable HTTP). Claude Code: claude mcp add --transport http ffraud https://ffraud.com/api/mcp. Every client, step by step: https://ffraud.com/docs/mcp

For a client that runs local servers, this package speaks MCP over stdio:

{
  "mcpServers": {
    "ffraud": {
      "command": "npx",
      "args": ["-y", "ffraud", "mcp"]
    }
  }
}

Claude Code: claude mcp add ffraud -- npx -y ffraud mcp

It speaks JSON-RPC 2.0 over stdio. stdout is the protocol, so every log line goes to stderr.

Keys

Nothing here needs one. Every tool calls a public endpoint.

FFRAUD_API_KEY is forwarded as X-API-Key when set (the only header the engine reads a key from), which raises burst limits and site_check's hourly allowance, and nothing else. No tool in this package can spend money, change an account, or write to the database. FFRAUD_BASE_URL overrides the API base for local development.

Batch behavior worth knowing

ip_check takes up to 50 addresses. With a key it uses the batch endpoint in one call; without one it fans out over the public route rather than failing, so the tool works for everybody. A single address always takes the single-address path.

Rate limits

The public endpoints rate limit rather than fail. A 429 comes back as a readable message with the retry delay, so a model waits instead of retrying in a loop.

site_check reaches out to a real website, so it has an hourly allowance: 20 fresh checks per address without a key, 300 per account with one. A site checked in the last ten minutes answers from memory and costs nothing; after a change, fresh: true (CLI: --fresh) checks again unless the site was checked in the last minute. The four lookups have no usage caps.

Zero dependencies

Node 18+ has fetch. An assistant that has to install a dependency tree before it can check an IP will not bother, so there is nothing to install.

Related

• MCP docs: https://ffraud.com/docs/mcp
• API docs: https://ffraud.com/docs
• OpenAPI spec: https://ffraud.com/openapi.json
• For AI: https://ffraud.com/llms.txt and https://ffraud.com/llms-full.txt
• Open data (MIT): https://github.com/FFraud-com