MockHero

io.github.dinosaur24Published by GitHub account dinosaur24v0.2.0Updated Oct 27, 2026

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

The publisher's own server: Spendict

VerifiedStreamable HTTPWeb executableDatabasesDeveloper Tools

Overview

AI-generated overview

MockHero generates realistic relational test data (156 field types, 22 locales, JSON/CSV/SQL) for an assistant, with free previews and optional paid plans.

What you can do
  • Generate test data from a structured schema or plain-English prompt, including relational foreign keys, locales and JSON/CSV/SQL output
  • Generate data from pre-built templates such as ecommerce, blog, saas and social
  • Convert SQL CREATE TABLE statements or JSON samples into MockHero's schema format
  • List the supported field types and available templates
  • Estimate agent-plan cost and run a loginless checkout flow: create checkout, poll status, claim API key
When to use it
Useful when you need seed or fixture data for development, demos or tests and want an assistant to produce linked tables without hand-writing schemas. Free preview mode covers small explicit-schema or template requests; a key unlocks prompt-based and larger generations.
Requirements
Runs as a local npm package via npx (Node.js) or as a remote Streamable HTTP endpoint. Optional MOCKHERO_API_KEY enables prompt mode, larger requests and CSV/SQL output; MOCKHERO_API_BASE overrides the API base URL. No key is needed for free previews, schema detection, field-type listing, templates and cost estimates.
Before you install
The checkout tools create a real Polar payment flow and metered billing ($0.001 per 100 records after the daily free allowance); a human must complete payment in the browser. The API key is returned only once by claim_agent_api_key and must be stored securely. Generated data is produced by a third-party service, so avoid sending sensitive schemas or samples.

Installation

In SourceWeft

  1. Open MockHero in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.dinosaur24%2Fmockhero/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mockhero": {
      "type": "http",
      "url": "https://mockhero.dev/mcp/agent"
    }
  }
}

README

@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 modeclaude mcp add mockhero -- npx @mockherodev/mcp-server
# Authenticatedclaude 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:

  1. 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.
  2. 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.
  3. check_agent_checkout_status — poll with the claim_token until status is paid.
  4. claim_agent_api_key — exchange the claim_token for the API key. The key is returned exactly once — store it securely.
  5. 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.

"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.

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

VariableRequiredDescription
MOCKHERO_API_KEYNoMockHero API key (mh_...). Without it, generation runs in free preview mode (≤100 records per request, explicit schemas/templates only).
MOCKHERO_API_BASENoBase 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

Links

Source: packages/mcp-server/README.md at commit 36778a4

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Spendict integrations