Resumen
Register.gy es un registrador acreditado de dominios .gy. La plataforma para desarrolladores ofrece las mismas herramientas que los clientes usan en el Área de clientes, así que un asistente o una aplicación puede:
- Consultar la disponibilidad de nombres .gy, .com.gy, .co.gy, .net.gy y .org.gy, con el precio y un enlace de registro. No requiere iniciar sesión.
- Listar los dominios de un cliente y leer sus registros DNS.
- Conectar un sitio web: envía los registros que muestra un creador de sitios web (Lovable, Bolt, Replit, v0, Netlify, Shopify…), obtén una vista previa y luego aplícalos. Cada cambio se puede deshacer durante 7 días.
- Comprobar que un sitio está en línea: visibilidad DNS y https.
Por diseño, la plataforma nunca cambia los registros de correo (MX) ni los servidores de nombres, no transfiere dominios ni toca los pagos. Los cambios a nivel del registro los aplica el equipo de Register.gy.
| URL base de REST | https://register.gy/wp-json/rgy/v1 |
|---|---|
| Servidor MCP | https://register.gy/wp-json/rgy/v1/mcp |
| OpenAPI | https://register.gy/wp-json/rgy/v1/openapi.json |
| Metadatos de OAuth | https://register.gy/.well-known/oauth-authorization-server |
| Resumen para herramientas de IA | https://register.gy/llms.txt |
Inicio rápido
1. Consulta un nombre (sin clave)
curl "https://register.gy/wp-json/rgy/v1/availability?domain=mybakery.gy" 2. Crea una clave de API
Inicia sesión en el Área de clientes, abre API y asistentes de IA y haz clic en Crear clave de API. Se muestra una sola vez.
3. Lista tus dominios
curl -H "Authorization: Bearer rgy_live_YOUR_KEY" https://register.gy/wp-json/rgy/v1/domains 4. Obtén la vista previa y luego conecta un sitio web
curl -X POST https://register.gy/wp-json/rgy/v1/domains/mybakery.gy/connect/preview \
-H "Authorization: Bearer rgy_live_YOUR_KEY" -H "Content-Type: application/json" \
-d '{"records":[{"type":"A","name":"@","value":"185.158.133.1"},{"type":"TXT","name":"_lovable","value":"lovable_verify=…"}]}' Si la vista previa se ve bien, envía el mismo cuerpo a /connect/apply. Deshaz con /connect/undo en un plazo de 7 días.
Conectar un asistente de IA
Register.gy ofrece un servidor MCP remoto (la forma estándar en que los asistentes usan herramientas externas). Los asistentes que admiten inicio de sesión abrirán una ventana de Register.gy: el cliente ingresa su correo, escribe el código de 6 dígitos que le enviamos y aprueba lo que el asistente puede hacer.
Claude
Agrega un conector personalizado con esta dirección y luego inicia sesión:
https://register.gy/wp-json/rgy/v1/mcpChatGPT
Donde ChatGPT te permita agregar un conector o una aplicación personalizada (modo desarrollador), usa la misma dirección y elige el inicio de sesión con OAuth:
https://register.gy/wp-json/rgy/v1/mcpClaude Code
claude mcp add --transport http register-gy https://register.gy/wp-json/rgy/v1/mcpLuego ejecuta /mcp en Claude Code para iniciar sesión. O evita el inicio de sesión con una clave: agrega --header "Authorization: Bearer rgy_live_YOUR_KEY".
Cursor y otros clientes MCP
{
"mcpServers": {
"register-gy": {
"url": "https://register.gy/wp-json/rgy/v1/mcp",
"headers": { "Authorization": "Bearer rgy_live_YOUR_KEY" }
}
}
}Los clientes que admiten OAuth pueden omitir headers e iniciar sesión en su lugar.
Luego pregunta, por ejemplo: "¿Está disponible mybakery.gy?" o "Conecta mi sitio de Lovable a mybakery.gy." El asistente muestra los cambios previstos y pregunta antes de aplicarlos.
Endpoint público, solo de búsqueda (sin iniciar sesión): https://register.gy/wp-json/rgy/v1/mcp/public
Autenticación
OAuth 2.1 (recomendado para asistentes y aplicaciones que usan otras personas)
- Flujo de código de autorización con PKCE (solo S256). Clientes públicos y confidenciales.
- Registro dinámico de clientes (RFC 7591) en
https://register.gy/oauth/register. Las URI de redirección deben ser https, o http en localhost. - Descubrimiento:
/.well-known/oauth-authorization-server(RFC 8414) y/.well-known/oauth-protected-resource(RFC 9728). El endpoint MCP responde a las solicitudes no autenticadas con401y un encabezadoWWW-Authenticateque apunta a los metadatos del recurso. - Los tokens de acceso duran 1 hora; los tokens de actualización, 30 días, y rotan en cada uso. Reutilizar un token de actualización antiguo termina toda la conexión.
- Revocación:
https://register.gy/oauth/revoke(RFC 7009). Los clientes también pueden desconectar aplicaciones en el Área de clientes.
| Alcance | Permite |
|---|---|
domains:read | See your .gy domains and their DNS records |
websites:write | Connect your websites (change website records only, with 7-day undo) |
Claves de API (tus propios scripts y herramientas)
Crea hasta 5 claves en el Área de clientes. Envíalas como Authorization: Bearer rgy_live_… o X-API-Key: rgy_live_…. Las claves tienen ambos alcances. Se guardan con hash y el titular recibe un correo cuando se crea una.
Servidor MCP
Transporte HTTP transmitible (Streamable HTTP), respuestas JSON (sin flujo de eventos), versiones del protocolo 2025-06-18, 2025-03-26, 2024-11-05.
| Herramienta | Qué hace | ¿Modifica datos? |
|---|---|---|
search_domain | Check whether a .gy domain (.gy, .com.gy, .co.gy, .net.gy or .org.gy) is available at Register.gy, with the yearly price and a link to register it. | No |
notify_when_registration_reopens | Use only when search_domain says new .gy registrations are paused. Adds the user to Register.gy's notify list: Register.gy checks the domain again and emails them a link to register it as soon as registration reopens (usually within about an hour). Only call with the user's permission and their own email address. | Sí, después de confirmar |
list_my_domains | List the user's .gy domains at Register.gy, with expiry date and whether each can be connected to a website now. | No |
get_dns_records | Show the current DNS records of one of the user's .gy domains. | No |
connect_website | Point one of the user's .gy domains at their website by setting the DNS records their website builder (Lovable, Bolt, Replit, v0/Vercel, Netlify, Webflow, Shopify…) shows on its custom-domain screen. Use the builder's real values, never guesses. ALWAYS call with apply=false first and show the user the preview; call again with apply=true only after the user clearly confirms. Email (MX) and nameserver records are never changed. The change can be undone for 7 days. | Sí, después de confirmar |
check_live | Check whether the website records of a .gy domain are visible on the internet and whether https works yet. | No |
undo_last_change | Put back the website records that were in place before the last connect_website change on this domain (available for 7 days). Ask the user first. | Sí, después de confirmar |
REST API
URL base https://register.gy/wp-json/rgy/v1. Entrada JSON, salida JSON. Los errores se ven así: {"error":{"code":"not_found","message":"…"}}.
| Método | Ruta | Descripción | Autenticación |
|---|---|---|---|
| GET | /availability | Is a .gy domain available? | Ninguna |
| GET | /status | Are .gy registrations open or paused right now? | Ninguna |
| POST | /notify | While registrations are paused: email me when they reopen | Ninguna |
| GET | /health | Service status for uptime monitors | Ninguna |
| GET | /me | Who this key belongs to | Clave o token |
| GET | /domains | Your .gy domains | Clave o token |
| GET | /domains/{domain} | One domain | Clave o token |
| GET | /domains/{domain}/records | Current DNS records | Clave o token |
| POST | /domains/{domain}/connect/preview | Preview connecting a website (changes nothing) | Clave o token |
| POST | /domains/{domain}/connect/apply | Connect a website (after the user confirms the preview) | Clave o token |
| POST | /domains/{domain}/connect/undo | Undo the last connect | Clave o token |
| GET | /domains/{domain}/live | Is the site live (DNS + https)? | Clave o token |
| POST | /mcp | MCP endpoint for AI assistants (JSON-RPC 2.0, Streamable HTTP) | Clave o token |
Cuerpo de la solicitud de conexión
Una lista de registros, o el texto tal cual que muestra tu creador (una tabla o lista). Solo se configuran A, AAAA, CNAME (ALIAS) y TXT; todo lo demás aparece en skipped con el motivo.
{
"records": [
{ "type": "A", "name": "@", "value": "185.158.133.1" },
{ "type": "CNAME", "name": "www", "value": "mysite.netlify.app" }
]
} Límites y errores
| Solicitudes | 300 por clave o conexión cada 10 minutos |
|---|---|
| Cambios | 60 cada 10 minutos por cliente (compartido con el Área de clientes) |
| Disponibilidad | 30 consultas por minuto por dirección IP |
| Registros por conexión | 15 |
| Estado | Significado |
|---|---|
| 400 | Solicitud incorrecta (el mensaje indica qué corregir) |
| 401 | Clave o token ausente, no válido o vencido |
| 403 | No permitido (por ejemplo, una conexión de solo lectura que intenta cambiar registros, o un dominio gestionado por nuestro equipo) |
| 404 | No pertenece a esta cuenta, o endpoint desconocido |
| 429 | Demasiadas solicitudes; espera y vuelve a intentarlo |
| 503 | Un servicio del que dependemos (DNS o la consulta de disponibilidad) no responde; vuelve a intentarlo más tarde |
Seguridad
- Las claves y los tokens solo se guardan como hashes SHA-256. Los códigos de inicio de sesión son de un solo uso, vencen en 10 minutos y tienen límite de frecuencia.
- Cada clave o conexión solo ve los dominios del cliente que la creó.
- Cada cambio hecho mediante la API queda registrado y se puede deshacer durante 7 días. Los registros del sitio web se configuran como solo DNS para que los creadores puedan emitir sus certificados https.
- ¿Encontraste un problema de seguridad? Escribe a [email protected] con "Security" en el asunto. Danos la oportunidad de corregirlo antes de contárselo a otros.
Registro de cambios
- 8 de octubre de 2026 Inicio de sesión con OAuth 2.1 (PKCE, registro dinámico de clientes, rotación de tokens de actualización), aplicaciones conectadas en el Área de clientes, endpoint MCP público solo de búsqueda.
- 8 de octubre de 2026 Lanzamiento de la API REST y del servidor MCP: disponibilidad, dominios, registros, vista previa/aplicar/deshacer de conexiones, comprobación de sitio en línea. Claves de API en el Área de clientes.
Soporte y términos
Preguntas, ideas o propuestas de colaboración: [email protected] o +592-623-1721.
El uso de la API se rige por nuestra política de privacidad. Estamos terminando los términos específicos de la API.