Fauxgen MCP

fauxgen-mcp

Fake data for agents.

MCP server that gives Cursor, Claude, Windsurf & friends instant fictional identities,

addresses, phones, Luhn test cards and more — powered by the same idea as fauxgen.com.

Why

Agents write forms, seeds and Playwright fixtures all day. They shouldn't invent SSNs from thin air or paste the same John Doe forever.

You:  seed a German checkout user
Agent: → generate_identity({ country: "de" })
       → valid-looking DE address, phone, IBAN-ready country, test Visa…

Install (30 seconds)

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

CLI

npx -y fauxgen-mcp

Tools

Also ships a seed_test_user prompt and a fauxgen://overview resource.

66 countries — same coverage as the website.

Safety

All output is fictional test data. Do not use it to deceive people, open real accounts, or commit fraud. Test cards and IBANs pass checksums so your validators work — they are not real payment instruments.

Develop

npm install
npm run build
npm start
npm run typecheck

License

MIT © FauxGen — fauxgen.com