# namegen

> namegen is a paid MCP server for developer tools. Random region-typical personal names for test data, paid per call in USDC through x402. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, self-hosted
- **Website:** https://namegen-diegouqz.fly.dev/llms.txt
- **Repository:** https://github.com/diegouqz/namegen
- **MCP Registry name:** io.github.diegouqz/namegen
- **Categories:** developer tools, finance and payments
- **Listing updated:** 2026-11-14

## About

namegen produces synthetic personal names for fiction, placeholders and test data, not real identities. Supported regions are AR, BR, CN, DE, ES, FR, GB, IN, IT, JP, MX, NG and US, and a request can mix up to 13 of them, ask for 1 to 100 names per region, filter by gender and fix a seed for reproducible output.

It is built for agents that pay for what they use. Each region in a request costs at least 0.001 USDC on Base, settled with x402, with a first call that returns HTTP 402 and then a retry with an X-PAYMENT header. Prepaid packs from 10 queries for 0.01 USDC up to 100,000 for 100 USDC give a bearer token and remaining credits; the free endpoints include regions, packs and the OpenAPI document.

The usage policy forbids impersonation, fake persona accounts and passing identity checks. The remote MCP tools are generate_names, list_regions, buy_pack and check_credits, and a stdio Python server also exists.

## Features

- **13 regions:** Names typical of Argentina, Brazil, China, Germany and more.
- **Seeded output:** A seed makes results reproducible.
- **Pay per request:** At least 0.001 USDC per region via x402.
- **Prepaid packs:** Buy credits once and query with a bearer token.
- **HTTP API too:** Plain REST, OpenAPI and an agent card alongside MCP.
- **Usage policy:** Names are synthetic and not for impersonation.

## Good for

- Seed a test database with realistic names
- Create placeholder characters for fiction
- Generate multi-region sample users
- Let an agent buy credits for bulk runs

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http namegen https://namegen-diegouqz.fly.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://namegen-diegouqz.fly.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "namegen": {
      "url": "https://namegen-diegouqz.fly.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "namegen": {
      "type": "http",
      "url": "https://namegen-diegouqz.fly.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "namegen": {
      "serverUrl": "https://namegen-diegouqz.fly.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "namegen": {
      "type": "http",
      "url": "https://namegen-diegouqz.fly.dev/mcp"
    }
  }
}
```

## Tools

- `generate_names`: Generate random personal names typical of one or more countries (ISO 3166-1 alpha-2). Output is synthetic: for fiction, placeholders and test data. Not for impersonation or identity verification. On the paid remote server: pass a prepaid 'token' (from buy_pack) to get names directly; without a token it returns the price and the exact URL to pay via x402 (USDC). Each region requested costs 1 credit
- `list_regions`: List supported regions with locale and name order.
- `buy_pack`: Get the price and payment instructions for a prepaid pack of queries (sizes 10, 100, 1000, 10000, 100000). One x402 payment returns a token; 1 credit = 1 region in one generate_names call. This tool does not pay by itself.
- `check_credits`: Show the remaining credits of a prepaid token.

## FAQ

### How is it paid?

In USDC on Base through x402, per request or through prepaid packs.

### What is the minimum cost?

0.001 USDC per region requested.

### Are the names real people?

No, they are random combinations.

### Which regions work?

AR, BR, CN, DE, ES, FR, GB, IN, IT, JP, MX, NG and US.

### Is namegen free?

No. namegen is a paid product.

### How do I add namegen to Claude Code?

Run this command in your terminal: claude mcp add --transport http namegen https://namegen-diegouqz.fly.dev/mcp

### What are the best alternatives to namegen?

The closest alternatives to namegen are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/namegen
