FauxGenfauxgen▊
agents · open source

Fake data inside your agent

fauxgen-mcp is an MCP server for Cursor, Claude Desktop and any MCP host. One tool call → a full fictional identity for fixtures, Playwright and demos.

npx -y fauxgen-mcp · v0.1.0 · MIT

30s
Install

Drop JSON into Cursor / Claude — no API key.

17
Tools

Identity, address, phone, cards, IBAN, crypto…

66
Countries

Same locale coverage as the website.

Install in Cursor

Project file .cursor/mcp.json or global ~/.cursor/mcp.json

.cursor/mcp.json
{
  "mcpServers": {
    "fauxgen": {
      "command": "npx",
      "args": ["-y", "fauxgen-mcp"]
    }
  }
}

Install in Claude Desktop

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

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

MCP tools

Every call returns JSON plus a web link back to FauxGen.

Source on GitHub →
generate_identityFull persona: name, address, phone, email, job, test cards
generate_nameLocale-aware first + last name
generate_addressStreet address for 66 countries
generate_phoneNational + international phone
generate_emailFictional emails (bulk)
generate_usernameUsernames for auth fixtures
generate_passwordConfigurable random passwords
generate_credit_cardLuhn-valid test Visa / MC / Amex
generate_ibanmod-97 test IBAN
generate_companyCompany name, domain, catchphrase
generate_uuidUUID v4
generate_ipIPv4 / IPv6
generate_macMAC addresses
generate_user_agentBrowser user-agent strings
generate_crypto_walletBTC / ETH-looking addresses
list_countriesAll country codes + dial codes
fauxgen_tool_urlDeep-link to visual web tools
try it

Prompt your agent

After install, ask: “Use FauxGen to seed a Japanese checkout user as JSON fixtures.” The model should call generate_identity with country: "jp".

Need a WhatsApp screenshot or plate image? Ask for fauxgen_tool_url — those stay browser-side on the site.

Test data only. Everything on this page is randomly generated for software testing, QA, education and design. It does not belong to real people, accounts or devices. Never use generated data to register on services, deceive anyone or commit fraud — that is illegal.

FAQ

What is an MCP server?+

Model Context Protocol lets AI apps (Cursor, Claude, Windsurf…) call external tools. FauxGen MCP exposes fake-data generators so the agent can seed fixtures without inventing broken SSNs by hand.

Is it free / open source?+

Yes. MIT license on GitHub. Install with npx — no API key for the local generators.

Does MCP replace the website?+

No. MCP is for JSON fixtures inside your editor. Chat screenshots, plate images, barcodes and AI faces stay on fauxgen.com in the browser.

Are the credit cards / IBANs real?+

No. They pass Luhn / mod-97 so your validators work. They are not issued accounts — never use them for real payments or KYC.

How do I update?+

npx -y fauxgen-mcp always pulls the latest published version. Pin a version in args if you need reproducibility.