Random User Generator Skill

Overview

A random user API that doubles as a random name API: each call returns fake users as JSON, with a name, gender, username, email and phone number per profile. Random User Generator works by generating random user data based on predefined rules and providing it in a structured format. The algorithm ensures that the generated data is realistic and diverse.

Live Test Random User Generator Skill Skill →

The tool

Once your client is connected to the VerveKit server, this appears in its tool list as RandomUserGeneratorSkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.

Tool call

{
  "name": "RandomUserGeneratorSkill",
  "arguments": {}
}

Connecting

One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.

{
  "mcpServers": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}

Per-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.

Argument	Type	Description
`count`OptionalPremium	integer	The number of users to generate default 1 · range 1–100
`includeAvatar`OptionalPremium	boolean	Include an AI-generated face avatar matching user's gender and age
`gender`Optional	string	Only generate users of this gender `malefemale`
`nationality`Optional	string	ISO country code for localised names, phone numbers and addresses (e.g. DE, JP, BR). Defaults to US `USGBAUCAIEINZANG`+34
`seed`Optional	string	Any string; the same seed (with the same other parameters) returns the same users, for repeatable test data

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.

Result

{
  "status": "ok",
  "error": null,
  "data": [
    {
      "id": "aeb01cae-300b-4e54-9cb0-76ce52d6b315",
      "name": "Monique Torp",
      "gender": "Female",
      "username": "Monique.Torp",
      "email": "[email protected]",
      "password": "V7s6IHRMhlniG98",
      "registered": "2026-01-10T15:18:03.898Z",
      "phone": "1-967-684-8927 x83452",
      "cell": "1-555-737-7469 x885",
      "birthdate": "1976-03-25T20:38:58.998Z",
      "age": 50,
      "nationality": "US",
      "location": {
        "street": "6858 Darrick Ramp",
        "city": "Parkersburg",
        "state": "West Virginia",
        "postcode": "31811-8127",
        "country": "United States of America",
        "countryCode": "US",
        "latitude": 39.27687,
        "longitude": -81.56839,
        "timezone": "America/New_York"
      },
      "login": {
        "salt": "xh1696HT",
        "md5": "5ebad82435f817d5837916fa2885b95c",
        "sha1": "b62baac1003eed109f32b3305bf049516f175819",
        "sha256": "02a99836191088b702972c5153c9d4ce2290d39bb90de141b467f302e62e8143"
      },
      "avatar": "https://storage.googleapis.com/apiverve/APIResources/faces/Female/50-60/87654321.jpg?X-Goog-Signature=..."
    }
  ]
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Field	Type	Example	Description
`0`	array[1]
`0.id`	string	`aeb01cae-300b-4e54-9cb0-76ce52d6b315`	Unique identifier for the generated user
`0.name`	string	`Monique Torp`	Full name of the randomly generated user
`0.gender`	string	`Female`	Gender designation for the random user
`0.username`	string	`Monique.Torp`	Randomly generated username for the user
`0.email`	string	`[email protected]`	Randomly generated email address for user
`0.password`Premium	string	`V7s6IHRMhlniG98`	Randomly generated password for the user
`0.registered`	string	`2026-01-10T15:18:03.898Z`	ISO 8601 date when user registered account
`0.phone`	string	`1-967-684-8927 x83452`	Randomly generated phone number for user
`0.cell`	string	`1-555-737-7469 x885`	Randomly generated cell phone number for user
`0.birthdate`	string	`1976-03-25T20:38:58.998Z`	ISO 8601 date representing user's birth date
`0.age`	number	`50`	Age in whole years from the birthdate
`0.nationality`	string	`US`	ISO country code the user was generated for
`0.location`Premium	object	`{…}`	A street address in a real city of that country, with coordinates near the city centre and its timezone
`0.location.street`Premium	string	`6858 Darrick Ramp`	Street address (generated)
`0.location.city`Premium	string	`Parkersburg`	A real city in the country
`0.location.state`Premium	string	`West Virginia`	State or province of that city
`0.location.postcode`Premium	string	`31811-8127`	Postcode in the country's format (generated)
`0.location.country`Premium	string	`United States of America`	Country name
`0.location.countryCode`Premium	string	`US`	ISO country code
`0.location.latitude`Premium	number	`39.27687`	Latitude within about 5 km of the city centre
`0.location.longitude`Premium	number	`-81.56839`	Longitude within about 5 km of the city centre
`0.location.timezone`Premium	string	`America/New_York`	IANA timezone of the city
`0.login`Premium	object	`{…}`	Hashes of password + salt, for seeding a test user table
`0.login.salt`Premium	string	`xh1696HT`	Random 8-character salt
`0.login.md5`Premium	string	`5ebad82435f817d5837916fa2885b95c`	MD5 of password + salt
`0.login.sha1`Premium	string	`b62baac1003eed109f32b3305bf049516f175819`	SHA-1 of password + salt
`0.login.sha256`Premium	string	`02a99836191088b702972c5153c9d4ce2290d39bb90de141b467f302e62e8143`	SHA-256 of password + salt
`0.avatar`Premium	string	`https://storage.googleapis.com/apiverve/APIResources/faces/Female/50-60/87654321.jpg?X-Goog-Signatur…`	URL to AI-generated face avatar matching gender and age

Failure modes

Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.

Status	What it means
`400` / `422`	The arguments did not validate. The message names the offending one.
`401`	The OAuth session is invalid or expired — reconnect the server.
`403`	Blocked by a key restriction or an IP allow-list. Never a bad identity.
`404`	This skill is not part of VerveKit. Check the catalog.
`429`	Out of credits, or a brief rate limit. The message tells them apart.

A call costs 2 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.

Use cases

Local Database Seeding: To seed local staging tables without privacy risks, developers generate fake names, emails, and phone numbers directly into migration scripts.
UI Prototype Demos: Product designers fill mockups with generated names, birthdays, and registration dates to present realistic customer account views during stakeholder walkthroughs.
Form Validation Testing: Verify registration form validation rules before production by feeding unique usernames, emails, and phone records through automated test suites.
Live Sales Demonstrations: When preparing customer-facing sandbox instances, sales engineers generate sample user profiles so client prospects see believable accounts rather than placeholder text.

Other ways to use Random User Generator Skill

Set up Random User Generator Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →

Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →