# Misata: synthetic data library

Builds relational synthetic datasets with matching foreign keys and exact mathematical totals. Useful for seeding databases and validating business logic locally.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 70
- Author: rasinmuhammed
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rasinmuhammed/misata
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/misata-synthetic-data-library

## What it does

Misata turns natural language stories, YAML schemas, or existing database connections into multi-table relational data. Instead of randomly generating numbers column by column, it works backwards from target outcomes. Order totals, churn rates, and balance sums reconcile down to the cent without machine learning models.

The engine enforces relational integrity across all generated tables. Timestamps follow chronological logic, and foreign keys remain valid throughout the set. Built-in `audit` and `realism` commands scan output CSV files for contradictions like deliveries preceding order dates.

You need `uv` installed in your environment to execute `uvx misata`. Without Python and the tool runner available, the coding assistant cannot spin up the server.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add misata -- uvx misata
```
uvx runs the command named after the package; if the README names another one, use uvx --from misata <command>

### Codex

**Platform CLI**
```bash
codex mcp add misata-synthetic-data-library -- uvx misata
```
uvx runs the command named after the package; if the README names another one, use uvx --from misata <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "misata-synthetic-data-library": {
            "command": "uvx",
            "args": [
                "misata"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from misata <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "misata-synthetic-data-library": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "misata"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from misata <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add misata-synthetic-data-library uvx misata
```
uvx runs the command named after the package; if the README names another one, use uvx --from misata <command>

## When to use it
- populate relational tables without orphan foreign keys
- reconcile aggregate row sums to exact financial targets
- fill database columns with domain-authentic text
- audit generated datasets for chronological and logical conflicts

## Example prompts
- Generate a synthetic database for an e-commerce platform with 500 customers and realistic order amounts
- Build tables from `misata.yaml` and verify foreign key consistency
- Audit the generated CSV files in `./data` for date contradictions

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md