io.github.dinosaur24/mockhero MCP Server

This MCP server generates realistic relational test data. It supports 156 field types and 22 locales, and can output JSON/CSV/SQL. The readme describes free previews that work without an API key, with limited record generation and free schema detection, field-type listing, templates, and cost estimates. With MOCKHERO_API_KEY, it enables larger requests and additional output options on paid tiers.

🛠️ Key Features

Generate realistic relational test data
156 field types and 22 locales
JSON/CSV/SQL output
Free preview without an API key
Schema detection, field-type listing, templates, cost estimates always free

🚀 Use Cases

Creating synthetic seed/test-data for databases and APIs
Generating deterministic datasets from explicit table schemas or small templates
Producing structured outputs for testing workflows

⚡ Developer Benefits

Faster test-data creation from schemas/templates
Field-type listing and templates to define generation rules
Cost estimates available during schema detection and planning

⚠️ Limitations

No API key mode: up to 100 records per request
Larger requests, CSV/SQL on paid tiers, and metered agent-plan usage require MOCKHERO_API_KEY

@mockherodev/mcp-server

MCP server for MockHero — generate realistic test data from Claude Desktop, Claude Code, Cursor, Windsurf, and other AI agents.

Works with or without an API key:

No key (free preview): generate up to 100 records per request from explicit table schemas or small templates. Schema detection, field-type listing, templates, and cost estimates are always free.
With MOCKHERO_API_KEY (recommended): plain-English prompt generation, larger requests, CSV/SQL output on paid tiers, and metered agent-plan usage.

Hosted agent endpoint

Agents that support remote Streamable HTTP MCP can skip the npm install and connect directly to:

text

https://mockhero.dev/mcp/agent

The hosted endpoint includes the same tools as this package: cost estimation, loginless Polar checkout, checkout status, API key claiming, schema detection, templates, and data generation. Pass a key via Authorization: Bearer mh_YOUR_API_KEY (or the api_key tool argument) for authenticated calls.

Hosted agent endpoint

Agents that support remote Streamable HTTP MCP can connect directly to:

text

https://mockhero.dev/mcp/agent

The hosted endpoint includes cost estimation, loginless Polar checkout, checkout status, API key claiming, schema detection, templates, and authenticated data generation.

Setup

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "mockhero": {
      "command": "npx",
      "args": ["@mockherodev/mcp-server"],
      "env": {
        "MOCKHERO_API_KEY": "mh_live_your_key_here"
      }
    }
  }
}

Omit the env block entirely to run in free preview mode.

Cursor

Add to .cursor/mcp.json in your project:

json

{
  "mcpServers": {
    "mockhero": {
      "command": "npx",
      "args": ["@mockherodev/mcp-server"],
      "env": {
        "MOCKHERO_API_KEY": "mh_live_your_key_here"
      }
    }
  }
}

Claude Code

bash

# Free preview mode
claude mcp add mockhero -- npx @mockherodev/mcp-server

# Authenticated
claude mcp add mockhero -- env MOCKHERO_API_KEY=mh_live_xxx npx @mockherodev/mcp-server

Get an API key without leaving your agent (loginless checkout)

No signup or dashboard needed. The agent-plan purchase flow is fully tool-driven:

estimate_agent_usage — estimate cost first. The agent plan includes 500 free records per day, then $0.001 per 100 records (rounded up per request), billed monthly through Polar as Merchant of Record.
create_agent_checkout — pass a billing email; returns a Polar checkout URL and a one-time claim_token. A human completes payment in the browser.
check_agent_checkout_status — poll with the claim_token until status is paid.
claim_agent_api_key — exchange the claim_token for the API key. The key is returned exactly once — store it securely.
Restart this server with MOCKHERO_API_KEY=mh_... set (recommended path from here on).

Prefer a dashboard? Sign up free at mockhero.dev instead.

Tools

generate_test_data

Generate realistic test data from a structured schema or plain English description. Relational foreign keys, 156 field types, 22 locales, JSON/CSV/SQL output. Explicit schemas up to 100 records run free without a key; prompt mode and larger requests need MOCKHERO_API_KEY.

code

"Generate 50 users with German names and 200 orders linked to them"

generate_from_template

Generate data from a pre-built template (ecommerce, blog, saas, social) — no schema definition needed. Small scales (e.g. 0.05) stay within the free 100-record preview.

code

Use the ecommerce template at 2x scale with German locale

detect_schema

Convert SQL CREATE TABLE statements or JSON samples into MockHero's schema format. Free, no key required.

list_field_types

List all 156 supported field types with descriptions and parameters. Free, no key required.

list_templates

List pre-built schema templates. Free, no key required.

estimate_agent_usage

Estimate agent-plan cost before generating: free daily allowance remaining, billable records, billable 100-record units, and estimated dollar cost. Free, no key required.

create_agent_checkout

Create a loginless Polar checkout for the metered agent plan. Returns a checkout URL and one-time claim_token.

check_agent_checkout_status

Poll a checkout by claim_token until it is paid.

claim_agent_api_key

Claim the API key after payment. Returned once — store it and set MOCKHERO_API_KEY.

Environment variables

Variable	Required	Description
`MOCKHERO_API_KEY`	No	MockHero API key (`mh_...`). Without it, generation runs in free preview mode (≤100 records per request, explicit schemas/templates only).
`MOCKHERO_API_BASE`	No	Base URL of the MockHero API. Default `https://mockhero.dev`.

Pricing

Free tier: 500 records/day, 100 per request, JSON output.
Agent plan (loginless, metered): 500 free records/day, then $0.001 per 100 records, billed monthly via Polar (Merchant of Record).
Full pricing: mockhero.dev/agent-pricing.json

tables	array	optional
prompt	string	optional	Plain-English data request. Example: 50 users and 200 orders linked to them.
format	string	optional
sql_dialect	string	optional
locale	string	optional	Default locale such as en, de, fr, es, or ja.
seed	number	optional	Seed for reproducible output.
template	string	optional
scale	number	optional	Multiplier for template record counts.
estimated_records	integer	optional	Required for prompt estimates because this tool does not run prompt-to-schema conversion.
daily_used_before	integer	optional	Optional assumption when no API key is supplied.
api_key	string	optional	Optional MockHero API key for no-auth MCP clients. Prefer the Authorization header when the client supports it.

tables	array	optional
prompt	string	optional	Plain-English data request. Example: 50 users and 200 orders linked to them.
format	string	optional
sql_dialect	string	optional
locale	string	optional	Default locale such as en, de, fr, es, or ja.
seed	number	optional	Seed for reproducible output.
api_key	string	optional	Optional MockHero API key for no-auth MCP clients. Prefer the Authorization header when the client supports it.

template	string	required
scale	number	optional
locale	string	optional
format	string	optional
sql_dialect	string	optional
seed	number	optional
api_key	string	optional	Optional MockHero API key for no-auth MCP clients. Prefer the Authorization header when the client supports it.

sql	string	optional	SQL CREATE TABLE statement or statements.
sample_json	object	optional	Single example JSON object to infer fields from.

MockHero

io.github.dinosaur24/mockhero MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

estimate_agent_usage

create_agent_checkout

check_agent_checkout_status

claim_agent_api_key

generate_test_data

generate_from_template

detect_schema

list_field_types

list_templates

@mockherodev/mcp-server

Hosted agent endpoint

Hosted agent endpoint

Setup

Claude Desktop

Cursor

Claude Code

Get an API key without leaving your agent (loginless checkout)

Tools

generate_test_data

generate_from_template

detect_schema

list_field_types

list_templates

estimate_agent_usage

create_agent_checkout

check_agent_checkout_status

claim_agent_api_key

Environment variables

Pricing

Links

Install

Configuration

Related servers