Generate-Data MCP server
io.github.ns-3e/generate-data-mcp·v2.0.1MCP server for Generate-Data.com: dataset generation, AI schema design, Project management.
0 stars23 downloads/wk
Reviews
Write oneNobody has reviewed Generate-Data yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Generate-Data tools (7)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
gd_design_schemaDesign a dataset schema from natural language — one tool for both the first proposal and follow-up refinements. Behavior branches on args: - First call (propose): pass only `prompt` (and optionally `locale`, e.g. 'en_US', 'fr_FR'). `messages`/`current_schema` left unset. - Refine call: pass BOTH `messages` (the running conversation, list of `{"role": "user"|"assistant", "content": str}`) AND `curr
gd_generate_datasetGenerate synthetic dataset rows from a field list. Use this when the user wants actual generated data (as opposed to schema design or field-type discovery). `fields` is a list of `{"name": str, "type": str, "options": dict}` (get valid `type` values from `gd_list_field_types`/`gd_get_field_type_options`). `format` must be one of `csv`, `json`, `xml`, `parquet`, `zip` (anything else returns an `uns
gd_generate_projectGenerate all tables in a Project and download the result (Premium tier only). `project_id` must be a positive integer (get one from `gd_list_projects`). `format` must be one of `csv`, `json`, `xml`, `parquet`, `zip` (default `zip`; anything else returns `unsupported_format`). Non-Premium API keys get a `tier_forbidden` error — upgrade the Generate-Data.com plan to use this tool. Returns the JSON e
gd_get_field_type_optionsGet the configuration option schema for one field type (e.g. what options `email` or `date` accept). Use this before building a `fields` entry for `gd_generate_dataset` that needs non-default options. `field_type` must match `^[a-z0-9_]+$` (lowercase letters, digits, underscore only) — anything else returns `invalid_input` without calling upstream. Returns the option schema in `data`.
gd_get_usageGet current API key usage stats (calls today, tier, limits). Use this to check remaining quota or confirm which tier the configured API key has before attempting a premium-only call. Takes no arguments. Returns the usage stats in `data`.
gd_list_field_typesList all available field types grouped by category. Use this to discover valid `type` values before calling `gd_generate_dataset` or to look up which category a field type belongs to. Takes no arguments. Returns the categorized field-type catalog in `data.categories`.
gd_list_projectsList the user's Projects (Premium tier only). Use this to discover `project_id` values before calling `gd_generate_project`. `limit` (default 20, max 100) and `offset` (default 0) page through the results; results are paginated client-side since the upstream API returns the full list. Non-Premium API keys get a `tier_forbidden` error — upgrade the Generate-Data.com plan to use this tool. Returns t
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 15 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Generate-Data compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 70% of 1,337 Media servers
- Tools
- 7
- the typical Media server has 7
- Tools that change things
- 0%
- typical: 4%. Fewer write tools means less an agent can break
- Downloads a week
- 23
- more than 9% of 365 Media servers with a package
What its tools let an agent do: 7 read
Install Generate-Data in Claude Code, Cursor or VS Code
claude mcp add generate-data-mcp -- uvx generate-data-mcp
What the publisher says
From the Generate-Data repository's README, as published. We do not edit it. Read it on GitHub
generate-data-mcp
<!-- mcp-name: io.github.ns-3e/generate-data-mcp -->
An MCP server for Generate-Data.com — generate synthetic datasets, design schemas from natural language, and manage Projects, straight from your agent.
Thin HTTP wrapper over the Generate-Data.com API. No generation logic lives in this repo — it's a curated, agent-friendly interface onto the real thing: 7 tools, one consistent response shape, binary-safe output, and server-side validation on every input.
Installation (30-second setup)
You need a Generate-Data.com API key first — create one in Settings → API Access on generate-data.com.
Claude Desktop / Cursor (recommended)
Add this to your MCP client config (Claude Desktop: claudedesktopconfig.json; Cursor: .cursor/mcp.json):
{
"mcpServers": {
"generate-data": {
"command": "uvx",
"args": ["generate-data-mcp"],
"env": {
"GENERATE_DATA_API_KEY": "your-uuid-key-here"
}
}
}
}uvx fetches and runs the latest published version on demand — no separate install step, nothing to update by hand. Restart your client and the 7 gd_* tools are available.
Do not commit a config file containing your real API key.
uv / uvx (any MCP client)
# run once, ad hoc:
uvx generate-data-mcp
# or install it as a persistent CLI tool:
uv tool install generate-data-mcppip (fallback)
pip install generate-data-mcpFor local development against this repo directly:
git clone https://github.com/ns-3e/generate-data-mcp.git
cd generate-data-mcp
pip install -e ".[dev]"Verify it works
export GENERATE_DATA_API_KEY=your-key
generate-data-mcpFrom your MCP client, invoke gdgetusage — it should return your tier and call counts. Then invoke gdlistfield_types — it should return the category map.
Bam — you're ready to generate data.
Ask your agent something like "generate 50 rows of fake e-commerce customers as CSV" and it will call gddesignschema then gdgeneratedataset on its own.
Quick start
A typical session looks like this — the agent chains tools on its own, you just describe the outcome:
- Discover what's possible. gdlistfield_types — see every field type, grouped by category.
- Design a schema. gddesignschema(prompt="E-commerce customers with name, email, and signup date") — proposes a fields array from plain English.
- Generate the data. gdgeneratedataset(fields=..., num_rows=10, format="csv") — returns the rows.
- Refine if needed. Call gddesignschema again, this time passing messages (the running conversation) + current_schema (the prior result) together — it refines instead of proposing fresh.
Every tool returns the same envelope: {"ok": true, "summary": "...", "data": {...}} on success, or {"ok": false, "error": {"code": ..., "message": ...}} on failure — errors always tell you what to do next, never a raw stack trace.
Local development
{
"env": { "GENERATE_DATA_API_BASE_URL": "http://localhost:8000" }
}Point at a locally running Django backend instead of the hosted API.
Migrating from v1
v2.0.0 renames every tool (breaking change). Old name → new name:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Generate-Data: common questions
- Is Generate-Data MCP server safe?
- Mostly: it is graded B (83/100). Read the Generate-Data safety report
- How do I install Generate-Data?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Generate-Data need an API key?
- Yes. The registry entry asks for
GENERATE_DATA_API_KEY. - Is Generate-Data maintained?
- The last commit was 57 days ago (2026-09-08). The latest release is v2.0.1.
- What can I use instead of Generate-Data?
- Servers from other publishers that do the same job: AiNecto MCP server, Dembrandt MCP server and KiCad MCP Pro MCP server.
- How does Generate-Data compare with other Media MCP servers?
- safety score 83/100 (higher than 70% of 1,337 Media servers); tools 7 (the typical Media server has 7); tools that change things 0% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Generate-Data
Same job from other publishers: the closest match first, then the best rated.
AiNectoShared project memory for people and AI agents: documents, ERD, diagrams, boards, design mockups.not reviewedGrowingA- DembrandtDesign tokens from any live site: colours, type, spacing, components, drift against a baseline.not reviewedWidely usedB
KiCad MCP ProProduction-grade MCP server for KiCad EDA—PCB design, DRC, simulation, BOM, DFM, and manufacturing.not reviewedEstablishedA- SuperCMOMarketing media generation — image, video, voice — for AI agents. BYO keys.not reviewedEstablishedB
- Figma MCP ServerThe Figma MCP server brings Figma design context directly into your AI workflow.not reviewedEstablishedA