{
  "markdown": "# random-profiles-mcp\n\nMCP server for the [Random Profiles API](https://random-profiles.com) — generate fake user profiles and companies directly from AI agents like Claude.\n\n## Setup — zero config\n\nJust install the MCP server and talk to it. The first time you ask for\nprofiles, the agent will prompt you for an email once, claim a free key on\nyour behalf, cache it locally, and use it for every future request. The key\nis also emailed to you as a receipt.\n\nAdd to your Claude Code MCP config (`.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"random-profiles\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"random-profiles-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Code and ask _\"give me 5 random user profiles\"_ — the agent\nwill handle the key handshake automatically. No browser, no copy-paste.\n\nThe key is cached at `~/.random-profiles/config.json` (mode `0600`) so you\nonly do this once per machine.\n\n### Prefer to bring your own key?\n\nIf you already have an API key (or want to use a specific one for billing),\nset it via env var and skip the claim flow entirely:\n\n```json\n{\n  \"mcpServers\": {\n    \"random-profiles\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"random-profiles-mcp\"],\n      \"env\": {\n        \"RANDOM_PROFILES_API_KEY\": \"rp_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nThe env var takes precedence over the cached key.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `claim_api_key` | Claim a free API key using an email address (response returns the key; the agent also emails a copy as a receipt). Only used on first run when no key is configured — cached afterward. |\n| `get_profiles` | Get random user profiles with filters (count, gender, country, age range, fields) |\n| `get_profile` | Get a single profile by UUID |\n| `get_companies` | Get random fake companies with filters (count, industry, country, size, fields) |\n| `get_company` | Get a single company by UUID |\n| `get_random_image` | Get a random profile photo (JPEG, optional size) |\n| `get_image` | Get a specific profile photo by UUID (JPEG, optional size) |\n| `get_usage` | Check your API key usage, tier, and daily limits |\n\n## Field Groups\n\n**Profiles**: name, email, phone, identity, bio, social, physical, job, address, financial, network, documents, vehicle, contact, digital, interests, education, photo, relationships, meta\n\n**Companies**: name, industry, size, location, contact, social, financial, tech, leadership, legal, operations, product, relationships, meta\n\nThe `relationships` group returns cross-resource UUIDs: profiles have `company_uuid` + `colleague_uuids`, companies have `employee_uuids`. Chain tools together to hydrate the graph (e.g. \"give me 5 companies, then their employees\").\n\n## Image formats\n\nBoth `get_profiles` and `get_companies` accept an optional `photo_format` / `logo_format` argument (`jpg` or `webp`). WebP is ~30% smaller than JPG with equivalent perceived quality and is supported by 96%+ of browsers. Default stays `jpg` for maximum compatibility.\n\n## Examples\n\n**Profiles**\n\n> \"Give me 5 random US profiles\"\n\n> \"Generate 10 female profiles between ages 25-35 from Germany\"\n\n> \"Get me profiles with only name and email fields\"\n\n> \"Show me a random profile photo\"\n\n**Companies**\n\n> \"Give me 5 fake Technology companies from the US\"\n\n> \"Generate 10 Healthcare companies with 51-200 employees\"\n\n> \"Get 20 companies with only name, industry, and leadership fields\"\n\n> \"Give me 3 Finance companies from the UK with a fixed seed of 42\"\n\n> \"Give me 10 companies with 128px logos (for an icon grid)\"\n\nThe `logo_size` argument on `get_companies`/`get_company` picks the size variant in `meta.logo_url` — same pattern as `photo_size` on profiles. Valid values: `64`, `128`, `256`, `512`, `1024` (default).\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `RANDOM_PROFILES_API_KEY` | Yes | Your API key (get one at random-profiles.com) |\n\n## See also\n\n- [`random-profiles-types`](https://www.npmjs.com/package/random-profiles-types) — TypeScript types for the API response shapes, if you're calling the API directly from TypeScript.\n- [`random-profiles`](https://www.npmjs.com/package/random-profiles) — CLI for the same API.\n\n## License\n\nMIT\n",
  "bytes": 4272,
  "sha": "6df724043c583736a2c268b1cf6bc276b397199c57771ec9ed8328627f00edba",
  "repo_slug": "gusdeboer/random-profiles-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_random_profiles_mcp_5659c285/readme"
}