English Français العربية

MockHero

Official registry Data and databases

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

Source code Website Documentation

What can you do with MockHero?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mockhero 'https://mockhero.dev/mcp/agent'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mockhero": {
            "type": "http",
            "url": "https://mockhero.dev/mcp/agent"
        }
    }
}
NPM package @mockherodev/mcp-server
Claude Code 
claude mcp add mockhero -e 'MOCKHERO_API_KEY=<your mockhero_api_key>' -e 'MOCKHERO_API_BASE=<MOCKHERO_API_BASE>' -- npx -y @mockherodev/mcp-server@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mockhero": {
            "command": "npx",
            "args": [
                "-y",
                "@mockherodev/mcp-server@0.2.0"
            ],
            "env": {
                "MOCKHERO_API_KEY": "<your mockhero_api_key>",
                "MOCKHERO_API_BASE": "<MOCKHERO_API_BASE>"
            }
        }
    }
}

Environment variables

  • MOCKHERO_API_KEY secret MockHero API key (optional — without it, generation runs as a free preview up to 100 records per request; get a key at https://mockhero.dev or via the create_agent_checkout tool)
  • MOCKHERO_API_BASE Base URL of the MockHero API (default https://mockhero.dev)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MockHero
  2. What it does
  3. Quick start
  4. Templates
  5. MCP server
  6. Pricing
  7. Tech stack
  8. License

MockHero

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

Frequently asked questions

What is MockHero?

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

How do I install MockHero?

It runs as a remote server. In Claude Code: claude mcp add --transport http mockhero 'https://mockhero.dev/mcp/agent'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does MockHero need an API key?

Yes. It expects MOCKHERO_API_KEY, which you set in its configuration.

Is MockHero open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains MockHero?

It is published by dinosaur24. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.