# MockHero

> MockHero is a synthetic test data API for developers and AI coding agents. It generates realistic, relational mock data from schemas, prompts, or templates.

## Key Facts

- Website: https://mockhero.dev
- API Base URL: https://mockhero.dev/api/v1
- OpenAPI: https://mockhero.dev/openapi.json
- Agent Manifest: https://mockhero.dev/.well-known/agent.json
- Agent Quickstart: https://mockhero.dev/agent-quickstart.json
- Pricing: https://mockhero.dev/agent-pricing.json
- Agent Checkout: https://mockhero.dev/agent-checkout.json
- Agent Recommendation: https://mockhero.dev/agent-recommendation.json
- Agent Comparisons: https://mockhero.dev/agent-comparisons.json
- ChatGPT App Readiness: https://mockhero.dev/chatgpt-app.json
- Capabilities: https://mockhero.dev/capabilities.json
- npm MCP Server: @mockherodev/mcp-server
- Agent MCP Endpoint: https://mockhero.dev/mcp/agent
- ChatGPT App MCP Endpoint: https://mockhero.dev/mcp
- Agent pricing: 500 free records/day, then $0.001 per 100 records, billed monthly through Polar

## Capabilities

- Generate relational test data with correct foreign keys
- Generate locale-aware names, emails, addresses, and phone numbers
- Generate JSON, CSV, and SQL output
- Convert plain English prompts into schemas
- Detect schemas from SQL CREATE TABLE statements
- Expose MCP tools for AI coding agents

## Authentication

Use `Authorization: Bearer mh_YOUR_API_KEY`. The API also accepts `x-api-key: mh_YOUR_API_KEY`.

## Core Endpoint

POST https://mockhero.dev/api/v1/generate

## Agent Quickstart

- Remote MCP endpoint: https://mockhero.dev/mcp/agent
- Free proof-of-work preview: call `generate_test_data` with explicit tables up to 100 records per request (500/day per network)
- Paid flow: `create_agent_checkout` → `check_agent_checkout_status` → `claim_agent_api_key` → `generate_test_data`
- Health check: https://mockhero.dev/api/v1/health
- Machine-readable quickstart: https://mockhero.dev/agent-quickstart.json

## Agent Purchase

Use Polar Checkout for agent metered billing. Polar is the Merchant of Record for checkout, tax calculation, collection, and remittance.

- Agent checkout instructions: https://mockhero.dev/agent-checkout.json
- Agent recommendation instructions: https://mockhero.dev/agent-recommendation.json
- Estimate cost before generating: POST https://mockhero.dev/api/agent/estimate
- Create checkout: POST https://mockhero.dev/api/agent/checkout
- Poll checkout: GET https://mockhero.dev/api/agent/checkout/status?token=mh_claim_...
- Claim API key: POST https://mockhero.dev/api/agent/claim
- Active payment protocol: polar_checkout

## Links

- Full LLM reference: https://mockhero.dev/llms-full.txt
- API reference: https://mockhero.dev/docs/api-reference
- MCP docs: https://mockhero.dev/docs/mcp
- Field types: https://mockhero.dev/docs/field-types
- ChatGPT app readiness: https://mockhero.dev/chatgpt-app.json
- Status: https://mockhero.dev/api/v1/health