# MockHero

> Synthetic test data API for developers and AI coding agents.

MockHero generates realistic, relational fake data via a simple REST API. Send a JSON schema or plain English description, get back production-quality test data with proper names, valid formats, and referential integrity.

> For the full API reference with request/response examples, see: https://mockhero.dev/llms-full.txt

## Key Facts

- Website: https://mockhero.dev
- API Base URL: https://mockhero.dev/api/v1
- Documentation: https://mockhero.dev/docs
- npm MCP Server: @mockherodev/mcp-server
- Free tier: 1,000 records/day, no credit card required

## Quick Start

POST https://mockhero.dev/api/v1/generate
Authorization: Bearer mh_YOUR_API_KEY
Content-Type: application/json

{
  "tables": [{
    "name": "users",
    "count": 10,
    "fields": [
      { "name": "id", "type": "uuid" },
      { "name": "name", "type": "full_name" },
      { "name": "email", "type": "email" }
    ]
  }]
}

## Features

- 156 built-in field types (uuid, email, full_name, phone, address, company, credit_card, iban, ip_address, url, date, timestamp, price, latitude, longitude, color, avatar, paragraph, and more)
- 22 locales (en, de, fr, es, it, pt, nl, pl, cs, sk, hr, ro, hu, bg, sv, da, fi, nb, ja, ko, zh, ar)
- Relational data with foreign key references between tables
- Output formats: JSON (all plans), CSV and SQL (Pro/Scale)
- SQL dialects: PostgreSQL, MySQL, SQLite
- Plain English prompt mode: describe data in natural language (10/day Free, 100/day Pro, 500/day Scale)
- Pre-built templates: ecommerce, blog, SaaS, social
- Schema detection: auto-detect schema from existing databases
- Deterministic output with seed values
- MCP server for Claude Desktop, Claude Code, Cursor, and other AI agents
- Sub-50ms generation time

## Pricing

- Free: $0/forever — 1,000 records/day, 100 records/request, 10 req/min, 10 prompts/day
- Pro: $29/month — 100,000 records/day, 10,000 records/request, 60 req/min, 100 prompts/day
- Scale: $79/month — 1,000,000 records/day, 50,000 records/request, 120 req/min, 500 prompts/day

Prompt limits apply only to plain English prompt mode. Schema mode and template mode are unlimited on all plans.

## MCP Server (AI Agent Integration)

Install: npx @mockherodev/mcp-server
Requires: MOCKHERO_API_KEY environment variable

Tools provided:
- generate_data: Generate synthetic data from a schema
- list_field_types: List all 156 supported field types
- list_templates: List pre-built schema templates
- generate_from_template: Generate data from a template

## API Endpoints

- POST /api/v1/generate — Generate synthetic data (auth required)
- POST /api/v1/generate/async — Async bulk generation (Scale only)
- GET /api/v1/templates — List schema templates (public)
- GET /api/v1/types — List field types (public)
- POST /api/v1/schema/detect — Detect schema from SQL (Pro/Scale)
- GET /api/v1/health — Health check (public)

## Use Cases

- Seed development databases with realistic data
- Generate test fixtures for unit and integration tests
- Populate staging environments
- Create demo data for product presentations
- Load testing with production-like datasets
- CI/CD pipeline data generation

## Links

- Docs: https://mockhero.dev/docs
- API Reference: https://mockhero.dev/docs/api-reference
- Field Types: https://mockhero.dev/docs/field-types
- Templates: https://mockhero.dev/docs/templates
- MCP Server: https://mockhero.dev/docs/mcp
- Authentication: https://mockhero.dev/docs/authentication
- Rate Limits: https://mockhero.dev/docs/rate-limits
- Error Codes: https://mockhero.dev/docs/errors
- Privacy Policy: https://mockhero.dev/privacy-policy
- Terms of Service: https://mockhero.dev/terms-of-service