Skip to main content
Glama

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

Related MCP server: mock-mcp

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

Free

Pro

Scale

Daily records

500

100,000

1,000,000

Requests/min

10

60

200

Price

$0

$29/mo

$79/mo

Tech stack

  • Next.js 15 (App Router)

  • Supabase (Postgres)

  • Clerk (Auth)

  • Polar (Billing)

  • Tailwind v4

License

MIT

Available Tools

5 tools
detect_schemaAInspect

Convert an existing database schema or JSON sample into MockHero's schema format.

Send a SQL CREATE TABLE statement and get back the structured schema ready to use with generate_test_data. Or send a sample JSON record and MockHero will infer the field types.

This is useful when you have migration files or an existing database and want to generate test data that matches your schema without manually writing the definition.

Inputs: sql, sample_json.

generate_from_templateAInspect

Generate test data using a pre-built schema template.

Pick a template (ecommerce, blog, saas, social) and optionally adjust the scale, locale, format, and seed. The template handles all the table definitions, field types, and foreign key relationships for you.

Scale multiplier: 1.0 = default counts, 2.0 = double, 0.5 = half. Example: ecommerce template at scale 2.0 generates 100 users, 200 products, etc.

Inputs: template (required), scale, locale, format, +2 more.

generate_test_dataAInspect

Generate realistic test data for database tables.

Send either a structured schema (tables with fields) or a plain English description. Supports relational data with foreign keys, locale-aware names and addresses, 22 locales, 157 field types, and multiple output formats (JSON, CSV, SQL).

The killer feature: define multiple tables with "ref" fields, and all foreign key relationships are correct — orders reference real user IDs, reviews link to real products. One call seeds your entire database.

Auto-locale: add a "country" field as an enum with country codes (DE, FR, US, etc.) and names, emails, phones automatically match each row's nationality.

Inputs: tables, prompt, format, sql_dialect, +2 more.

list_field_typesAInspect

List all 157 available field types for test data generation.

Returns every supported type organized by category (Identity, Location, Financial, Temporal, Technical, Content, Logic, Social, HR, Ecommerce, Security, AI/ML, Healthcare, Edge Cases, Special) with descriptions, parameters, and examples.

Use this to discover what types are available before building a schema.

Inputs: no named parameters.

list_templatesAInspect

List pre-built schema templates for common application patterns.

Available templates:

  • ecommerce: Customers, products, orders, order items, reviews (5 tables)

  • blog: Authors, posts, comments, tags, post_tags (5 tables)

  • saas: Organizations, members, subscriptions, invoices (4 tables)

  • social: Users, posts, likes, follows, messages (5 tables)

Each template includes realistic field types, proper foreign key relationships, weighted enum distributions, and auto-locale detection via country fields.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: schema detection, template-based generation, custom generation, field type listing, and template listing. No overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, with 'generate' and 'list' verbs used unambiguously.

    Tool Count5/5

    5 tools is ideal for this server's scope—covering schema conversion, two generation methods, and two discovery tools without being too few or too many.

    Completeness5/5

    The tool set covers the full workflow: schema detection, template-based generation, custom generation, and resource discovery, with no obvious gaps for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Generates realistic mock data using Faker.js for database seeding, API testing, and development environments. Supports person/company data, custom patterns, multi-locale generation, and structured datasets with referential integrity.
      4
      56 npm
      7
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Generates realistic, referentially-coherent test data (SQL INSERTs, JSON, or CSV) from your database schema, resolving foreign keys and respecting constraints. Paste CREATE TABLE DDL or a JSON schema and get ready-to-run seed data with valid relationships.
      2
      62 npm
      MIT