namegen
Generador de nombres aleatorios típicos de cada región, pensado para agentes de IA.
Sin dependencias (Python ≥ 3.9, solo librería estándar).
Regiones: AR, BR, CN, DE, ES, FR, GB, IN, IT, JP, MX, NG, US (acepta alias como ARG, UK, USA).
Tres formas de acceso
Descubrimiento para IAs
El servidor publica todo lo que un agente necesita para encontrarlo y usarlo sin intervención humana:
/llms.txt: guía en texto plano para LLMs
/openapi.json: OpenAPI 3.1 con operationId: generate_names (tool-calling directo)
/.well-known/agent.json: ficha de capacidades, interfaces, precio y política de uso
/.well-known/ai-plugin.json: manifiesto estilo plugin (compatibilidad)
- Header
Link en cada respuesta apuntando a OpenAPI y llms.txt
- Errores JSON con
code estable (REGION_UNSUPPORTED, COUNT_OUT_OF_RANGE…) y hint de cómo corregir
API
Respeta convenciones locales: dos apellidos en MX/ES/BR, apellido primero en JP/CN.
Cobro en cripto (x402 + USDC)
Se activa definiendo la wallet que cobra:
Flujo: el agente llama → recibe 402 con qué pagar y a quién → firma el pago USDC con un cliente
x402 → reintenta con el header X-PAYMENT → el servidor verifica y liquida con el facilitator y responde 200.
Las solicitudes inválidas se rechazan con 400 antes de cobrar. /v1/regions y los archivos de
descubrimiento son gratis.
Para mainnet (base) necesitás un facilitator que opere en mainnet (por ejemplo el de Coinbase CDP)
en NAMEGEN_FACILITATOR_URL; el default x402.org/facilitator es para testnet.
Conectar al MCP
Política de uso
Los nombres son combinaciones aleatorias: no son personas ni identidades. Cada respuesta lleva
"synthetic": true. Usos previstos: ficción, juegos, placeholders, mockups y datos de prueba.
No usar para suplantar personas, crear cuentas bajo una persona inventada ni pasar verificaciones de identidad.