• DATA
  • LIST
  • HUMAN
  • LOGS

How to filter users by nationality with your AI

Connect the RandomUser API to your AI client to pull specific demographic data. Once connected, you can request user profiles based on exact country requirements.

Ask AI about this page

Short answer

How can I get random users from a specific country?

Your AI first checks which countries are available through the connector, then requests a specific number of profiles for that nationality. You'll get a set of randomized user data tailored to your target demographic.

Where every request lands.

The outcomes of your request.

Depending on what you ask, your AI delivers specific data sets or lists of available regions.

DATA

Targeted user profiles

The AI pulls randomized identities, emails, and locations that match your requested nationality. You get raw data ready for your testing scripts.

LIST

Supported country codes

The AI provides a list of all valid nationality identifiers. Use this to ensure your prompts use codes the API actually recognizes.

HUMAN

Manual data review

You decide if the generated personas are realistic enough for your specific use case. The AI provides the data, but you validate the quality.

LOGS

Request history

Your AI keeps track of the specific parameters used for each pull. This helps you replicate exact demographic sets later.

The workflow

What your AI does when you ask for specific users.

The AI handles the API calls and data parsing so you can focus on the testing logic.

  1. Identify valid regions

    The AI checks the API to see which countries are currently supported for data retrieval.

    list_supported_nationalities

  2. Filter by nationality

    Once it knows the valid codes, the AI applies your requested country filter to the search.

    get_random_users

  3. Format the results

    The AI takes the raw JSON response and turns it into a readable list or a structured table.

    get_random_users

  4. Verify the data

    The AI compares the returned profiles against your original nationality constraints to ensure accuracy.

    get_random_users

Try it

Copy these to start.

Use these prompts to trigger the first few requests.

Starting points

Swap out the bracketed text for the specific country or number of users you need.

RandomUser Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — RandomUser capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "randomuser-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_H6ohK8YWIfeCXkGsacCWGP3f2AXV8nnP9wOVrWzI/mcp"
    }
  }
}
Copy into chat04

  • List all the supported nationalities available in the RandomUser API.

  • Get 5 random users from the US.

  • Find 10 users from the GB nationality and show me their email addresses.

  • Check which country codes are available, then give me 3 users from a country in Europe.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect RandomUser API once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted and the setup is handled on our end.

Connect RandomUser API to your AI

FAQ

How this task behaves.

  • 01

    Can the AI create real user accounts?

    No. The AI only retrieves randomized, fake user data for testing purposes.

  • 02

    Can I request users from a country that isn't supported?

    No. If a country code isn't in the supported list, the API cannot return users for it.

  • 03

    Does the AI save the user data to a database?

    No. The AI only retrieves the data and presents it to you in your chat interface.

  • 04

    Can the AI change the user's nationality after they are generated?

    No. The nationality is a fixed attribute of the randomized profile returned by the API.

  • 05

    How many users can I request at once?

    The number of users is limited by the specific tool's capacity to return a single batch.

  • More questions about RandomUser API? The Connector page answers them. See everything the RandomUser API Connector can do

Connect RandomUser to Claude, Cursor, ChatGPT & more