mockherodev/mcp-server
📇 ☁️ - Agent-first synthetic test data MCP server. Estimate usage, detect schemas from SQL or JSON, create loginless Polar checkout, claim API keys, and generate JSON, CSV, or SQL data through a hosted Streamable HTTP endpoint.
Quick Install
{
"mcpServers": {
"mockherodev-mcp-server": {
"command": "npx",
"args": [
"-y",
"mockherodev-mcp-server"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
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
countryenum 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
| 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