llms.txt
+25 −10
https://namegen-diegouqz.fly.dev/llms.txt
− - region (required): ISO 3166-1 alpha-2. Supported: AR, BR, CN, DE, ES, FR, GB, IN, IT, JP, MX, NG, US− - count: 1-100 (default 1)− {"schema":"namegen.v1","region":"AR","count":1,"synthetic":true,− "results":[{"full_name":"...","given_name":"...","family_names":["..."],"gender":"...","locale":"es-AR"}]}− Codes: REGION_REQUIRED, REGION_UNSUPPORTED, COUNT_INVALID, COUNT_OUT_OF_RANGE, GENDER_INVALID− - MCP (remote, streamable HTTP): https://namegen-diegouqz.fly.dev/mcp (tools: generate_names, list_regions)− ## Payment (x402, pay-what-you-want)− - /v1/names costs at least 0.10 USDC per request, paid in USDC on base.− - To pay more, add `pay=<amount>` (e.g. `&pay=0.25`). Omit it to pay the minimum.− - Free: /v1/regions, /openapi.json, /llms.txt, /.well-known/agent.json+ GET https://namegen-diegouqz.fly.dev/v1/names?region=AR,MX,BR&count=5 (several regions in one request)+ - region (required): ISO 3166-1 alpha-2, or up to 13 comma-separated. Supported: AR, BR, CN, DE, ES, FR, GB, IN, IT, JP, MX, NG, US+ - count: 1-100 names per region (default 1)+ {"schema":"namegen.v1","region":"AR","regions":["AR"],"count":1,"synthetic":true,+ "results":[{"full_name":"...","given_name":"...","family_names":["..."],"gender":"...","region":"AR","locale":"es-AR"}]}+ Codes: REGION_REQUIRED, REGION_UNSUPPORTED, TOO_MANY_REGIONS, COUNT_INVALID, COUNT_OUT_OF_RANGE, GENDER_INVALID+ - MCP (remote, streamable HTTP): https://namegen-diegouqz.fly.dev/mcp (tools: generate_names, list_regions, buy_pack, check_credits)+ ## Payment option 1: per request (x402, pay-what-you-want)+ - /v1/names costs at least 0.001 USDC per region requested, paid in USDC on base.+ Example: region=AR,MX,BR costs at least 0.003 USDC.+ - To pay more, add `pay=<amount>`. Omit it to pay the minimum.+ ## Payment option 2: prepaid packs (one payment, many queries)+ - 1 credit = 1 region in one /v1/names request (up to 100 names).+ - 10 queries: 0.01 USDC -> https://namegen-diegouqz.fly.dev/v1/packs/buy?size=10+ - 100 queries: 0.10 USDC -> https://namegen-diegouqz.fly.dev/v1/packs/buy?size=100+ - 1000 queries: 1.00 USDC -> https://namegen-diegouqz.fly.dev/v1/packs/buy?size=1000+ - 10000 queries: 10.00 USDC -> https://namegen-diegouqz.fly.dev/v1/packs/buy?size=10000+ - 100000 queries: 100.00 USDC -> https://namegen-diegouqz.fly.dev/v1/packs/buy?size=100000+ - Buy: GET the buy URL -> HTTP 402 -> pay with x402 -> retry with X-PAYMENT -> JSON {token, credits}.+ - Use: GET /v1/names?region=AR&count=100 with header `Authorization: Bearer <token>` (no payment).+ The response includes `credits_remaining`.+ - Balance: GET /v1/credits with the same header.+ - Errors: TOKEN_INVALID (401), CREDITS_EXHAUSTED (402: buy another pack).+ - Keep the token secret: anyone with it can spend its credits.+ - Free: /v1/regions, /v1/packs, /openapi.json, /llms.txt, /.well-known/agent.json