MCP server
Realistic test data, straight from your AI assistant
Connect the Real Fake Data MCP server to Claude, Cursor, or any Model Context Protocol client, then ask for valid people, addresses, national IDs, and companies in plain language. Two tools, seeded on request, 304 generators across 27 EU countries.
Setup
Add the server to your MCP client config — it runs over stdio via npx, so there is nothing to install globally. Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client. Pass an API key through the env to use your metered plan; omit it for the anonymous lane.
{
"mcpServers": {
"real-fake-data": {
"command": "npx",
"args": ["-y", "@przeslijmi/real-fake-data-mcp"],
"env": {
"REAL_FAKE_DATA_API_KEY": "your-api-key"
}
}
}
}Ask in plain language
Once connected, the assistant discovers the generators with the list_generators tool and produces records with the generate tool — you just describe what you need. Set a seed when you want reproducible output, or a count for a batch.
You: Generate 3 female Polish people for my staging DB.
→ the assistant calls the "generate" tool:
{ "generator": "pl.person", "count": 3, "options": { "sex": "f" } }
→ and gets back 3 records:
{ "name": "Anna", "surname": "Wójcik",
"pesel": "87061766641", "birthDate": "1987-06-17" }Two tools
The surface is deliberately small and self-updating: discovery plus a single generate call keyed by generator id. New generators on the API appear automatically — no client upgrade.
| Tool | Purpose | Inputs |
|---|---|---|
| list_generators | Discover every generator with its id, description, and supported locales. | — |
| generate | Run one generator and return its { data, meta } records. | generator, options, count, seed |
Configuration
The client passes configuration through the server’s env. Both variables are optional — with no API key the server uses the rate-limited anonymous lane.
| Variable | Description |
|---|---|
| REAL_FAKE_DATA_API_KEY | Sent as a bearer token to use your metered plan. Omit for the anonymous lane. |
| REAL_FAKE_DATA_API_BASE_URL | Override the hosted API — point it at a self-hosted instance during development. |
Ready to wire it into your assistant?
Grab an API key, drop the server into your MCP client config, and start pulling realistic data into your workflow conversationally.