# Faker MCP MCP

> Faker generates realistic placeholder data for development and testing. It instantly populates databases, mocks APIs, and builds UI prototypes using fake addresses, names, company profiles, credit card numbers, and much more. With support for over 70 locales, your test data looks authentic anywhere in the world.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** mock-data, faker, testing, api-development, dummy-data

## Description

Writing code or building a prototype often means dealing with placeholder content—the kind of generic dummy data that breaks immersion. This MCP eliminates that problem. It gives you structured, realistic information on demand, whether you need to populate a database, simulate an API call, or just fill out a wireframe for design review. You can generate mock people and accounts, create detailed company records with VAT numbers, or fetch random images and text blocks without leaving your AI client. Because this service is hosted in the Vinkius catalog, connecting it to your agent is straightforward; you get instant access to structured data from any MCP-compatible client.

## Tools

### get_addresses
Generates realistic, formatted mock street and mailing addresses that can be filtered by country code.

### get_books
Outputs structured data simulating details for various books, including titles and authors.

### get_companies
Creates detailed profiles for fake businesses, complete with necessary identification numbers like VAT codes.

### get_credit_cards
Generates mock credit card information that safely simulates a successful payment attempt.

### get_custom
Builds custom data structures by mapping specific field names to desired Faker types, giving you precise control over the output schema.

### get_images
Fetches URLs for placeholder images from various sources, supporting types like 'any' or 'pokemon'.

### get_persons
Generates detailed personal information and mock profiles, allowing you to specify male, female, or other genders.

### get_places
Produces general mock data points describing various geographical locations or settings.

### get_products
Creates structured listings for fake items, useful for populating e-commerce catalogs.

### get_texts
Outputs randomized text content blocks suitable for filling body copy or descriptive fields in UIs.

### get_users
Generates mock data simulating full user account credentials, often including unique identifiers and names.

## Prompt Examples

**Prompt:** 
```
Generate 5 fake company profiles with websites and VAT numbers.
```

**Response:** 
```
I've generated 5 mock companies for you, including 'TechFlow Solutions' and 'Global Logistics Inc.', complete with their registered VAT numbers and official websites.
```

**Prompt:** 
```
I need 10 random addresses in Germany using the de_DE locale.
```

**Response:** 
```
Here are 10 German addresses. They include street names like 'Hauptstraße' and 'Goethestraße' with valid postal codes and city names formatted for the de_DE region.
```

**Prompt:** 
```
Give me 3 mock books with titles and authors.
```

**Response:** 
```
I've retrieved 3 mock books: 'The Silent Echo' by Jane Doe, 'Digital Horizons' by John Smith, and 'Beyond the Veil' by Alice Johnson.
```

## Capabilities

### Generate complete user profiles
Creates mock personal records, including names and demographic details, for testing different user flows.

### Mock business entities
Builds realistic company data sets with official-looking identifiers like VAT numbers.

### Generate localized addresses
Produces full, formatted mailing addresses that match specific countries and regional standards.

### Create financial test credentials
Outputs safe, random credit card numbers suitable for testing e-commerce checkout flows.

### Populate UI with varied media
Retrieves placeholder image URLs and randomized text blocks to fill out prototypes instead of using generic filler.

## Use Cases

### Testing a new signup form
A QA engineer needs to test user input fields for 10 different regions. They ask their agent to use `get_users` and then specify the locale, immediately receiving valid mock data for names, emails, and credentials that mimic real users from that country.

### Mocking an e-commerce catalog
A backend developer needs 50 products for a staging environment. They use `get_products` to get the SKUs, then call `get_companies` to link them to mock vendors, finally using `get_addresses` to assign a fake fulfillment center location.

### Designing a dashboard layout
A product designer is building a prototype and needs content. Instead of pasting generic filler, they prompt the agent to fetch random headlines via `get_texts`, alongside relevant mock images using `get_images` for immediate visual fidelity.

### Simulating payment failure
A developer is building a checkout service and needs to test error handling. They use the agent to call `get_credit_cards`, ensuring they get valid-looking mock numbers that allow them to simulate both success and specific failures.

## Benefits

- Builds highly realistic test environments. Instead of generic placeholders, you can use `get_persons` and `get_users` to generate complete profiles that feel real enough to catch integration bugs.
- Handles international complexity. By using the locale parameter (supported by many tools), Faker ensures your addresses or names look correct for any region in the world, from Germany to Japan.
- Supports complex financial testing. If you're building a checkout flow, `get_credit_cards` provides safe mock data so you can test payment logic without using real numbers.
- Provides structural flexibility. The `get_custom` tool lets you define exactly what fields your generated data needs—say, combining a product name with a specific user ID into one output.
- Cuts through content blocks. For designers, needing filler text is solved by `get_texts`, while visual assets are handled instantly via `get_images`, saving hours of manual asset hunting.

## How It Works

The bottom line is, you tell the system what kind of fake data you need, and it delivers a ready-to-use JSON object.

1. Subscribe to the Faker MCP in Vinkius.
2. Input your required API credentials into your AI client's configuration.
3. Ask your agent to generate specific structured data, like 'Give me 5 German company profiles with their addresses.'

## Frequently Asked Questions

**How do I generate addresses using get_addresses?**
You call `get_addresses` and pass a country code to filter the output. For example, passing 'de' will return German-formatted street names and postal codes.

**Can I mock credit cards using get_credit_cards?**
Yes. `get_credit_cards` generates safe, structured data that simulates payment credentials for testing your checkout logic without exposing real numbers.

**What is the best way to generate multiple types of mock data? (Using get_custom)**
If you need a specific mix of fields—say, a product name and an associated company VAT number—use `get_custom`. It lets you map these diverse pieces into one unified output structure.

**Do I need to worry about different languages when generating people? (Using get_persons)**
No. The `get_persons` tool supports specifying genders and, combined with other tools, helps ensure the mock profiles feel authentic across various locales.

**How do I simulate a full user account structure? (Using get_users)**
Call `get_users`. It delivers comprehensive data that represents an active account, including not just names but often unique IDs and credentials ready for system testing.

**How can I optimize performance when using get_products for large data sets?**
The tool manages bulk requests efficiently. You don't have to make many small calls; you can request hundreds of product records in single prompts, which speeds up database seeding dramatically.

**Does the get_images tool allow me to specify image sources or types?**
Yes, you control the source. You can select specific providers like Picsum or define content types such as "pokemon." This gives your mock data granular control over whether it uses random URLs or themed assets.

**What kind of detailed metadata does get_books generate?**
It generates comprehensive mock book information. You'll receive details including titles, authors, and necessary publication metadata, making it ideal for testing library or e-commerce systems.