RandomUser API Connector for AI agents.
4 live capabilities
Populate your app prototypes with realistic user profiles and geographic data.
Waiting for input…
Why people use RandomUser API
RandomUser API for Realistic Mock Data Generation
This Connector lets your agent do the heavy lifting. Just tell it what you need and it pulls in realistic names, emails, and locations instantly. You get a polished, populated environment that feels real, letting you focus on building features instead of typing out dummy data.
What Vinkius changes
You get realistic, diverse data for your prototypes without doing any manual entry.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
QA stress testing
A QA engineer asks the agent to generate 500 users to see if the dashboard crashes under load or handles data overflow correctly.
- Real-world use case 02
UI mockup design
A designer asks for 10 users from different countries to see how the layout handles various name lengths and regional addresses.
- Real-world use case 03
Persona auditing
A product manager asks for a list of diverse profiles to identify if they're missing a specific demographic in their target market.
Complete set · 4capabilities
The complete RandomUser API capability set.
These are the exact actions your AI can choose when you ask it to work with RandomUser API.
01—04
4 capabilities in this set.
Part of 4 available through RandomUser API.
- 01 Capability
Check api status
Verify that the RandomUser API is currently online and responding. This keeps your automation workflows reliable.
- 02 Capability
Get random users
Generate a batch of unique user profiles with names, emails, and locations. This helps populate your database quickly.
- 03 Capability
Get seeded users
Produce the exact same set of random users by providing a specific seed string. This is perfect for consistent debugging.
- 04 Capability
List supported nationalities
See the full list of country codes supported by the RandomUser API. Use this to verify regional availability.
Set up in minutes
One URL. Then ask RandomUser API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use RandomUser API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it RandomUser API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable RandomUser API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the RandomUser API URL.
- Step 03
Save and start
Save the connection and enable RandomUser API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"randomuser-api": {
"url": "https://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using RandomUser API
Open Agent mode in chat and ask: "Using RandomUser API, help me...". 4 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"randomuser-api": {
"url": "https://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using RandomUser API
Ask Copilot: "Using RandomUser API, help me...". 4 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"randomuser-api": {
"url": "https://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using RandomUser API
Open Cascade and ask: "Using RandomUser API, help me...". 4 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"randomuser-api": {
"url": "https://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using RandomUser API
Ask Cline: "Using RandomUser API, help me...". 4 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add randomuser-api --transport http "https://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using RandomUser API
Ask Claude: "Using RandomUser API, show me...". 4 tools are ready
Where the request belongs
Work RandomUser can move forward.
This is for the developer or designer who is tired of "Lorem Ipsum" user data and wants their test environments to look like they're actually being used by real people.
QA Engineer
Populating test databases with realistic metadata to catch layout breaks or data overflow issues.
UI Designer
Filling mockups with diverse names and photos to see how text wraps and looks in different languages.
Product Manager
Auditing prototype personas to identify demographic gaps in the current product roadmap.
Data Architect
Automating the creation of large-scale dummy datasets for stress testing and scalability audits.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsRandom User Generator
Generate high-quality random user data for testing and prototyping. names, emails, and profile photos directly via AI.
Deterministic Faker Data Engine
Generate thousands of mock names, addresses, and paragraphs instantly. Perfectly deterministic, 100% local, and ready for E2E testing.
Faker Data Generator
Generate realistic fake data in seconds. names, emails, addresses, credit cards, companies, and more. 60+ locales including Brazilian Portuguese. The most complete data generator in the ecosystem, with 5M+ weekly downloads.
Faker
Generate high-quality mock data for development and testing. including addresses, persons, companies, and products in multiple locales.
DummyJSON
Access a comprehensive suite of dummy data for testing and prototyping. products, carts, and user authentication directly from your AI agent.
Mockaroo
Generate realistic dummy data. audit schemas and field types via AI.
Bring your own AI
Change the model, client or framework. Keep RandomUser connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about RandomUser.
The practical details behind the request, access and result.
How can I get realistic names for my test app using RandomUser API?
You can ask your agent to generate a batch of personas. It will pull realistic names, emails, and phone numbers from the RandomUser API to populate your test environment.
Can I get the same random users every time I run a test with RandomUser API?
Yes. By using a specific seed string, you can ensure your agent returns the exact same set of users every time you run a test cycle, which is great for debugging.
Does the RandomUser API MCP provide profile pictures?
Yes, it provides direct links to high-quality profile pictures for every user record it generates, helping your UI mockups look more finished.
What countries are supported for persona generation in RandomUser API?
The Connector supports 17 different countries including the US, UK, Canada, Brazil, and many others. You can ask your agent to generate users for any of these specific regions.
Is there a limit to how many users I can generate with RandomUser API?
You can generate thousands of user records to test your application's scalability and handle large datasets without manual effort.
How do I use RandomUser API to check demographic gaps?
You can ask your agent to generate a diverse set of profiles from various nationalities and locations to see which demographics your current product might be missing.
Is an API Key required for RandomUser API?
No. RandomUser.me is a free and open service. This server works out of the box without any static credentials required.
Can I generate users from specific countries?
Yes. Use the getRandomUsers capability and provide the nat parameter with a comma-separated list of country codes (e.g., 'US,FR').
What profile pictures are provided?
The API provides high-resolution profile picture URLs for every generated user, categorized by size (large, medium, and thumbnail).
One connection away
Give your agent a direct line to RandomUser.
Connect RandomUser once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available