# Json Faker — REST API endpoint `json-faker`

Returns an array of fake JSON records built from a field list, for testing and prototyping. Each field has a name and one of 40 generator types (firstName, lastName, fullName, email, phone, uuid, username, password, avatar, streetAddress, city, state, zipCode, country, latitude, longitude, companyName, jobTitle, department, productName, price, color, hexColor, url, ip, mac, paragraph, sentence, word, integer, float, boolean, date, pastDate, futureDate, timestamp, creditCard, iban, currency, imageUrl). Values are random on every call.

- Category: data
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/json-faker/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/json-faker/
- Same tool on the other surface: https://findutils.com/mcp/json-faker/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/json-faker/execute \
  -H "Content-Type: application/json" \
  -d '{
    "fields": [
      {
        "name": "id",
        "type": "uuid"
      },
      {
        "name": "email",
        "type": "email"
      }
    ],
    "count": 2
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/json-faker
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `fields` | array | yes | Field definitions: [{ name: "email", type: "email" }, ...]. Unknown types are rejected. |
| `count` | integer | no | Number of records to generate (1-1000). Default: 5. Default: `5`. |

Example arguments (verified):

```json
{
  "fields": [
    {
      "name": "id",
      "type": "uuid"
    },
    {
      "name": "email",
      "type": "email"
    }
  ],
  "count": 2
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:json_faker`. Full MCP reference: https://findutils.com/mcp/json-faker/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt
