Skip to content

Reference

Usage

Terminal window
seed <generator> [count] [flags]

count is an optional integer. Without it, seed outputs one value.

Generators

Names

GeneratorExample output
firstAlice
lastNguyen
nameAlice Nguyen
usernamealice_nguyen42

Internet

GeneratorExample output
emailalice@example.com
domainexample.com
urlhttps://example.com/path
ip192.168.1.42
ipv62001:db8::1
mac00:1A:2B:3C:4D:5E
slugquick-brown-fox

Address

GeneratorExample output
street123 Maple St
cityAustin
stateTX
zip78701
countryUnited States
phone+1-555-0147

Company

GeneratorExample output
companyAcme Corp
departmentEngineering
jobtitleSenior Software Engineer

Numbers

GeneratorExample output
integer42
float3.14
decimal9.99
sequence1, 2, 3

Text

GeneratorExample output
wordclarity
sentenceThe quick brown fox.
paragraphmulti-sentence text block
uuid550e8400-e29b-41d4-a716-446655440000
colorcoral
hex#f4a261

Date/Time

GeneratorExample output
date2024-03-15
time14:32:00
datetime2024-03-15T14:32:00
timestamp1710510720

File

GeneratorExample output
filenamereport_final.pdf
extensionpdf
mimetypeapplication/pdf
filepath/home/user/documents/report.pdf

Flags

FlagDescription
--plainPlain text output, one value per line (default)
--jsonJSON array output
--csvCSV with header row
--tsvTSV (tab-separated values)
--seed=NSet random seed for reproducible output
--locale=XX_XXLocale for localized generators (e.g. de_DE, fr_FR)

Schema wizard

seed new launches an interactive schema builder:

Terminal window
seed new

The wizard prompts for field names and generator types, then saves a seed_schema.json file. Run a saved schema with:

Terminal window
seed run seed_schema.json

Schemas produce multi-field structured records. The seed_cart feature generates nested JSON for complex record types.


MCP server

Start the MCP server:

Terminal window
seed mcp

Claude Desktop configuration (~/.config/claude/claude_desktop_config.json):

{
"mcpServers": {
"seed": {
"command": "seed",
"args": ["mcp"]
}
}
}

Once configured, all 37 generators are available as MCP tools inside Claude Desktop and any other MCP-compatible client.