MockHero

Generate realistic relational test data — 156 field types, 22 locales, JSON/CSV/SQL, free previews.

DatabasesTypeScriptv0.2.0

MockHero

smithery badge

Synthetic test data API. Generate realistic, relational data for any database schema.

What it does

  • 156 field types across 15+ categories (identity, location, financial, temporal, and more)
  • Relational data — foreign keys just work. Orders reference real user IDs, reviews link to real products. One API call seeds your entire database.
  • 3 input modes — structured schema, plain English prompt, or pre-built templates
  • Auto-locale — add a country enum field and names, emails, phones match each row's nationality. 22 locales supported.
  • JSON, CSV, SQL output — Postgres, MySQL, SQLite dialects
  • Deterministic seeds — same seed + same schema = identical data every time
  • MCP server — use from Claude Desktop, Cursor, Windsurf, or any AI agent

Quick start

curl -X POST https://mockhero.dev/api/v1/generate \
  -H "Authorization: Bearer mh_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tables": [
      {
        "name": "users",
        "count": 50,
        "fields": [
          { "name": "id", "type": "uuid" },
          { "name": "name", "type": "full_name" },
          { "name": "email", "type": "email" },
          { "name": "country", "type": "enum", "params": { "values": ["US", "DE", "FR", "JP"] } },
          { "name": "created_at", "type": "datetime" }
        ]
      },
      {
        "name": "orders",
        "count": 200,
        "fields": [
          { "name": "id", "type": "uuid" },
          { "name": "user_id", "type": "ref", "params": { "table": "users", "field": "id" } },
          { "name": "total", "type": "price" },
          { "name": "status", "type": "enum", "params": { "values": ["pending", "shipped", "delivered"] } }
        ]
      }
    ]
  }'

Or use plain English:

curl -X POST https://mockhero.dev/api/v1/generate \
  -H "Authorization: Bearer mh_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "50 users with German names and 200 orders linked to them" }'

Templates

Pre-built schemas for common patterns — no schema definition needed:

curl -X POST https://mockhero.dev/api/v1/generate \
  -H "Authorization: Bearer mh_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "template": "ecommerce", "scale": 2, "locale": "de" }'

Available: ecommerce, blog, saas, social

MCP server

Use MockHero from AI agents via the Model Context Protocol.

Hosted remote MCP endpoint for agent-first clients:

https://mockhero.dev/mcp/agent

This endpoint exposes estimate, loginless Polar checkout, checkout status, API key claim, schema detection, templates, and generation tools.

Local stdio MCP server for agents that run npm packages:

npm install -g @mockherodev/mcp-server

See @mockherodev/mcp-server for setup instructions.

Pricing

FreeProScale
Daily records500100,0001,000,000
Requests/min1060200
Price$0$29/mo$79/mo

Tech stack

  • Next.js 15 (App Router)
  • Supabase (Postgres)
  • Clerk (Auth)
  • Polar (Billing)
  • Tailwind v4

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @mockherodev/mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-dinosaur24-mockhero": {
      "command": "npx",
      "args": [
        "-y",
        "@mockherodev/mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@mockherodev/mcp-servernpm

Compatible MCP Clients

MockHero works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More