Generate Data

Public MCP server for Generate-Data.com. Thin HTTP wrapper — no generation logic in this repo.

Monorepo sync: A copy of this package also lives in the main generate-data.com repo under generate-data-mcp/. This repository is the canonical published source.

Tools

V2.1: list_projects and generate_project require a Premium API key.

Tool examples

generate_data — minimum payload:

{
  "fields": [
    {"name": "first_name", "type": "first_name", "options": {}},
    {"name": "email", "type": "email", "options": {}}
  ],
  "num_rows": 10,
  "format": "csv"
}

propose_schema — prompt: "E-commerce customers with name, email, and signup date"

get_api_usage — no parameters; returns calls today, rows generated, tier.

Tier limits (API key)

Limits are enforced by the Django API, not this MCP server.

Configuration

Create an API key in Settings → API Access on generate-data.com.

Install

pip install git+https://github.com/generate-data/generate-data-mcp.git
# or for development:
git clone https://github.com/generate-data/generate-data-mcp.git
cd generate-data-mcp
pip install -e ".[dev]"

Claude Desktop / Cursor

{
  "mcpServers": {
    "generate-data": {
      "command": "python",
      "args": ["-m", "generate_data_mcp.server"],
      "env": {
        "GENERATE_DATA_API_KEY": "your-uuid-key-here",
        "GENERATE_DATA_API_BASE_URL": "https://api.generate-data.com"
      }
    }
  }
}

For local development against a running Django backend:

"GENERATE_DATA_API_BASE_URL": "http://localhost:8000"

Run

export GENERATE_DATA_API_KEY=your-key
python -m generate_data_mcp.server

Verify

1. export GENERATE_DATA_API_KEY=...
2. Invoke get_api_usage from your MCP client — should return tier and call counts.
3. Invoke list_field_types — should return category map.

Troubleshooting

Tests

pip install -e ".[dev]"
pytest tests/ -v

API docs

See docs/API_V2.md in the main repo.