{"openapi":"3.1.0","info":{"title":"Realtime Register (BYOK) API","version":"0.1.0","description":"Realtime Register (BYOK) lets an AI assistant read your own Realtime Register data through the Realtime Register API with a key you supply (Realtime Register API key). Read-only: 11 tools (list_domains, get_domain, get_credit_balance, get_pricelist, list_transactions, list_dns_zones, get_dns_zone, list_hosts, list_processes, list_notifications, get_tld_info). The BYOK key travels with each...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-realtimeregister.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-realtimeregister/docs"},"termsOfService":"https://connectorbay.com/byok-realtimeregister/terms"},"servers":[{"url":"https://byok-realtimeregister.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-realtimeregister/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_domains":{"post":{"operationId":"list_domains","summary":"List domains in your account with status, expiry, auto-renew, privacy protection and name servers. Auth codes are not re","description":"List domains in your account with status, expiry, auto-renew, privacy protection and name servers. Auth codes are not returned. Use for \"Which domains do I have at Realtime Register and when do they expire\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":250,"minimum":0,"type":"integer"},{"type":"null"}],"default":25,"description":"How many entities to return (0 to 250, 0 returns only the total).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many entities to skip from the start.","title":"Offset"},"order":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Field to sort by; prefix with '-' for descending, for example '-expiryDate'.","title":"Order"},"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over all fields.","title":"Q"}},"title":"list_domainsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_domain":{"post":{"operationId":"get_domain","summary":"Get one domain: status, registry, expiry, auto-renew, name servers, DNSSEC and zone link. The auth code is not returned.","description":"Get one domain: status, registry, expiry, auto-renew, name servers, DNSSEC and zone link. The auth code is not returned. Use for \"Is example.com auto-renewing at Realtime Register\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"domain_name":{"description":"The domain name, for example 'example.com'.","maxLength":200,"title":"Domain Name","type":"string"}},"required":["domain_name"],"title":"get_domainArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_credit_balance":{"post":{"operationId":"get_credit_balance","summary":"Show the prepaid credit per currency in cents: balance, funds reserved for running processes and locked funds. Use for \"","description":"Show the prepaid credit per currency in cents: balance, funds reserved for running processes and locked funds. Use for \"How much credit do I have left at Realtime Register\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"customer":{"description":"Your customer handle at Realtime Register (the account name used when you log in to the portal).","maxLength":200,"title":"Customer","type":"string"}},"required":["customer"],"title":"get_credit_balanceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_pricelist":{"post":{"operationId":"get_pricelist","summary":"Get your price list: price per product and action in cents, with upcoming price changes and promotions. Use for \"What do","description":"Get your price list: price per product and action in cents, with upcoming price changes and promotions. Use for \"What does registering a .com domain cost me at Realtime Register\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"customer":{"description":"Your customer handle at Realtime Register (the account name used when you log in to the portal).","maxLength":200,"title":"Customer","type":"string"},"currency":{"anyOf":[{"enum":["USD","EUR"],"type":"string"},{"type":"null"}],"default":null,"description":"Convert prices to this currency: USD or EUR.","title":"Currency"}},"required":["customer"],"title":"get_pricelistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_transactions":{"post":{"operationId":"list_transactions","summary":"List financial transactions with date, amount in cents, currency and the domain or contact the charge relates to. Use fo","description":"List financial transactions with date, amount in cents, currency and the domain or contact the charge relates to. Use for \"What charges were made on my Realtime Register account recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":250,"minimum":0,"type":"integer"},{"type":"null"}],"default":25,"description":"How many entities to return (0 to 250, 0 returns only the total).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many entities to skip from the start.","title":"Offset"},"order":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Field to sort by; prefix with '-' for descending, for example '-expiryDate'.","title":"Order"},"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over all fields.","title":"Q"}},"title":"list_transactionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_dns_zones":{"post":{"operationId":"list_dns_zones","summary":"List DNS zones hosted at Realtime Register with managed flag, service level, DNSSEC and name servers. Use for \"Which DNS","description":"List DNS zones hosted at Realtime Register with managed flag, service level, DNSSEC and name servers. Use for \"Which DNS zones do I host at Realtime Register\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":250,"minimum":0,"type":"integer"},{"type":"null"}],"default":25,"description":"How many entities to return (0 to 250, 0 returns only the total).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many entities to skip from the start.","title":"Offset"},"order":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Field to sort by; prefix with '-' for descending, for example '-expiryDate'.","title":"Order"},"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over all fields.","title":"Q"}},"title":"list_dns_zonesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_dns_zone":{"post":{"operationId":"get_dns_zone","summary":"Get one DNS zone with its records (name, type, content, TTL, priority) and DNSSEC state. Use for \"What DNS records does ","description":"Get one DNS zone with its records (name, type, content, TTL, priority) and DNSSEC state. Use for \"What DNS records does zone 77 have at Realtime Register\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone_id":{"description":"Numeric id of the DNS zone, from list_dns_zones.","title":"Zone Id","type":"integer"}},"required":["zone_id"],"title":"get_dns_zoneArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_hosts":{"post":{"operationId":"list_hosts","summary":"List name server hosts registered at the registry through your account with their IP addresses. Use for \"Which child nam","description":"List name server hosts registered at the registry through your account with their IP addresses. Use for \"Which child name server hosts do I have at Realtime Register\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":250,"minimum":0,"type":"integer"},{"type":"null"}],"default":25,"description":"How many entities to return (0 to 250, 0 returns only the total).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many entities to skip from the start.","title":"Offset"},"order":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Field to sort by; prefix with '-' for descending, for example '-expiryDate'.","title":"Order"},"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over all fields.","title":"Q"}},"title":"list_hostsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_processes":{"post":{"operationId":"list_processes","summary":"List recent processes (registrations, renewals, transfers, updates) with status, type, identifier and action. Use for \"W","description":"List recent processes (registrations, renewals, transfers, updates) with status, type, identifier and action. Use for \"Which domain actions are pending at Realtime Register\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":250,"minimum":0,"type":"integer"},{"type":"null"}],"default":25,"description":"How many entities to return (0 to 250, 0 returns only the total).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many entities to skip from the start.","title":"Offset"},"order":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Field to sort by; prefix with '-' for descending, for example '-expiryDate'.","title":"Order"},"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over all fields.","title":"Q"}},"title":"list_processesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_notifications":{"post":{"operationId":"list_notifications","summary":"List notifications (domain events, process results, warnings) with event type, subject status and message. Use for \"What","description":"List notifications (domain events, process results, warnings) with event type, subject status and message. Use for \"What notifications has Realtime Register sent for my account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"customer":{"description":"Your customer handle at Realtime Register (the account name used when you log in to the portal).","maxLength":200,"title":"Customer","type":"string"},"limit":{"anyOf":[{"maximum":250,"minimum":0,"type":"integer"},{"type":"null"}],"default":25,"description":"How many entities to return (0 to 250, 0 returns only the total).","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many entities to skip from the start.","title":"Offset"},"order":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Field to sort by; prefix with '-' for descending, for example '-expiryDate'.","title":"Order"},"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over all fields.","title":"Q"}},"required":["customer"],"title":"list_notificationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_tld_info":{"post":{"operationId":"get_tld_info","summary":"Get registration rules of a top-level domain: allowed registration and renewal periods, grace periods and transfer requi","description":"Get registration rules of a top-level domain: allowed registration and renewal periods, grace periods and transfer requirements. Use for \"How many years can I register a .nl domain for at Realtime Register\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tld":{"description":"The top-level domain without a dot, for example 'com' or 'nl'.","maxLength":200,"title":"Tld","type":"string"}},"required":["tld"],"title":"get_tld_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}