# 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):
```json
{
"mcpServers": {
"fauxgen": {
"command": "npx",
"args": ["-y", "fauxgen-mcp"]
}
}
}
```
### Claude Desktop
`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
```json
{
"mcpServers": {
"fauxgen": {
"command": "npx",
"args": ["-y", "fauxgen-mcp"]
}
}
}
```
### CLI
```bash
npx -y fauxgen-mcp
```
## Tools
| Tool | What you get |
|------|----------------|
| `generate_identity` | Full persona: name, address, phone, email, job, test cards |
| `generate_name` / `generate_address` / `generate_phone` | Locale-aware building blocks |
| `generate_email` / `generate_username` / `generate_password` | Auth-fixture staples |
| `generate_credit_card` | Luhn-valid **test** Visa / MC / Amex |
| `generate_iban` | mod-97 **test** IBAN |
| `generate_company` | Company + domain + buzzphrase |
| `generate_uuid` / `generate_ip` / `generate_mac` / `generate_user_agent` | Device & network junk food |
| `generate_crypto_wallet` | Random-looking BTC / ETH strings |
| `list_countries` | All supported country codes |
| `fauxgen_tool_url` | Deep-link into the visual web tools (WhatsApp chats, plates, QR…) |
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
```bash
npm install
npm run build
npm start
npm run typecheck
```
## License
MIT © FauxGen — [fauxgen.com](https://fauxgen.com)