Random Profiles MCP Server
by gusdeboercom.random-profiles/mcpv1.4.4
Generate fake user profiles and companies for tests, seed data, and AI agent demos.
context tax
queued
security
queued
cold start
queued
freshness
Active11d ago
Install Random Profiles MCP server
Install in Claude Code
claude mcp add random-profiles -e RANDOM_PROFILES_API_KEY='<random-profiles-api-key>' -- npx -y random-profiles-mcpInstall in Cursor
{
"mcpServers": {
"random-profiles": {
"command": "npx",
"args": [
"-y",
"random-profiles-mcp"
],
"env": {
"RANDOM_PROFILES_API_KEY": "<random-profiles-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"random-profiles": {
"command": "npx",
"args": [
"-y",
"random-profiles-mcp"
],
"env": {
"RANDOM_PROFILES_API_KEY": "<random-profiles-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"random-profiles": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"random-profiles-mcp"
],
"env": {
"RANDOM_PROFILES_API_KEY": "<random-profiles-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"random-profiles": {
"command": "npx",
"args": [
"-y",
"random-profiles-mcp"
],
"env": {
"RANDOM_PROFILES_API_KEY": "<random-profiles-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| RANDOM_PROFILES_API_KEY | — | yes | API key from https://random-profiles.com. If omitted, the agent uses the claim_api_key tool to claim a free key interactively and caches it to ~/.random-profiles/config.json. |
Freshness
Active — last maintenance signal 11d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-28 · 11d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-28 · 11d ago · official registry · v1.4.4
FAQ
›How do I install the Random Profiles MCP server in Claude Code?
Run: claude mcp add random-profiles -e RANDOM_PROFILES_API_KEY='<random-profiles-api-key>' -- npx -y random-profiles-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Random Profiles require an API key?
Yes. It expects RANDOM_PROFILES_API_KEY, of which 1 is a secret.
›Can I use Random Profiles as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Random Profiles in the official MCP registry?
Yes, as com.random-profiles/mcp.