Faker MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Faker MCP Server Generate a fake person with name and job title"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
faker-server MCP Server
MCP server to get fake strings
This is a TypeScript-based MCP server that provides tools for generating fake data using Faker.js. It demonstrates core MCP concepts by providing:
Tools for generating various types of fake data (person, lorem, internet, etc.)
Support for different locales for internationalization
Customizable options for each data type
Features
Tools
generate_person- Generate fake person data (names, job titles, etc.)generate_lorem- Generate fake lorem ipsum textgenerate_internet- Generate fake internet data (emails, usernames, URLs, etc.)generate_date- Generate fake datesgenerate_commerce- Generate fake commerce data (products, prices, etc.)And many more modules from Faker.js
Features
Support for multiple locales (en, ja, fr, etc.)
Customizable field selection for each data type
Configurable parameters (length, count, min/max values, etc.)
Related MCP server: mockhero
Development
Install dependencies:
npm installBuild the server:
npm run buildFor development with auto-rebuild:
npm run watchTesting
Run all tests:
npm testRun tests in watch mode:
npm run test:watchRun integration tests specifically:
npm run test:integrationGenerate test coverage report:
npm run test:coverageInstallation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"faker-server": {
"command": "/path/to/faker-server/build/index.js"
}
}
}Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspectorThe Inspector will provide a URL to access debugging tools in your browser.
Available Tools
230 toolsairline-aircraftTypeB
Returns a random aircraft type.
Inputs: no named parameters.
airline-airline-iataCodeC
Generates a random airline.
Inputs: no named parameters.
airline-airline-nameB
Generates a random airline.
Inputs: no named parameters.
airline-airplane-iataTypeCodeC
Generates a random airplane model.
Inputs: no named parameters.
airline-airplane-nameB
Generates a random airplane model.
Inputs: no named parameters.
airline-airport-iataCodeC
Generates a random airport.
Inputs: no named parameters.
airline-airport-nameB
Generates a random airport.
Inputs: no named parameters.
airline-flightNumberB
Returns a random flight number.
Inputs: length, addLeadingZeros.
airline-recordLocatorA
Generates a random record locator (booking reference number).
Inputs: allowNumerics, allowVisuallySimilarCharacters.
airline-seatC
Generates a random seat.
Inputs: aircraftType.
animal-bearB
Returns a random bear species.
Inputs: no named parameters.
animal-birdB
Returns a random bird species.
Inputs: no named parameters.
animal-catB
Returns a random cat breed.
Inputs: no named parameters.
animal-cetaceanA
Returns a random cetacean species.
Inputs: no named parameters.
animal-cowA
Returns a random cow species.
Inputs: no named parameters.
animal-crocodiliaB
Returns a random crocodilian species.
Inputs: no named parameters.
animal-dogA
Returns a random dog breed.
Inputs: no named parameters.
animal-fishB
Returns a random fish species.
Inputs: no named parameters.
animal-horseB
Returns a random horse breed.
Inputs: no named parameters.
animal-insectA
Returns a random insect species.
Inputs: no named parameters.
animal-lionB
Returns a random lion species.
Inputs: no named parameters.
animal-petNameA
Returns a random pet name.
Inputs: no named parameters.
animal-rabbitB
Returns a random rabbit species.
Inputs: no named parameters.
animal-rodentB
Returns a random rodent breed.
Inputs: no named parameters.
animal-snakeB
Returns a random snake species.
Inputs: no named parameters.
animal-typeB
Returns a random animal type.
Inputs: no named parameters.
book-authorB
Returns a random author name.
Inputs: no named parameters.
book-formatB
Returns a random book format.
Inputs: no named parameters.
book-genreB
Returns a random genre.
Inputs: no named parameters.
book-publisherB
Returns a random publisher.
Inputs: no named parameters.
book-seriesA
Returns a random series.
Inputs: no named parameters.
book-titleB
Returns a random title.
Inputs: no named parameters.
color-cmykC
Returns a CMYK color.
Inputs: format.
color-colorByCSSColorSpaceC
Returns a random color based on CSS color space specified.
Inputs: space, format.
color-cssSupportedFunctionB
Returns a random css supported color function name.
Inputs: no named parameters.
color-cssSupportedSpaceB
Returns a random css supported color space name.
Inputs: no named parameters.
color-hslC
Returns an HSL color.
Inputs: format, includeAlpha.
color-humanA
Returns a random human-readable color name.
Inputs: no named parameters.
color-hwbC
Returns an HWB color.
Inputs: format.
color-labC
Returns a LAB (CIELAB) color.
Inputs: format.
color-lchC
Returns an LCH color.
Inputs: format.
color-rgbC
Returns an RGB color.
Inputs: casing, format, prefix, includeAlpha.
color-spaceC
Returns a random color space name from the worldwide accepted color spaces.
Inputs: no named parameters.
commerce-departmentC
Returns a department inside a shop.
Inputs: no named parameters.
commerce-isbnC
Returns a random ISBN identifier.
Inputs: union (required).
commerce-priceC
Generates a price between min and max (inclusive).
Inputs: dec, max, min, symbol.
commerce-productC
Returns a short product name.
Inputs: no named parameters.
commerce-productAdjectiveC
Returns an adjective describing a product.
Inputs: no named parameters.
commerce-productDescriptionC
Returns a product description.
Inputs: no named parameters.
commerce-productMaterialC
Returns a material of a product.
Inputs: no named parameters.
commerce-productNameA
Generates a random descriptive product name.
Inputs: no named parameters.
company-buzzAdjectiveA
Returns a random buzz adjective that can be used to demonstrate data being viewed by a manager.
Inputs: no named parameters.
company-buzzNounA
Returns a random buzz noun that can be used to demonstrate data being viewed by a manager.
Inputs: no named parameters.
company-buzzPhraseA
Generates a random buzz phrase that can be used to demonstrate data being viewed by a manager.
Inputs: no named parameters.
company-buzzVerbA
Returns a random buzz verb that can be used to demonstrate data being viewed by a manager.
Inputs: no named parameters.
company-catchPhraseB
Generates a random catch phrase that can be displayed to an end user.
Inputs: no named parameters.
company-catchPhraseAdjectiveA
Returns a random catch phrase adjective that can be displayed to an end user.
Inputs: no named parameters.
company-catchPhraseDescriptorA
Returns a random catch phrase descriptor that can be displayed to an end user.
Inputs: no named parameters.
company-catchPhraseNounA
Returns a random catch phrase noun that can be displayed to an end user.
Inputs: no named parameters.
company-nameB
Generates a random company name.
Inputs: no named parameters.
database-collationB
Returns a random database collation.
Inputs: no named parameters.
database-columnA
Returns a random database column name.
Inputs: no named parameters.
database-engineB
Returns a random database engine.
Inputs: no named parameters.
database-mongodbObjectIdA
Returns a MongoDB ObjectId string.
Inputs: no named parameters.
database-typeB
Returns a random database column type.
Inputs: no named parameters.
date-anytimeB
Generates a random date that can be either in the past or in the future.
Inputs: refDate.
date-betweenB
Generates a random date between the given boundaries.
Inputs: to (required), from (required).
date-betweensB
Generates random dates between the given boundaries. The dates will be returned in an array sorted in chronological order.
Inputs: to (required), from (required), count.
date-birthdateB
Returns a random birthdate. By default, the birthdate is generated for an adult between 18 and 80 years old. But you can customize the 'age' range or the 'year' range to generate a more specific birthdate.
Inputs: union (required).
date-futureB
Generates a random date in the future.
Inputs: years, refDate.
date-monthB
Returns a random name of a month.
Inputs: context, abbreviated.
date-pastB
Generates a random date in the past.
Inputs: years, refDate.
date-recentB
Generates a random date in the recent past.
Inputs: days, refDate.
date-soonC
Generates a random date in the near future.
Inputs: days, refDate.
date-timeZoneB
Returns a random IANA time zone name.
Inputs: no named parameters.
date-weekdayB
Returns a random day of the week.
Inputs: context, abbreviated.
finance-accountNameB
Generates a random account name.
Inputs: no named parameters.
finance-accountNumberC
Generates a random account number.
Inputs: length.
finance-amountB
Generates a random amount between the given bounds (inclusive).
Inputs: dec, max, min, symbol, +1 more.
finance-bicB
Generates a random SWIFT/BIC code based on the ISO-9362 format.
Inputs: includeBranchCode.
finance-bitcoinAddressC
Generates a random Bitcoin address.
Inputs: type, network.
finance-creditCardCVVB
Generates a random credit card CVV.
Inputs: no named parameters.
finance-creditCardIssuerB
Returns a random credit card issuer.
Inputs: no named parameters.
finance-creditCardNumberB
Generates a random credit card number.
Inputs: issuer.
finance-currencyB
Returns a random currency object, containing code, name, symbol, and numericCode properties.
Inputs: no named parameters.
finance-currencyCodeB
Returns a random currency code.
Inputs: no named parameters.
finance-currencyNameB
Returns a random currency name.
Inputs: no named parameters.
finance-currencyNumericCodeB
Returns a random currency numeric code.
Inputs: no named parameters.
finance-currencySymbolB
Returns a random currency symbol.
Inputs: no named parameters.
finance-ethereumAddressA
Creates a random, non-checksum Ethereum address.
Inputs: no named parameters.
finance-ibanC
Generates a random IBAN.
Inputs: formatted, countryCode.
finance-litecoinAddressB
Generates a random Litecoin address.
Inputs: no named parameters.
finance-maskedNumberC
Generates a random masked number.
Inputs: length, parens, ellipsis, maskChar.
finance-pinC
Generates a random PIN.
Inputs: length.
finance-routingNumberB
Generates a random routing number.
Inputs: no named parameters.
finance-transactionDescriptionA
Generates a random transaction description.
Inputs: no named parameters.
finance-transactionTypeB
Returns a random transaction type.
Inputs: no named parameters.
food-adjectiveB
Generates a random dish adjective.
Inputs: no named parameters.
food-descriptionB
Generates a random dish description.
Inputs: no named parameters.
food-dishB
Generates a random dish name.
Inputs: no named parameters.
food-ethnicCategoryA
Generates a random food's ethnic category.
Inputs: no named parameters.
food-fruitB
Generates a random fruit name.
Inputs: no named parameters.
food-ingredientA
Generates a random ingredient name.
Inputs: no named parameters.
food-meatB
Generates a random meat.
Inputs: no named parameters.
food-spiceB
Generates a random spice name.
Inputs: no named parameters.
food-vegetableA
Generates a random vegetable name.
Inputs: no named parameters.
git-branchB
Generates a random branch name.
Inputs: no named parameters.
git-commitDateA
Generates a date string for a git commit using the same format as git log.
Inputs: refDate.
git-commitEntryB
Generates a random commit entry as printed by git log.
Inputs: eol, merge, refDate.
git-commitMessageB
Generates a random commit message.
Inputs: no named parameters.
git-commitShaC
Generates a random commit sha.
Inputs: length.
hacker-abbreviationB
Returns a random hacker/IT abbreviation.
Inputs: no named parameters.
hacker-adjectiveB
Returns a random hacker/IT adjective.
Inputs: no named parameters.
hacker-ingverbA
Returns a random hacker/IT verb for continuous actions (en: ing suffix; e.g. hacking).
Inputs: no named parameters.
hacker-nounB
Returns a random hacker/IT noun.
Inputs: no named parameters.
hacker-phraseB
Generates a random hacker/IT phrase.
Inputs: no named parameters.
hacker-verbA
Returns a random hacker/IT verb.
Inputs: no named parameters.
image-avatarB
Generates a random avatar image url.
Inputs: no named parameters.
image-avatarGitHubB
Generates a random avatar from GitHub.
Inputs: no named parameters.
image-avatarLegacyA
Generates a random avatar from https://cloudflare-ipfs.com/ipfs/Qmd3W5DuhgHirLHGVixi6V76LhCkZUz6pnFt5AJBiyvHye/avatar. (Deprecated: The links are no longer working. Use avatar() instead.)
Inputs: no named parameters.
image-dataUriB
Generates a random data uri containing an URL-encoded SVG image or a Base64-encoded SVG image.
Inputs: type, color, width, height.
image-personPortraitB
Generates a random square portrait (avatar) of a person. These are static images of fictional people created by an AI, Stable Diffusion 3.
Inputs: sex, size.
image-urlC
Generates a random image url.
Inputs: width, height.
image-urlLoremFlickrC
Generates a random image url provided via https://loremflickr.com.
Inputs: width, height, category.
image-urlPicsumPhotosC
Generates a random image url provided via https://picsum.photos.
Inputs: blur, width, height, grayscale.
image-urlPlaceholderA
Generates a random image url provided via https://via.placeholder.com/. (Deprecated: The service has bad uptime. Use faker.image.url() or faker.image.dataUri() instead.)
Inputs: text, width, format, height, +2 more.
internet-colorA
Generates a random css hex color code in aesthetically pleasing color palette. (Deprecated: Please use faker.color.rgb() or any of the other color methods instead.)
Inputs: redBase, blueBase, greenBase.
internet-displayNameB
Generates a display name using the given person's name as base.
Inputs: lastName, firstName.
internet-domainNameB
Generates a random domain name.
Inputs: no named parameters.
internet-domainSuffixB
Returns a random domain suffix.
Inputs: no named parameters.
internet-domainWordC
Generates a random domain word.
Inputs: no named parameters.
internet-emailC
Generates an email address using the given person's name as base.
Inputs: lastName, provider, firstName, allowSpecialCharacters.
internet-emojiC
Generates a random emoji.
Inputs: types.
internet-exampleEmailB
Generates an email address using an example mail provider using the given person's name as base.
Inputs: lastName, firstName, allowSpecialCharacters.
internet-httpMethodB
Returns a random http method.
Inputs: no named parameters.
internet-httpStatusCodeB
Generates a random HTTP status code.
Inputs: types.
internet-ipB
Generates a random IPv4 or IPv6 address.
Inputs: no named parameters.
internet-ipv4C
Generates a random IPv4 address.
Inputs: network, cidrBlock.
internet-ipv6B
Generates a random IPv6 address.
Inputs: no named parameters.
internet-jwtC
Generates a random JWT (JSON Web Token).
Inputs: header, payload, refDate.
internet-jwtAlgorithmB
Generates a random JWT (JSON Web Token) Algorithm.
Inputs: no named parameters.
internet-macC
Generates a random mac address.
Inputs: separator.
internet-passwordC
Generates a random password-like string.
Inputs: length, prefix, pattern, memorable.
internet-portB
Generates a random port number.
Inputs: no named parameters.
internet-protocolA
Returns a random web protocol. Either http or https.
Inputs: no named parameters.
internet-urlB
Generates a random http(s) url.
Inputs: protocol, appendSlash.
internet-userAgentB
Generates a random user agent string.
Inputs: no named parameters.
internet-usernameB
Generates a username using the given person's name as base.
Inputs: lastName, firstName.
internet-userNameB
Generates a username using the given person's name as base. (Deprecated: Use faker.internet.username() instead.)
Inputs: lastName, firstName.
location-buildingNumberB
Generates a random building number.
Inputs: no named parameters.
location-cardinalDirectionB
Returns a random cardinal direction (north, east, south, west).
Inputs: abbreviated.
location-cityB
Generates a random localized city name.
Inputs: no named parameters.
location-continentA
Returns a random continent name.
Inputs: no named parameters.
location-countryA
Returns a random country name.
Inputs: no named parameters.
location-countryCodeB
Returns a random ISO_3166-1 country code.
Inputs: variant.
location-countyA
Returns a random localized county, or other equivalent second-level administrative entity for the locale's country such as a district or department.
Inputs: no named parameters.
location-directionA
Returns a random direction (cardinal and ordinal; northwest, east, etc).
Inputs: abbreviated.
location-languageB
Returns a random spoken language.
Inputs: no named parameters.
location-latitudeC
Generates a random latitude.
Inputs: max, min, precision.
location-longitudeC
Generates a random longitude.
Inputs: max, min, precision.
location-nearbyGPSCoordinateB
Generates a random GPS coordinate within the specified radius from the given coordinate.
Inputs: origin, radius, isMetric.
location-ordinalDirectionB
Returns a random ordinal direction (northwest, southeast, etc).
Inputs: abbreviated.
location-secondaryAddressA
Generates a random localized secondary address. This refers to a specific location at a given address such as an apartment or room number.
Inputs: no named parameters.
location-stateB
Returns a random state, or other equivalent first-level administrative entity for the locale's country such as a province, region, or prefecture.
Inputs: abbreviated.
location-streetB
Returns a random street name.
Inputs: no named parameters.
location-streetAddressB
Generates a random localized street address.
Inputs: useFullAddress.
location-timeZoneB
Returns a random time zone.
Inputs: no named parameters.
location-zipCodeC
Generates a random localized zip code.
Inputs: state, format.
lorem-linesB
Generates the given number lines of lorem separated by '\n'.
Inputs: lineCount.
lorem-paragraphB
Generates a paragraph with the given number of sentences.
Inputs: sentenceCount.
lorem-paragraphsC
Generates the given number of paragraphs.
Inputs: separator, paragraphCount.
lorem-sentenceC
Generates a space separated list of words beginning with a capital letter and ending with a period.
Inputs: wordCount.
lorem-sentencesC
Generates the given number of sentences.
Inputs: separator, sentenceCount.
lorem-slugB
Generates a slugified text consisting of the given number of hyphen separated words.
Inputs: wordCount.
lorem-textC
Generates a random text based on a random lorem method.
Inputs: no named parameters.
lorem-wordC
Generates a word of a specified length.
Inputs: length, strategy.
lorem-wordsB
Generates a space separated list of words.
Inputs: count.
music-albumA
Returns a random album name.
Inputs: no named parameters.
music-artistA
Returns a random artist name.
Inputs: no named parameters.
music-genreB
Returns a random music genre.
Inputs: no named parameters.
music-songNameB
Returns a random song name.
Inputs: no named parameters.
person-bioA
Returns a random short biography.
Inputs: no named parameters.
person-firstNameB
Returns a random first name.
Inputs: sex.
person-fullNameB
Generates a random full name.
Inputs: sex, lastName, firstName.
person-genderB
Returns a random gender.
Inputs: no named parameters.
person-jobAreaB
Generates a random job area.
Inputs: no named parameters.
person-jobDescriptorC
Generates a random job descriptor.
Inputs: no named parameters.
person-jobTitleB
Generates a random job title.
Inputs: no named parameters.
person-jobTypeB
Generates a random job type.
Inputs: no named parameters.
person-lastNameB
Returns a random last name.
Inputs: sex.
person-middleNameC
Returns a random middle name.
Inputs: sex.
person-prefixB
Returns a random person prefix.
Inputs: sex.
person-sexB
Returns a random sex.
Inputs: no named parameters.
person-sexTypeA
Returns a random sex type. The SexType is intended to be used in parameters and conditions.
Inputs: no named parameters.
person-suffixB
Returns a random person suffix.
Inputs: no named parameters.
person-zodiacSignB
Returns a random zodiac sign.
Inputs: no named parameters.
phone-imeiB
Generates IMEI number.
Inputs: no named parameters.
phone-numberB
Generates a random phone number.
Inputs: style.
science-chemicalElementB
Returns a random periodic table element.
Inputs: no named parameters.
science-unitC
Returns a random scientific unit.
Inputs: no named parameters.
system-commonFileExtB
Returns a commonly used file extension.
Inputs: no named parameters.
system-commonFileNameB
Returns a random file name with a given extension or a commonly used extension.
Inputs: extension.
system-commonFileTypeC
Returns a commonly used file type.
Inputs: no named parameters.
system-cronB
Returns a random cron expression.
Inputs: includeYear, includeNonStandard.
system-directoryPathC
Returns a directory path.
Inputs: no named parameters.
system-fileExtC
Returns a file extension.
Inputs: mimeType.
system-fileNameB
Returns a random file name with extension.
Inputs: extensionCount.
system-filePathC
Returns a file path.
Inputs: no named parameters.
system-fileTypeC
Returns a file type.
Inputs: no named parameters.
system-mimeTypeC
Returns a mime-type.
Inputs: no named parameters.
system-networkInterfaceC
Returns a random network interface.
Inputs: interfaceType, interfaceSchema.
system-semverC
Returns a semantic version.
Inputs: no named parameters.
vehicle-bicycleC
Returns a type of bicycle.
Inputs: no named parameters.
vehicle-colorC
Returns a vehicle color.
Inputs: no named parameters.
vehicle-fuelC
Returns a fuel type.
Inputs: no named parameters.
vehicle-manufacturerB
Returns a manufacturer name.
Inputs: no named parameters.
vehicle-modelC
Returns a vehicle model.
Inputs: no named parameters.
vehicle-typeC
Returns a vehicle type.
Inputs: no named parameters.
vehicle-vehicleC
Returns a random vehicle.
Inputs: no named parameters.
vehicle-vinC
Returns a vehicle identification number (VIN).
Inputs: no named parameters.
vehicle-vrmB
Returns a vehicle registration number (Vehicle Registration Mark - VRM).
Inputs: no named parameters.
word-adjectiveC
Returns a random adjective.
Inputs: options.
word-adverbC
Returns a random adverb.
Inputs: options.
word-conjunctionC
Returns a random conjunction.
Inputs: options.
word-interjectionC
Returns a random interjection.
Inputs: options.
word-nounC
Returns a random noun.
Inputs: options.
word-prepositionC
Returns a random preposition.
Inputs: options.
word-sampleB
Returns a random word, that can be an adjective, adverb, conjunction, interjection, noun, preposition, or verb.
Inputs: options.
word-verbB
Returns a random verb.
Inputs: options.
word-wordsB
Returns a random string containing some words separated by spaces.
Inputs: options.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 230 tools
The category-prefixed names make most generators distinguishable, but there is substantial overlap among granular variants: person-gender/sex/sexType, internet-userName/username, date-timeZone/location-timeZone, and many component generators (company-catchPhraseAdjective/Noun, etc.). Deprecated duplicates and near-synonyms add ambiguity, though descriptions usually clarify the intended output.
Names consistently follow a category-resource pattern such as book-title, finance-iban, and vehicle-vin, with lower-case hyphenated prefixes and camelCase entity names. Minor inconsistencies appear in duplicate casing like internet-userName vs internet-username and in nested names like airline-airport-iataCode.
230 tools is far beyond an appropriate MCP surface, even for a comprehensive Faker wrapper. Mapping nearly every Faker method to its own tool creates severe selection overhead and should instead be consolidated through category or method parameters.
Coverage spans many Faker domains including person, location, finance, internet, color, and lorem, but core generators such as random numbers, strings/UUIDs, booleans, and arrays are absent. The surface is broad but has notable gaps for common faker use cases.
Maintenance
Related MCP Connectors
Generate fictional names and sample identity profiles for prototypes, QA, demos, and creative work.
Generate synthetic random user data for testing, demos, and development without using real persona.
Generate realistic relational test data — 156 field types, 22 locales, JSON/CSV/SQL, free previews.
Access 1000+ generators for names, writing, comedy,test data,placeholder content,and lottery draws
Related MCP Servers
- AlicenseBqualityDmaintenanceGenerates realistic mock data using Faker.js for database seeding, API testing, and development environments. Supports person/company data, custom patterns, multi-locale generation, and structured datasets with referential integrity.462 npm7MIT
- AlicenseAqualityDmaintenanceGenerate realistic relational test data with 156 field types, 22 locales, and foreign key integrity. One API call seeds your entire database.51MIT
- FlicenseNot gradedqualityDmaintenanceGenerates realistic, context-aware synthetic data for AI agents to populate databases, mock APIs, and create test scenarios without exposing real PII.7 npm3-
- AlicenseNot gradedqualityDmaintenanceProvides tools for generating fake data using Faker.js, including person, lorem, internet, and more, with support for multiple locales and customizable options.MIT